Yang, Tong 3f5759eed2 MRS comp-lts 2.0.38.SP20 version
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-authored-by: Yang, Tong <yangtong2@huawei.com>
Co-committed-by: Yang, Tong <yangtong2@huawei.com>
2023-01-19 17:08:45 +00:00

304 lines
39 KiB
HTML

<a name="mrs_01_24146"></a><a name="mrs_01_24146"></a>
<h1 class="topictitle1">Configuring a ClickHouse Data Source</h1>
<div id="body32001227"><div class="section" id="mrs_01_24146__en-us_topic_0000001219350589_section1923312273330"><h4 class="sectiontitle">Scenarios</h4><ul id="mrs_01_24146__en-us_topic_0000001219350589_ul158045163320"><li id="mrs_01_24146__en-us_topic_0000001219350589_li488114232614">Currently, <span id="mrs_01_24146__en-us_topic_0000001219350589_text28494919714">HetuEngine</span> supports the interconnection with the ClickHouse data source in the cluster of MRS 3.1.1 or later.</li><li id="mrs_01_24146__en-us_topic_0000001219350589_li168065112336">The <span id="mrs_01_24146__en-us_topic_0000001219350589_text142619017349">HetuEngine</span> cluster in security mode supports the interconnection with the ClickHouse data source in the cluster of MRS 3.1.1 or later in security mode.</li><li id="mrs_01_24146__en-us_topic_0000001219350589_li1680185116334">The <span id="mrs_01_24146__en-us_topic_0000001219350589_text179171448205013">HetuEngine</span> cluster in normal mode supports the interconnection with the ClickHouse data source in the cluster of MRS 3.1.1 or later in normal mode.</li><li id="mrs_01_24146__en-us_topic_0000001219350589_li392513695815">In the ClickHouse data source, tables with the same name but in different cases, for example, <strong id="mrs_01_24146__en-us_topic_0000001219350589_b768111359521">cktable</strong> (lowercase), <strong id="mrs_01_24146__en-us_topic_0000001219350589_b16901203711526">CKTABLE</strong> (uppercase), and <strong id="mrs_01_24146__en-us_topic_0000001219350589_b181941340165213">CKtable</strong> (uppercase and lowercase), cannot co-exist in the same schema or database. Otherwise, tables in the schema or database cannot be used by <span id="mrs_01_24146__en-us_topic_0000001219350589_text199911979012">HetuEngine</span>.</li></ul>
</div>
<div class="section" id="mrs_01_24146__en-us_topic_0000001219350589_section1711355431016"><h4 class="sectiontitle">Prerequisites</h4><p id="mrs_01_24146__en-us_topic_0000001219350589_p12434558171011">You have created a <span id="mrs_01_24146__en-us_topic_0000001219350589_text413615015912">HetuEngine</span> administrator by referring to <a href="mrs_01_1714.html">Creating a HetuEngine User</a>.</p>
</div>
<div class="section" id="mrs_01_24146__en-us_topic_0000001219350589_section14311102713349"><h4 class="sectiontitle">Procedure</h4><ol id="mrs_01_24146__en-us_topic_0000001219350589_ol1682917373342"><li id="mrs_01_24146__en-us_topic_0000001219350589_li186031531103012"><span>Log in to FusionInsight Manager as a <span id="mrs_01_24146__en-us_topic_0000001219350589_text16312536123712">HetuEngine</span> administrator and choose <strong id="mrs_01_24146__en-us_topic_0000001219350589_b1488324105103434">Cluster</strong> &gt; <strong id="mrs_01_24146__en-us_topic_0000001219350589_b116268471103434">Services</strong> &gt; <strong id="mrs_01_24146__en-us_topic_0000001219350589_b17051386103434"><span id="mrs_01_24146__en-us_topic_0000001219350589_text17567137175">HetuEngine</span></strong>. The <strong id="mrs_01_24146__en-us_topic_0000001219350589_b1261319768103434"><span id="mrs_01_24146__en-us_topic_0000001219350589_text9562173810710">HetuEngine</span></strong> service page is displayed.</span></li><li id="mrs_01_24146__en-us_topic_0000001219350589_li56031317301"><span>In the <strong id="mrs_01_24146__en-us_topic_0000001219350589_b555941772103434">Basic Information</strong> area on the <strong id="mrs_01_24146__en-us_topic_0000001219350589_b1684648193103434">Dashboard</strong> tab page, click the link next to <strong id="mrs_01_24146__en-us_topic_0000001219350589_b1851527480103434">HSConsole WebUI</strong>. The HSConsole page is displayed.</span></li><li id="mrs_01_24146__en-us_topic_0000001219350589_li19603163153010"><span>Choose <strong id="mrs_01_24146__en-us_topic_0000001219350589_b4465414133720">Data Source</strong>.</span></li><li id="mrs_01_24146__en-us_topic_0000001219350589_li1760343103019"><span>Click <strong id="mrs_01_24146__en-us_topic_0000001219350589_b1638310303506">Add Data Source</strong>. On the <strong id="mrs_01_24146__en-us_topic_0000001219350589_b1140112518519">Add Data Source</strong> page that is displayed, configure parameters.</span><p><ol type="a" id="mrs_01_24146__en-us_topic_0000001219350589_ol1319425925116"><li id="mrs_01_24146__en-us_topic_0000001219350589_li20192125919513">Configure parameters in the <strong id="mrs_01_24146__en-us_topic_0000001219350589_b1852918350103434">Basic Configuration</strong> area. For details about the parameters, see <a href="#mrs_01_24146__en-us_topic_0000001219350589_table1019212591518">Table 1</a>.
<div class="tablenoborder"><a name="mrs_01_24146__en-us_topic_0000001219350589_table1019212591518"></a><a name="en-us_topic_0000001219350589_table1019212591518"></a><table cellpadding="4" cellspacing="0" summary="" id="mrs_01_24146__en-us_topic_0000001219350589_table1019212591518" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Basic Information</caption><thead align="left"><tr id="mrs_01_24146__en-us_topic_0000001219350589_row12191459125114"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.2.4.2.1.1.3.2.4.1.1"><p id="mrs_01_24146__en-us_topic_0000001219350589_p1191259195111">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.2.4.2.1.1.3.2.4.1.2"><p id="mrs_01_24146__en-us_topic_0000001219350589_p1719125916516">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.2.4.2.1.1.3.2.4.1.3"><p id="mrs_01_24146__en-us_topic_0000001219350589_p161911259195115">Example Value</p>
</th>
</tr>
</thead>
<tbody><tr id="mrs_01_24146__en-us_topic_0000001219350589_row719135925110"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.1.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p419175913513">Name</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.1.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p8191859165111">Name of the data source to be connected.</p>
<p id="mrs_01_24146__en-us_topic_0000001219350589_p1819145965118">The value can contain only letters, digits, and underscores (_) and must start with a letter.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.1.3.2.4.1.3 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p10191125920516">clickhouse_1</p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row15191105910511"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.1.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p11912596512">Data Source Type</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.1.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p61911759125115">Type of the data source to be connected. Choose <strong id="mrs_01_24146__en-us_topic_0000001219350589_b115651221104011">JDBC</strong> &gt; <strong id="mrs_01_24146__en-us_topic_0000001219350589_b106445220409">ClickHouse</strong>.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.1.3.2.4.1.3 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p15191115912513">ClickHouse</p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row15192185917512"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.1.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p15191259115120">Description</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.1.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p1719105995115">Description of the data source.</p>
<p id="mrs_01_24146__en-us_topic_0000001219350589_p14192859165117">The value can contain only letters, digits, commas (,), periods (.), underscores (_), spaces, and line breaks.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.1.3.2.4.1.3 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p41926594511">-</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="mrs_01_24146__en-us_topic_0000001219350589_li619465910512">Configure parameters in the <strong id="mrs_01_24146__en-us_topic_0000001219350589_b447109755103434">ClickHouse Configuration</strong> area. For details, see <a href="#mrs_01_24146__en-us_topic_0000001219350589_table17193559125115">Table 2</a>.
<div class="tablenoborder"><a name="mrs_01_24146__en-us_topic_0000001219350589_table17193559125115"></a><a name="en-us_topic_0000001219350589_table17193559125115"></a><table cellpadding="4" cellspacing="0" summary="" id="mrs_01_24146__en-us_topic_0000001219350589_table17193559125115" frame="border" border="1" rules="all"><caption><b>Table 2 </b>ClickHouse Configuration</caption><thead align="left"><tr id="mrs_01_24146__en-us_topic_0000001219350589_row1619218595518"><th align="left" class="cellrowborder" valign="top" width="25.592559255925597%" id="mcps1.3.3.2.4.2.1.2.3.2.4.1.1"><p id="mrs_01_24146__en-us_topic_0000001219350589_p119217599519">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="41.03410341034103%" id="mcps1.3.3.2.4.2.1.2.3.2.4.1.2"><p id="mrs_01_24146__en-us_topic_0000001219350589_p9192115918518">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.373337333733375%" id="mcps1.3.3.2.4.2.1.2.3.2.4.1.3"><p id="mrs_01_24146__en-us_topic_0000001219350589_p0192115920511">Example Value</p>
</th>
</tr>
</thead>
<tbody><tr id="mrs_01_24146__en-us_topic_0000001219350589_row11192459145112"><td class="cellrowborder" valign="top" width="25.592559255925597%" headers="mcps1.3.3.2.4.2.1.2.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p3192155917516">Driver</p>
</td>
<td class="cellrowborder" valign="top" width="41.03410341034103%" headers="mcps1.3.3.2.4.2.1.2.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p141925599511">The default value is <strong id="mrs_01_24146__en-us_topic_0000001219350589_b413861515412">clickhouse</strong>.</p>
</td>
<td class="cellrowborder" valign="top" width="33.373337333733375%" headers="mcps1.3.3.2.4.2.1.2.3.2.4.1.3 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p11925597519">clickhouse</p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row419310598516"><td class="cellrowborder" valign="top" width="25.592559255925597%" headers="mcps1.3.3.2.4.2.1.2.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p111929592516">JDBC URL</p>
</td>
<td class="cellrowborder" valign="top" width="41.03410341034103%" headers="mcps1.3.3.2.4.2.1.2.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p1919205912514">JDBC URL of the ClickHouse data source.</p>
<ul id="mrs_01_24146__en-us_topic_0000001219350589_ul8193759185120"><li id="mrs_01_24146__en-us_topic_0000001219350589_li1019213593514">If the ClickHouse data source uses IPv4, the format is <strong id="mrs_01_24146__en-us_topic_0000001219350589_b15731216164410">jdbc:clickhouse://&lt;host&gt;:&lt;port&gt;</strong>.</li><li id="mrs_01_24146__en-us_topic_0000001219350589_li31933592514">If the ClickHouse data source uses IPv6, the format is <strong id="mrs_01_24146__en-us_topic_0000001219350589_b137178286444">jdbc:clickhouse://[&lt;host&gt;]:&lt;port&gt;</strong>.</li></ul>
<div class="p" id="mrs_01_24146__en-us_topic_0000001219350589_p8222152155414"> <ul id="mrs_01_24146__en-us_topic_0000001219350589_ul1834431419539"><li id="mrs_01_24146__en-us_topic_0000001219350589_li8343141410530">To obtain the value of <strong id="mrs_01_24146__en-us_topic_0000001219350589_b1064263802103434">&lt;host&gt;</strong>, log in to Manager of the cluster where the ClickHouse data source is located, choose <strong id="mrs_01_24146__en-us_topic_0000001219350589_b891018649103434">Cluster</strong> &gt; <strong id="mrs_01_24146__en-us_topic_0000001219350589_b438240819103434">Services</strong> &gt; <strong id="mrs_01_24146__en-us_topic_0000001219350589_b82644896103434">ClickHouse</strong> &gt; <strong id="mrs_01_24146__en-us_topic_0000001219350589_b1078313975103434">Instance</strong>, and view the ClickHouseBalancer service IP address.</li><li id="mrs_01_24146__en-us_topic_0000001219350589_li434331418537">To obtain the value of <strong id="mrs_01_24146__en-us_topic_0000001219350589_b1704333322103434">&lt;port&gt;</strong>, log in to Manager of the cluster where the ClickHouse data source is located, and choose <strong id="mrs_01_24146__en-us_topic_0000001219350589_b1798566671103434">Cluster</strong> &gt; <strong id="mrs_01_24146__en-us_topic_0000001219350589_b1842274649103434">Services</strong> &gt; <strong id="mrs_01_24146__en-us_topic_0000001219350589_b2008359346103434">ClickHouse</strong> &gt; <strong id="mrs_01_24146__en-us_topic_0000001219350589_b586574094103434">Configurations</strong> &gt; <strong id="mrs_01_24146__en-us_topic_0000001219350589_b1453940180103434">All Configurations</strong>. If the ClickHouse data source is in security mode, check the HTTPS port number of the ClickHouseBalancer instance, that is, the value of <strong id="mrs_01_24146__en-us_topic_0000001219350589_b1291303537103434">lb_https_port</strong>. If the ClickHouse data source is in normal mode, check the HTTP port number of the ClickHouseBalancer instance, that is, the value of <strong id="mrs_01_24146__en-us_topic_0000001219350589_b303147756103434">lb_http_port</strong>.</li></ul>
</div>
</td>
<td class="cellrowborder" valign="top" width="33.373337333733375%" headers="mcps1.3.3.2.4.2.1.2.3.2.4.1.3 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p15193859115117"><strong id="mrs_01_24146__en-us_topic_0000001219350589_b513139674103434">jdbc:clickhouse://10.162.156.243:21426</strong>, <strong id="mrs_01_24146__en-us_topic_0000001219350589_b434774760103434">jdbc:clickhouse://10.162.156.243:21425</strong>, or <strong id="mrs_01_24146__en-us_topic_0000001219350589_b664719847103434">jdbc:clickhouse://[fec0::d916:8:5:164:200]:21426</strong></p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row9193165916512"><td class="cellrowborder" valign="top" width="25.592559255925597%" headers="mcps1.3.3.2.4.2.1.2.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p10193459115117">Username</p>
</td>
<td class="cellrowborder" valign="top" width="41.03410341034103%" headers="mcps1.3.3.2.4.2.1.2.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p1193195916516">Username used for connecting to the ClickHouse data source.</p>
</td>
<td class="cellrowborder" valign="top" width="33.373337333733375%" headers="mcps1.3.3.2.4.2.1.2.3.2.4.1.3 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p6193205995113">Change the value based on the username being connected with the data source.</p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row019385915513"><td class="cellrowborder" valign="top" width="25.592559255925597%" headers="mcps1.3.3.2.4.2.1.2.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p519319593512">Password</p>
</td>
<td class="cellrowborder" valign="top" width="41.03410341034103%" headers="mcps1.3.3.2.4.2.1.2.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p219310599519">User password used for connecting to the ClickHouse data source.</p>
</td>
<td class="cellrowborder" valign="top" width="33.373337333733375%" headers="mcps1.3.3.2.4.2.1.2.3.2.4.1.3 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p171931059135111">Change the value based on the user password for connecting to the data source.</p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row319335925113"><td class="cellrowborder" valign="top" width="25.592559255925597%" headers="mcps1.3.3.2.4.2.1.2.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p18193959205118">Case-sensitive Table/Schema Name</p>
</td>
<td class="cellrowborder" valign="top" width="41.03410341034103%" headers="mcps1.3.3.2.4.2.1.2.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p16193259105110">Whether to support case-sensitive names or schemas of the data source.</p>
<p id="mrs_01_24146__en-us_topic_0000001219350589_p1474513131213"><span id="mrs_01_24146__en-us_topic_0000001219350589_text18443412142312">HetuEngine</span> supports case-sensitive names or schemas of the data source.</p>
<ul id="mrs_01_24146__en-us_topic_0000001219350589_ul1474013101219"><li id="mrs_01_24146__en-us_topic_0000001219350589_li1847461351211"><strong id="mrs_01_24146__en-us_topic_0000001219350589_b996294432319">No</strong>: If multiple table names exist in the same schema of a data source, for example, <strong id="mrs_01_24146__en-us_topic_0000001219350589_b1988312511249">cktable</strong> (lowercase), <strong id="mrs_01_24146__en-us_topic_0000001219350589_b21701998247">CKTABLE</strong> (uppercase), and <strong id="mrs_01_24146__en-us_topic_0000001219350589_b112901012112416">CKtable</strong> (lowercase and uppercase), only <strong id="mrs_01_24146__en-us_topic_0000001219350589_b9955227112414">cktable</strong> (lowercase) can be used by <span id="mrs_01_24146__en-us_topic_0000001219350589_text134741513131210">HetuEngine</span>.</li><li id="mrs_01_24146__en-us_topic_0000001219350589_li124745136128"><strong id="mrs_01_24146__en-us_topic_0000001219350589_b177471236182414">Yes</strong>: Only one table name can exist in the same schema of the data source, for example, <strong id="mrs_01_24146__en-us_topic_0000001219350589_b19747113642412">cktable</strong> (lowercase), <strong id="mrs_01_24146__en-us_topic_0000001219350589_b1374715369245">CKTABLE</strong> (uppercase), or <strong id="mrs_01_24146__en-us_topic_0000001219350589_b174753622420">CKtable</strong> (lowercase and uppercase). Otherwise, all tables in the schema cannot be used by <span id="mrs_01_24146__en-us_topic_0000001219350589_text204755132126">HetuEngine</span>.</li></ul>
</td>
<td class="cellrowborder" valign="top" width="33.373337333733375%" headers="mcps1.3.3.2.4.2.1.2.3.2.4.1.3 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p1153913118129">-</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="mrs_01_24146__en-us_topic_0000001219350589_li31941159175112">(Optional) Customize the configuration.<div class="p" id="mrs_01_24146__en-us_topic_0000001219350589_p1825916296234"><a name="mrs_01_24146__en-us_topic_0000001219350589_li31941159175112"></a><a name="en-us_topic_0000001219350589_li31941159175112"></a>You can click <strong id="mrs_01_24146__en-us_topic_0000001219350589_b1833893959103434">Add</strong> to add custom configuration parameters. Configure custom parameters of the ClickHouse data source. For details, see <a href="#mrs_01_24146__en-us_topic_0000001219350589_table188672024123816">Table 3</a>.
<div class="tablenoborder"><a name="mrs_01_24146__en-us_topic_0000001219350589_table188672024123816"></a><a name="en-us_topic_0000001219350589_table188672024123816"></a><table cellpadding="4" cellspacing="0" summary="" id="mrs_01_24146__en-us_topic_0000001219350589_table188672024123816" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Custom parameters of the ClickHouse data source</caption><thead align="left"><tr id="mrs_01_24146__en-us_topic_0000001219350589_row198673249384"><th align="left" class="cellrowborder" valign="top" width="27.13271327132713%" id="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.1"><p id="mrs_01_24146__en-us_topic_0000001219350589_p18671224183813">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50.07500750075008%" id="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.2"><p id="mrs_01_24146__en-us_topic_0000001219350589_p486772433813">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="22.79227922792279%" id="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.3"><p id="mrs_01_24146__en-us_topic_0000001219350589_p13867624183814">Example Value</p>
</th>
</tr>
</thead>
<tbody><tr id="mrs_01_24146__en-us_topic_0000001219350589_row1586792415389"><td class="cellrowborder" valign="top" width="27.13271327132713%" headers="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p4867624103815">use-connection-pool</p>
</td>
<td class="cellrowborder" valign="top" width="50.07500750075008%" headers="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p18867182423820">Whether to use the JDBC connection pool.</p>
</td>
<td class="cellrowborder" valign="top" width="22.79227922792279%" headers="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.3 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p12867424183818">true</p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row1286782417385"><td class="cellrowborder" valign="top" width="27.13271327132713%" headers="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p38678247385">jdbc.connection.pool.maxTotal</p>
</td>
<td class="cellrowborder" valign="top" width="50.07500750075008%" headers="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p186742419389">Maximum number of connections in the JDBC connection pool.</p>
</td>
<td class="cellrowborder" valign="top" width="22.79227922792279%" headers="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.3 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p19867524143817">8</p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row5867122443814"><td class="cellrowborder" valign="top" width="27.13271327132713%" headers="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p1586752463820">jdbc.connection.pool.maxIdle</p>
</td>
<td class="cellrowborder" valign="top" width="50.07500750075008%" headers="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p18678242384">Maximum number of idle connections in the JDBC connection pool.</p>
</td>
<td class="cellrowborder" valign="top" width="22.79227922792279%" headers="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.3 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p1686713244381">8</p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row686842418383"><td class="cellrowborder" valign="top" width="27.13271327132713%" headers="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p14868324153820">jdbc.connection.pool.minIdle</p>
</td>
<td class="cellrowborder" valign="top" width="50.07500750075008%" headers="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p28681624173820">Minimum number of idle connections in the JDBC connection pool.</p>
</td>
<td class="cellrowborder" valign="top" width="22.79227922792279%" headers="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.3 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p1686832413819">0</p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row158681240383"><td class="cellrowborder" valign="top" width="27.13271327132713%" headers="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p148682241387">jdbc.connection.pool.testOnBorrow</p>
</td>
<td class="cellrowborder" valign="top" width="50.07500750075008%" headers="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p2086816247383">Whether to check the connection validity when using a connection obtained from the JDBC connection pool.</p>
</td>
<td class="cellrowborder" valign="top" width="22.79227922792279%" headers="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.3 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p1486814247381">false</p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row1786802453817"><td class="cellrowborder" valign="top" width="27.13271327132713%" headers="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p886892483814">jdbc.pushdown-enabled</p>
</td>
<td class="cellrowborder" valign="top" width="50.07500750075008%" headers="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p186832419386">Whether to enable the pushdown function.</p>
<p id="mrs_01_24146__en-us_topic_0000001219350589_p1038995812145">Default value: <strong id="mrs_01_24146__en-us_topic_0000001219350589_b787813892316">true</strong></p>
</td>
<td class="cellrowborder" valign="top" width="22.79227922792279%" headers="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.3 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p586818247385">true</p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row586810240389"><td class="cellrowborder" valign="top" width="27.13271327132713%" headers="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p1886812411385">jdbc.pushdown-module</p>
</td>
<td class="cellrowborder" valign="top" width="50.07500750075008%" headers="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p168682024163813">Pushdown type.</p>
<ul id="mrs_01_24146__en-us_topic_0000001219350589_ul1338112711313"><li id="mrs_01_24146__en-us_topic_0000001219350589_li133842781310"><strong id="mrs_01_24146__en-us_topic_0000001219350589_b151831440141319">DEFAULT</strong>: No operator is pushed down.</li><li id="mrs_01_24146__en-us_topic_0000001219350589_li163395275133"><strong id="mrs_01_24146__en-us_topic_0000001219350589_b117749423137">BASE_PUSHDOWN</strong>: Only operators such as Filter, Aggregation, Limit, TopN, and Projection are pushed down.</li><li id="mrs_01_24146__en-us_topic_0000001219350589_li833932710135"><strong id="mrs_01_24146__en-us_topic_0000001219350589_b12339555237">FULL_PUSHDOWN</strong>: All supported operators are pushed down.</li></ul>
</td>
<td class="cellrowborder" valign="top" width="22.79227922792279%" headers="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.3 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p59472515136">-</p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row1857010298391"><td class="cellrowborder" valign="top" width="27.13271327132713%" headers="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p5571192917393">clickhouse.map-string-as-varchar</p>
</td>
<td class="cellrowborder" valign="top" width="50.07500750075008%" headers="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p13571129143919">Whether to convert the ClickHouse data source of the String and FixedString types to the Varchar type.</p>
<p id="mrs_01_24146__en-us_topic_0000001219350589_p82161379156">Default value: <strong id="mrs_01_24146__en-us_topic_0000001219350589_b1434864512212">true</strong></p>
</td>
<td class="cellrowborder" valign="top" width="22.79227922792279%" headers="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.3 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p9571132913912">true</p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row115712292394"><td class="cellrowborder" valign="top" width="27.13271327132713%" headers="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p2571829183910">clickhouse.socket-timeout</p>
</td>
<td class="cellrowborder" valign="top" width="50.07500750075008%" headers="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p5571192911397">Timeout interval for connecting to the ClickHouse data source.</p>
<p id="mrs_01_24146__en-us_topic_0000001219350589_p725715288141">Unit: millisecond</p>
<p id="mrs_01_24146__en-us_topic_0000001219350589_p1842783661414">Default value: <strong id="mrs_01_24146__en-us_topic_0000001219350589_b880343713227">120000</strong></p>
</td>
<td class="cellrowborder" valign="top" width="22.79227922792279%" headers="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.3 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p314903017319">120000</p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row20117134319411"><td class="cellrowborder" valign="top" width="27.13271327132713%" headers="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p111174437412">case-insensitive-name-matching.cache-ttl</p>
</td>
<td class="cellrowborder" valign="top" width="50.07500750075008%" headers="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p811824314415">Timeout interval for caching case-sensitive names of schemas or tables of the data sources.</p>
<p id="mrs_01_24146__en-us_topic_0000001219350589_p11186191410144">Unit: minute</p>
<p id="mrs_01_24146__en-us_topic_0000001219350589_p291544219153">Default value: <strong id="mrs_01_24146__en-us_topic_0000001219350589_b141951105229">1</strong></p>
</td>
<td class="cellrowborder" valign="top" width="22.79227922792279%" headers="mcps1.3.3.2.4.2.1.3.1.3.2.4.1.3 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p5721591211">1</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<p id="mrs_01_24146__en-us_topic_0000001219350589_p41381136162410">You can click <strong id="mrs_01_24146__en-us_topic_0000001219350589_b88666747103434">Delete</strong> to delete custom configuration parameters.</p>
</li></ol><ol type="a" start="4" id="mrs_01_24146__en-us_topic_0000001219350589_ol1419045935111"><li id="mrs_01_24146__en-us_topic_0000001219350589_li131909595519">Click <strong id="mrs_01_24146__en-us_topic_0000001219350589_b1129178630103434">OK</strong>.</li></ol>
</p></li></ol>
</div>
<div class="section" id="mrs_01_24146__en-us_topic_0000001219350589_section13645121854317"><h4 class="sectiontitle">Operation Guide</h4><ul id="mrs_01_24146__en-us_topic_0000001219350589_ul625675318554"><li id="mrs_01_24146__en-us_topic_0000001219350589_li525735318556"><a href="#mrs_01_24146__en-us_topic_0000001219350589_table14995183764415">Table 4</a> lists the ClickHouse data types supported by <span id="mrs_01_24146__en-us_topic_0000001219350589_text147361939125418">HetuEngine</span>.
<div class="tablenoborder"><a name="mrs_01_24146__en-us_topic_0000001219350589_table14995183764415"></a><a name="en-us_topic_0000001219350589_table14995183764415"></a><table cellpadding="4" cellspacing="0" summary="" id="mrs_01_24146__en-us_topic_0000001219350589_table14995183764415" frame="border" border="1" rules="all"><caption><b>Table 4 </b>ClickHouse data types supported by <span id="mrs_01_24146__en-us_topic_0000001219350589_text139274612549">HetuEngine</span></caption><thead align="left"><tr id="mrs_01_24146__en-us_topic_0000001219350589_row69958372441"><th align="left" class="cellrowborder" valign="top" id="mcps1.3.4.2.1.3.2.4.1.1"><p id="mrs_01_24146__en-us_topic_0000001219350589_p699518376448">Name</p>
</th>
<th align="left" class="cellrowborder" colspan="2" valign="top" id="mcps1.3.4.2.1.3.2.4.1.2"><p id="mrs_01_24146__en-us_topic_0000001219350589_p99959374448">ClickHouse Data Type</p>
</th>
</tr>
</thead>
<tbody><tr id="mrs_01_24146__en-us_topic_0000001219350589_row0995637174412"><td class="cellrowborder" rowspan="13" valign="top" width="37.69%" headers="mcps1.3.4.2.1.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p129951537154410">ClickHouse data types supported by <span id="mrs_01_24146__en-us_topic_0000001219350589_text16751625195515">HetuEngine</span></p>
</td>
<td class="cellrowborder" valign="top" width="30.43%" headers="mcps1.3.4.2.1.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p9995137134414">UInt8</p>
</td>
<td class="cellrowborder" valign="top" width="31.879999999999995%" headers="mcps1.3.4.2.1.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p1758121310818">Decimal128(S)</p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row2099511374443"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.1.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p299563744413">UInt16</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.1.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p155621357814">Boolean</p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row299517374446"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.1.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p69951737144412">UInt32</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.1.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p6562851685">String</p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row19995237174414"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.1.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p17996143724419">UInt64</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.1.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p7562859815">Fixedstring(N)</p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row1499683710444"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.1.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p399663712449">Int8</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.1.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p7563451585">UUID</p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row69961137204419"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.1.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p199961837154413">Int16</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.1.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p0563251984">Date</p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row117064321378"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.1.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p1670793217714">Int32</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.1.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p125638514819">DateTime([timezone])</p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row1099663754418"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.1.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p11996737104419">Int64</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.1.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p103011256444">Enum</p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row19808152711011"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.1.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p7808112711010">Float32</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.1.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p930217561044">LowCardinality(data_type)</p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row480817271501"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.1.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p1380832719020">Float64</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.1.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p10302856242">Nullable(typename)</p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row1880820276010"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.1.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p8808427901">Decimal(P, S)</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.1.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p84439542036">IPv4</p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row128085271016"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.1.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p1180842718013">Decimal32(S)</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.1.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p344319541436">IPv6</p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row180816271403"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.1.3.2.4.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p380914271020">Decimal64(S)</p>
</td>
<td class="cellrowborder" valign="top" headers="mcps1.3.4.2.1.3.2.4.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p744315541836">-</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="mrs_01_24146__en-us_topic_0000001219350589_li16856331115713"><a href="#mrs_01_24146__en-us_topic_0000001219350589_table7424121341219">Table 5</a> lists the tables and views that support the interconnection between <span id="mrs_01_24146__en-us_topic_0000001219350589_text1281129155716">HetuEngine</span> and ClickHouse.
<div class="tablenoborder"><a name="mrs_01_24146__en-us_topic_0000001219350589_table7424121341219"></a><a name="en-us_topic_0000001219350589_table7424121341219"></a><table cellpadding="4" cellspacing="0" summary="" id="mrs_01_24146__en-us_topic_0000001219350589_table7424121341219" frame="border" border="1" rules="all"><caption><b>Table 5 </b>Supported tables and views</caption><thead align="left"><tr id="mrs_01_24146__en-us_topic_0000001219350589_row14424101317124"><th align="left" class="cellrowborder" valign="top" width="24.34%" id="mcps1.3.4.2.2.3.2.3.1.1"><p id="mrs_01_24146__en-us_topic_0000001219350589_p9424141311129">Name</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="75.66000000000001%" id="mcps1.3.4.2.2.3.2.3.1.2"><p id="mrs_01_24146__en-us_topic_0000001219350589_p1424313191220">Supported Table and View</p>
</th>
</tr>
</thead>
<tbody><tr id="mrs_01_24146__en-us_topic_0000001219350589_row34241913161216"><td class="cellrowborder" rowspan="3" valign="top" width="24.34%" headers="mcps1.3.4.2.2.3.2.3.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p18930163419125">Tables that support the interconnection between <span id="mrs_01_24146__en-us_topic_0000001219350589_text146109514616">HetuEngine</span> and ClickHouse</p>
</td>
<td class="cellrowborder" valign="top" width="75.66000000000001%" headers="mcps1.3.4.2.2.3.2.3.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p7424111371210">Local table (MergeTree)</p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row1642421381213"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.2.3.2.3.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p1942416134125">Replicated table (ReplicatedReplacingMergeTree)</p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row14424161391211"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.2.3.2.3.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p1742441381211">Distributed table</p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row12536146115816"><td class="cellrowborder" rowspan="2" valign="top" width="24.34%" headers="mcps1.3.4.2.2.3.2.3.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p1187031955912">Views that support the interconnection between <span id="mrs_01_24146__en-us_topic_0000001219350589_text10967112513718">HetuEngine</span> and ClickHouse</p>
</td>
<td class="cellrowborder" valign="top" width="75.66000000000001%" headers="mcps1.3.4.2.2.3.2.3.1.2 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p1653710460587">Normal view</p>
</td>
</tr>
<tr id="mrs_01_24146__en-us_topic_0000001219350589_row15815511589"><td class="cellrowborder" valign="top" headers="mcps1.3.4.2.2.3.2.3.1.1 "><p id="mrs_01_24146__en-us_topic_0000001219350589_p1058125135815">Materialized view</p>
</td>
</tr>
</tbody>
</table>
</div>
</li></ul>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="mrs_01_2314.html">Configuring Data Sources</a></div>
</div>
</div>