vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/mrs/component-operation-guide-lts/mrs_01_2351.html
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

284 lines
39 KiB
HTML
Raw Blame History

<a name="mrs_01_2351"></a><a name="mrs_01_2351"></a>
<h1 class="topictitle1">Configuring a GaussDB Data Source</h1>
<div id="body32001227"><div class="section" id="mrs_01_2351__en-us_topic_0000001219149679_section20281944184514"><h4 class="sectiontitle">Scenario</h4><p id="mrs_01_2351__en-us_topic_0000001219149679_p1662754617458">This section describes how to add a GaussDB JDBC data source on the HSConsole page.</p>
</div>
<div class="section" id="mrs_01_2351__en-us_topic_0000001219149679_section197211512297"><h4 class="sectiontitle">Prerequisites</h4><ul id="mrs_01_2351__en-us_topic_0000001219351171_ul1071215716197"><li id="mrs_01_2351__en-us_topic_0000001219351171_li1712871196">The domain name of the cluster where the data source is located must be different from the <span id="mrs_01_2351__en-us_topic_0000001219351171_text06321706326">HetuEngine</span> cluster domain name.</li><li id="mrs_01_2351__en-us_topic_0000001219351171_li1371219711915">The cluster where the data source is located and the <span id="mrs_01_2351__en-us_topic_0000001219351171_text15282374329">HetuEngine</span> cluster nodes can communicate with each other.</li><li id="mrs_01_2351__en-us_topic_0000001219351171_li117681415182710">A <span id="mrs_01_2351__en-us_topic_0000001219351171_text16432927192716">HetuEngine</span> compute instance has been created.</li></ul>
</div>
<div class="section" id="mrs_01_2351__en-us_topic_0000001219149679_section14994432012"><h4 class="sectiontitle">Procedure</h4><ol id="mrs_01_2351__en-us_topic_0000001219149679_ol11603831163017"><li id="mrs_01_2351__en-us_topic_0000001219149679_li186031531103012"><span>Log in to FusionInsight Manager as a <span id="mrs_01_2351__en-us_topic_0000001219149679_text777114345818">HetuEngine</span> administrator and choose <strong id="mrs_01_2351__en-us_topic_0000001219149679_b382343185812">Cluster</strong> &gt; <strong id="mrs_01_2351__en-us_topic_0000001219149679_b28317438589">Services</strong> &gt; <strong id="mrs_01_2351__en-us_topic_0000001219149679_b3830435588"><span id="mrs_01_2351__en-us_topic_0000001219149679_text68364325810">HetuEngine</span></strong>. The <strong id="mrs_01_2351__en-us_topic_0000001219149679_b184194375811"><span id="mrs_01_2351__en-us_topic_0000001219149679_text1184943145811">HetuEngine</span></strong> service page is displayed.</span></li><li id="mrs_01_2351__en-us_topic_0000001219149679_li56031317301"><span>In the <strong id="mrs_01_2351__en-us_topic_0000001219149679_b183843581585">Basic Information</strong> area on the <strong id="mrs_01_2351__en-us_topic_0000001219149679_b1639017585588">Dashboard</strong> page, click the link next to <strong id="mrs_01_2351__en-us_topic_0000001219149679_b239025845811">HSConsole WebUI</strong>. The HSConsole page is displayed.</span></li><li id="mrs_01_2351__en-us_topic_0000001219149679_li19603163153010"><span>Choose <strong id="mrs_01_2351__en-us_topic_0000001219149679_b813815499479">Data Source</strong>.</span></li><li id="mrs_01_2351__en-us_topic_0000001219149679_li1760343103019"><span>Click <strong id="mrs_01_2351__en-us_topic_0000001219149679_b142371424125914">Add Data Source</strong>. Configure parameters on the <strong id="mrs_01_2351__en-us_topic_0000001219149679_b103018241000">Add Data Source</strong> page.</span><p><ol type="a" id="mrs_01_2351__en-us_topic_0000001219149679_ol885813431952"><li id="mrs_01_2351__en-us_topic_0000001219149679_li108582434511">Configure <span class="parmname" id="mrs_01_2351__en-us_topic_0000001219149679_parmname20948430155918"><b>Basic Information</b></span>. For details, see <a href="#mrs_01_2351__en-us_topic_0000001219149679_table16806135773018">Table 1</a>.
<div class="tablenoborder"><a name="mrs_01_2351__en-us_topic_0000001219149679_table16806135773018"></a><a name="en-us_topic_0000001219149679_table16806135773018"></a><table cellpadding="4" cellspacing="0" summary="" id="mrs_01_2351__en-us_topic_0000001219149679_table16806135773018" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Basic Information</caption><thead align="left"><tr id="mrs_01_2351__en-us_topic_0000001219149679_row28072577307"><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_2351__en-us_topic_0000001219149679_p85039214318">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_2351__en-us_topic_0000001219149679_p9503132103116">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_2351__en-us_topic_0000001219149679_p25037215313">Example Value</p>
</th>
</tr>
</thead>
<tbody><tr id="mrs_01_2351__en-us_topic_0000001219149679_row1980712578301"><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_2351__en-us_topic_0000001219149679_p13505123418316">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_2351__en-us_topic_0000001219149679_p4621157183115">Name of the data source to be connected.</p>
<p id="mrs_01_2351__en-us_topic_0000001219149679_p189518463595">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_2351__en-us_topic_0000001219149679_p1280710578303">gaussdb_1</p>
</td>
</tr>
<tr id="mrs_01_2351__en-us_topic_0000001219149679_row180715773011"><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_2351__en-us_topic_0000001219149679_p11505113453114">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_2351__en-us_topic_0000001219149679_p187618103210">Type of the data source to be connected. Choose <strong id="mrs_01_2351__en-us_topic_0000001219149679_b4480477590">JDBC</strong> &gt; <strong id="mrs_01_2351__en-us_topic_0000001219149679_b45454745918">GAUSSDB-A</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_2351__en-us_topic_0000001219149679_p1376108133214">GAUSSDB-A</p>
</td>
</tr>
<tr id="mrs_01_2351__en-us_topic_0000001219149679_row1480775703020"><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_2351__en-us_topic_0000001219149679_p155056348318">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_2351__en-us_topic_0000001219149679_p105371618103210">Description of the data source.</p>
<p id="mrs_01_2351__en-us_topic_0000001219149679_p1653910568594">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_2351__en-us_topic_0000001219149679_p11537118173215">-</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="mrs_01_2351__en-us_topic_0000001219149679_li158582431451">Configure parameters in the <strong id="mrs_01_2351__en-us_topic_0000001219149679_b205671659018">GAUSSDB-A Configuration</strong> area. For details, see <a href="#mrs_01_2351__en-us_topic_0000001219149679_table102190549122">Table 2</a>.
<div class="tablenoborder"><a name="mrs_01_2351__en-us_topic_0000001219149679_table102190549122"></a><a name="en-us_topic_0000001219149679_table102190549122"></a><table cellpadding="4" cellspacing="0" summary="" id="mrs_01_2351__en-us_topic_0000001219149679_table102190549122" frame="border" border="1" rules="all"><caption><b>Table 2 </b>GAUSSDB-A Configuration</caption><thead align="left"><tr id="mrs_01_2351__en-us_topic_0000001219149679_row6219205419128"><th align="left" class="cellrowborder" valign="top" width="33.333333333333336%" id="mcps1.3.3.2.4.2.1.2.3.2.4.1.1"><p id="mrs_01_2351__en-us_topic_0000001219149679_p182813382120">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.29332933293329%" id="mcps1.3.3.2.4.2.1.2.3.2.4.1.2"><p id="mrs_01_2351__en-us_topic_0000001219149679_p112863362120">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_2351__en-us_topic_0000001219149679_p22810330217">Example Value</p>
</th>
</tr>
</thead>
<tbody><tr id="mrs_01_2351__en-us_topic_0000001219149679_row192191054161213"><td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.3.2.4.2.1.2.3.2.4.1.1 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p123714409216">Driver</p>
</td>
<td class="cellrowborder" valign="top" width="33.29332933293329%" headers="mcps1.3.3.2.4.2.1.2.3.2.4.1.2 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p6237104082110">The default value is <strong id="mrs_01_2351__en-us_topic_0000001219149679_b1323811196018">gaussdba</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_2351__en-us_topic_0000001219149679_p1623715404211">gaussdba</p>
</td>
</tr>
<tr id="mrs_01_2351__en-us_topic_0000001219149679_row1821915491212"><td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.3.2.4.2.1.2.3.2.4.1.1 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p1323784010215">JDBC URL</p>
</td>
<td class="cellrowborder" valign="top" width="33.29332933293329%" headers="mcps1.3.3.2.4.2.1.2.3.2.4.1.2 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p1523818409219">JDBC URL for connecting to GaussDB A. The format is as follows:</p>
<p id="mrs_01_2351__en-us_topic_0000001219149679_p4671165817310"><strong id="mrs_01_2351__en-us_topic_0000001219149679_b597812369014">jdbc:postgresql://</strong><em id="mrs_01_2351__en-us_topic_0000001219149679_i202681041602">CN service IP address</em><strong id="mrs_01_2351__en-us_topic_0000001219149679_b446813451001">:</strong><em id="mrs_01_2351__en-us_topic_0000001219149679_i17749194911012">Port number</em><strong id="mrs_01_2351__en-us_topic_0000001219149679_b37971052002">/</strong><em id="mrs_01_2351__en-us_topic_0000001219149679_i9813055708">Database name</em></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_2351__en-us_topic_0000001219149679_p123810400216">jdbc:postgresql://10.0.136.1:25308/postgres</p>
</td>
</tr>
<tr id="mrs_01_2351__en-us_topic_0000001219149679_row021985420127"><td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.3.2.4.2.1.2.3.2.4.1.1 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p1523874052112">Username</p>
</td>
<td class="cellrowborder" valign="top" width="33.29332933293329%" headers="mcps1.3.3.2.4.2.1.2.3.2.4.1.2 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p1223884019211">Username for connecting to the GaussDB 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_2351__en-us_topic_0000001219149679_p17238184032112">Change the value based on the username being connected with the data source.</p>
</td>
</tr>
<tr id="mrs_01_2351__en-us_topic_0000001219149679_row2219125410127"><td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.3.2.4.2.1.2.3.2.4.1.1 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p2023813405218">Password</p>
</td>
<td class="cellrowborder" valign="top" width="33.29332933293329%" headers="mcps1.3.3.2.4.2.1.2.3.2.4.1.2 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p16238104072115">Password for connecting to the GaussDB 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_2351__en-us_topic_0000001219149679_p14238144012119">Change the value based on the username and password for connecting to the data source.</p>
</td>
</tr>
<tr id="mrs_01_2351__en-us_topic_0000001219149679_row421915461217"><td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.3.2.4.2.1.2.3.2.4.1.1 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p1823884010216">GaussDB User Information Configuration</p>
</td>
<td class="cellrowborder" valign="top" width="33.29332933293329%" headers="mcps1.3.3.2.4.2.1.2.3.2.4.1.2 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p32386407211">Configure multiple GaussDB usernames and passwords in the format of <strong id="mrs_01_2351__en-us_topic_0000001219149679_b22982407473">dataSourceUser</strong> and <strong id="mrs_01_2351__en-us_topic_0000001219149679_b234019422477">password</strong> key-value pairs.</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_2351__en-us_topic_0000001219149679_p42381140192118">-</p>
</td>
</tr>
<tr id="mrs_01_2351__en-us_topic_0000001219149679_row1621995413128"><td class="cellrowborder" valign="top" width="33.333333333333336%" headers="mcps1.3.3.2.4.2.1.2.3.2.4.1.1 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p1823814082114"><span id="mrs_01_2351__en-us_topic_0000001219149679_text62384406219">HetuEngine</span>-GaussDB User Mapping Configuration</p>
</td>
<td class="cellrowborder" valign="top" width="33.29332933293329%" headers="mcps1.3.3.2.4.2.1.2.3.2.4.1.2 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p22381940142119">Multiple <span id="mrs_01_2351__en-us_topic_0000001219149679_text14238184016215">HetuEngine</span> accounts are configured in the format of <strong id="mrs_01_2351__en-us_topic_0000001219149679_b42851357105014">hetuUser</strong> and <strong id="mrs_01_2351__en-us_topic_0000001219149679_b1631917016516">dataSourceUser</strong> key-value pairs, corresponding to one of the users configured in the <strong id="mrs_01_2351__en-us_topic_0000001219149679_b19653621135212">GaussDB User Information Configuration</strong> area. When different <span id="mrs_01_2351__en-us_topic_0000001219149679_text15238840112113">HetuEngine</span> users are used to access GaussDB, different GaussDB usernames and passwords can be used.</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_2351__en-us_topic_0000001219149679_p723812406213">-</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="mrs_01_2351__en-us_topic_0000001219149679_li17201118111616">Configure the GaussDB data source user information. For details, see <a href="#mrs_01_2351__en-us_topic_0000001219149679_table171526153351">Table 3</a>.<div class="p" id="mrs_01_2351__en-us_topic_0000001219149679_p06515213166"><strong id="mrs_01_2351__en-us_topic_0000001219149679_b461174144514">GaussDB User Information Configuration</strong> and <strong id="mrs_01_2351__en-us_topic_0000001219149679_b561211474516"><span id="mrs_01_2351__en-us_topic_0000001219149679_text861217411453">HetuEngine</span>-GaussDB User Mapping Configuration</strong> must be used together. When <span id="mrs_01_2351__en-us_topic_0000001219149679_text1961214414452">HetuEngine</span> is connected to the GaussDB data source, <span id="mrs_01_2351__en-us_topic_0000001219149679_text116127419459">HetuEngine</span> users can have the same permissions of the mapped GaussDB data source user through mapping. Multiple <span id="mrs_01_2351__en-us_topic_0000001219149679_text4625498459">HetuEngine</span> users can correspond to one GaussDB user.
<div class="tablenoborder"><a name="mrs_01_2351__en-us_topic_0000001219149679_table171526153351"></a><a name="en-us_topic_0000001219149679_table171526153351"></a><table cellpadding="4" cellspacing="0" summary="" id="mrs_01_2351__en-us_topic_0000001219149679_table171526153351" frame="border" border="1" rules="all"><caption><b>Table 3 </b>GaussDB User Information Configuration</caption><thead align="left"><tr id="mrs_01_2351__en-us_topic_0000001219149679_row2019311533510"><th align="left" class="cellrowborder" valign="top" width="28.02280228022802%" id="mcps1.3.3.2.4.2.1.3.2.6.2.4.1.1"><p id="mrs_01_2351__en-us_topic_0000001219149679_p161937157357">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="38.64386438643865%" id="mcps1.3.3.2.4.2.1.3.2.6.2.4.1.2"><p id="mrs_01_2351__en-us_topic_0000001219149679_p18193615153512">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.2.4.2.1.3.2.6.2.4.1.3"><p id="mrs_01_2351__en-us_topic_0000001219149679_p16193715133510">Example Value</p>
</th>
</tr>
</thead>
<tbody><tr id="mrs_01_2351__en-us_topic_0000001219149679_row9193715133515"><td class="cellrowborder" valign="top" width="28.02280228022802%" headers="mcps1.3.3.2.4.2.1.3.2.6.2.4.1.1 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p13193915103516">Data Source User</p>
</td>
<td class="cellrowborder" valign="top" width="38.64386438643865%" headers="mcps1.3.3.2.4.2.1.3.2.6.2.4.1.2 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p1719371520353">Data Source User</p>
<p id="mrs_01_2351__en-us_topic_0000001219149679_p81816311486">The value can contain only letters, digits, underscores (_), hyphens (-), and periods (.), and must start with a letter or underscore (_). The minimum length is 2 characters and the maximum length is 100 characters.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.3.2.6.2.4.1.3 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p01407262112">If the data source user is set to <strong id="mrs_01_2351__en-us_topic_0000001219149679_b55071619174619">gaussuser1</strong>, a <span id="mrs_01_2351__en-us_topic_0000001219149679_text11507151917468">HetuEngine</span> user mapped to <strong id="mrs_01_2351__en-us_topic_0000001219149679_b4507191918467">gaussuser1</strong> must exist.</p>
<p id="mrs_01_2351__en-us_topic_0000001219149679_p2574328152814">For example, create <strong id="mrs_01_2351__en-us_topic_0000001219149679_b16681115423319">hetuuser1</strong> and map it to <strong id="mrs_01_2351__en-us_topic_0000001219149679_b18343379753319">gaussuser1</strong>.</p>
</td>
</tr>
<tr id="mrs_01_2351__en-us_topic_0000001219149679_row21931215103520"><td class="cellrowborder" valign="top" width="28.02280228022802%" headers="mcps1.3.3.2.4.2.1.3.2.6.2.4.1.1 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p16193171523520">Password</p>
</td>
<td class="cellrowborder" valign="top" width="38.64386438643865%" headers="mcps1.3.3.2.4.2.1.3.2.6.2.4.1.2 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p181931315123510">User authentication password of the corresponding data source.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.3.2.6.2.4.1.3 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p019331510356">-</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</li><li id="mrs_01_2351__en-us_topic_0000001219149679_li6755124974316">Configure the HetuEngine-GaussDB user mapping. For details, see <a href="#mrs_01_2351__en-us_topic_0000001219149679_table16160161519353">Table 4</a>.
<div class="tablenoborder"><a name="mrs_01_2351__en-us_topic_0000001219149679_table16160161519353"></a><a name="en-us_topic_0000001219149679_table16160161519353"></a><table cellpadding="4" cellspacing="0" summary="" id="mrs_01_2351__en-us_topic_0000001219149679_table16160161519353" frame="border" border="1" rules="all"><caption><b>Table 4 </b>HetuEngine-GaussDB User Mapping Configuration</caption><thead align="left"><tr id="mrs_01_2351__en-us_topic_0000001219149679_row1619361583510"><th align="left" class="cellrowborder" valign="top" width="28.302830283028303%" id="mcps1.3.3.2.4.2.1.4.2.2.4.1.1"><p id="mrs_01_2351__en-us_topic_0000001219149679_p141934158356">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="38.36383638363836%" id="mcps1.3.3.2.4.2.1.4.2.2.4.1.2"><p id="mrs_01_2351__en-us_topic_0000001219149679_p1219381523513">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.2.4.2.1.4.2.2.4.1.3"><p id="mrs_01_2351__en-us_topic_0000001219149679_p619341543515">Example Value</p>
</th>
</tr>
</thead>
<tbody><tr id="mrs_01_2351__en-us_topic_0000001219149679_row11937159358"><td class="cellrowborder" valign="top" width="28.302830283028303%" headers="mcps1.3.3.2.4.2.1.4.2.2.4.1.1 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p519371516351">HetuEngine User</p>
</td>
<td class="cellrowborder" valign="top" width="38.36383638363836%" headers="mcps1.3.3.2.4.2.1.4.2.2.4.1.2 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p136309268575"><span id="mrs_01_2351__en-us_topic_0000001219149679_text201861826112110">HetuEngine</span> username.</p>
<p id="mrs_01_2351__en-us_topic_0000001219149679_p219315155355">The value can contain only letters, digits, underscores (_), hyphens (-), and periods (.), and must start with a letter or underscore (_). The minimum length is 2 characters and the maximum length is 100 characters.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.4.2.2.4.1.3 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p6830142514315">hetuuser1</p>
</td>
</tr>
<tr id="mrs_01_2351__en-us_topic_0000001219149679_row61931615153518"><td class="cellrowborder" valign="top" width="28.302830283028303%" headers="mcps1.3.3.2.4.2.1.4.2.2.4.1.1 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p141931915183513">Data Source User</p>
</td>
<td class="cellrowborder" valign="top" width="38.36383638363836%" headers="mcps1.3.3.2.4.2.1.4.2.2.4.1.2 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p419301593511">Data source user.</p>
<p id="mrs_01_2351__en-us_topic_0000001219149679_p94659181587">The value can contain only letters, digits, underscores (_), hyphens (-), and periods (.), and must start with a letter or underscore (_). The minimum length is 2 characters and the maximum length is 100 characters.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.4.2.2.4.1.3 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p14193201513513"><strong id="mrs_01_2351__en-us_topic_0000001219149679_b83551653114717">gaussuser1</strong> (data source user configured in <a href="#mrs_01_2351__en-us_topic_0000001219149679_table171526153351">Table 3</a>)</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="mrs_01_2351__en-us_topic_0000001219149679_li1285894313512">Modify custom configurations.<ul id="mrs_01_2351__en-us_topic_0000001219149679_ul16858144314516"><li id="mrs_01_2351__en-us_topic_0000001219149679_li685844315512">You can click <strong id="mrs_01_2351__en-us_topic_0000001219149679_b1413720194516">Add</strong> to add custom configuration parameters. Configure custom parameters of the GaussDB data source. For details, see <a href="#mrs_01_2351__en-us_topic_0000001219149679_table132941558135018">Table 5</a>.
<div class="tablenoborder"><a name="mrs_01_2351__en-us_topic_0000001219149679_table132941558135018"></a><a name="en-us_topic_0000001219149679_table132941558135018"></a><table cellpadding="4" cellspacing="0" summary="" id="mrs_01_2351__en-us_topic_0000001219149679_table132941558135018" frame="border" border="1" rules="all"><caption><b>Table 5 </b>Custom parameters of the GaussDB data source</caption><thead align="left"><tr id="mrs_01_2351__en-us_topic_0000001219149679_row12294558105014"><th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.1"><p id="mrs_01_2351__en-us_topic_0000001219149679_p1829475835014">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.2"><p id="mrs_01_2351__en-us_topic_0000001219149679_p14294165845019">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="33.33333333333333%" id="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.3"><p id="mrs_01_2351__en-us_topic_0000001219149679_p8294758155014">Example Value</p>
</th>
</tr>
</thead>
<tbody><tr id="mrs_01_2351__en-us_topic_0000001219149679_row17294158165019"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.1 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p16294858155013">use-connection-pool</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.2 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p329485815507">Whether to use the JDBC connection pool.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.3 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p17294558195012">true</p>
</td>
</tr>
<tr id="mrs_01_2351__en-us_topic_0000001219149679_row152949583504"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.1 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p129414581505">jdbc.connection.pool.maxTotal</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.2 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p192941158195014">Maximum number of connections in the JDBC connection pool.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.3 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p132941589505">8</p>
</td>
</tr>
<tr id="mrs_01_2351__en-us_topic_0000001219149679_row142941858155011"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.1 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p16294858155016">jdbc.connection.pool.maxIdle</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.2 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p8294155817501">Maximum number of idle connections in the JDBC connection pool.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.3 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p2294205816508">8</p>
</td>
</tr>
<tr id="mrs_01_2351__en-us_topic_0000001219149679_row73721905545"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.1 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p183733095415">jdbc.connection.pool.minIdle</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.2 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p73732014548">Minimum number of idle connections in the JDBC connection pool.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.3 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p19373904542">0</p>
</td>
</tr>
<tr id="mrs_01_2351__en-us_topic_0000001219149679_row43151299548"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.1 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p173155914543">jdbc.pushdown-enabled</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.2 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p2584104610191"><strong id="mrs_01_2351__en-us_topic_0000001219149679_b2318183315523">true</strong>: SQL statements can be pushed down to the data source for execution.</p>
<p id="mrs_01_2351__en-us_topic_0000001219149679_p81991810112017"><strong id="mrs_01_2351__en-us_topic_0000001219149679_b12922154525211">false</strong>: SQL statements are not pushed down to the data source for execution. As a result, more network and computing resources are consumed.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.3 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p1731579185414">true</p>
</td>
</tr>
<tr id="mrs_01_2351__en-us_topic_0000001219149679_row1467917416549"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.1 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p0679154145410">jdbc.pushdown-module</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.2 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p115231029192118">The push-down function should be enabled in advance.</p>
<ul id="mrs_01_2351__en-us_topic_0000001219149679_ul6861436113714"><li id="mrs_01_2351__en-us_topic_0000001219149679_li2086153618378"><strong id="mrs_01_2351__en-us_topic_0000001219149679_b160048443303344">DEFAULT</strong>: No operator is pushed down.</li><li id="mrs_01_2351__en-us_topic_0000001219149679_li12861736183715"><strong id="mrs_01_2351__en-us_topic_0000001219149679_b173068896403344">BASE_PUSHDOWN</strong>: Only operators such as Filter, Aggregation, Limit, TopN, and Projection are pushed down.</li><li id="mrs_01_2351__en-us_topic_0000001219149679_li7861236143710"><strong id="mrs_01_2351__en-us_topic_0000001219149679_b3447226184618">FULL_PUSHDOWN</strong>: All supported operators are pushed down.</li></ul>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.3 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p183825418372">DEFAULT</p>
</td>
</tr>
<tr id="mrs_01_2351__en-us_topic_0000001219149679_row1866414615612"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.1 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p176645695613">source-encoding</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.2 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p1466418605610">GaussDB data source encoding mode.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.3 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p1666419620565">UTF-8</p>
</td>
</tr>
<tr id="mrs_01_2351__en-us_topic_0000001219149679_row8648123175619"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.1 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p196491834569">multiple-cnn-enabled</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.2 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p36494355618">Whether to use the GaussDB multi-CN configuration. To use it, ensure that the JDBC connection pool is disabled and the JDBC URL format is as follows: jdbc:postgresql://host:port/database,jdbc:postgresql://host:port/database,jdbc:postgresql://host:port/database.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.3 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p12649203185611">false</p>
</td>
</tr>
<tr id="mrs_01_2351__en-us_topic_0000001219149679_row191613011568"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.1 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p119171208561">parallel-read-enabled</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.2 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p6917130115610">Whether to use the parallel data read function.</p>
<p id="mrs_01_2351__en-us_topic_0000001219149679_p9406102192310">If the parallel data read function is enabled, the actual number of splits is determined based on the node distribution and the value of <strong id="mrs_01_2351__en-us_topic_0000001219149679_b1876550155418">max-splits</strong>.</p>
<p id="mrs_01_2351__en-us_topic_0000001219149679_p1978174411286">Multiple connections to the data source will be created for parallel read operations. The dependent data source should support the load.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.3 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p69176011561">false</p>
</td>
</tr>
<tr id="mrs_01_2351__en-us_topic_0000001219149679_row327443141220"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.1 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p35312259125">split-type</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.2 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p727523161216">Type of the parallel data read function.</p>
<ul id="mrs_01_2351__en-us_topic_0000001219149679_ul13476248203713"><li id="mrs_01_2351__en-us_topic_0000001219149679_li164762484377"><strong id="mrs_01_2351__en-us_topic_0000001219149679_b15850164212418">NODE</strong>: The degree of parallelism (DOP) is categorized based on the GaussDB data source DataNodes.</li><li id="mrs_01_2351__en-us_topic_0000001219149679_li347644812377"><strong id="mrs_01_2351__en-us_topic_0000001219149679_b1011513449412">PARTITION</strong>: The DOP is categorized based on table partitions.</li><li id="mrs_01_2351__en-us_topic_0000001219149679_li2476154833714"><strong id="mrs_01_2351__en-us_topic_0000001219149679_b158840275463">INDEX</strong>: The DOP is categorized based on table indexes.</li></ul>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.3 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p177074613380">NODE</p>
</td>
</tr>
<tr id="mrs_01_2351__en-us_topic_0000001219149679_row1820056201217"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.1 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p112002691218">max-splits</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.2 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p1320011612126">Maximum degree of parallelism.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.3 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p72003616125">5</p>
</td>
</tr>
<tr id="mrs_01_2351__en-us_topic_0000001219149679_row12755175913119"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.1 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p6755115991113">use-copymanager-for-insert</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.2 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p1575513599114">Whether to use CopyManager for batch import.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.3 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p9755059121113">false</p>
</td>
</tr>
<tr id="mrs_01_2351__en-us_topic_0000001219149679_row865367144312"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.1 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p15653371436">unsupported-type-handling</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.2 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p1665387134312">If the connector does not support the data of a certain type, convert it to VARCHAR.</p>
<ul id="mrs_01_2351__en-us_topic_0000001219149679_ul8707151217356"><li id="mrs_01_2351__en-us_topic_0000001219149679_li570741215355">After the <strong id="mrs_01_2351__en-us_topic_0000001219149679_b157448104565">CONVERT_TO_VARCHAR</strong> parameter is configured, the data of BIT VARYING, CIDR, MACADDR, INET, OID, REGTYPE, REGCONFIG and POINT types are converted to the varchar type during query and data of these types can only be read.</li><li id="mrs_01_2351__en-us_topic_0000001219149679_li6707191212359">The default value is IGNORE, indicating that unsupported types will be not displayed in the result.</li></ul>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.3 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p674322123513">CONVERT_TO_VARCHAR</p>
</td>
</tr>
<tr id="mrs_01_2351__en-us_topic_0000001219149679_row1965911226524"><td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.1 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p166042255211">max-bytes-in-a-batch-for-copymanager-in-mb</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.2 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p2660222115218">Maximum volume of data imported by CopyManager in a batch, in MB.</p>
</td>
<td class="cellrowborder" valign="top" width="33.33333333333333%" headers="mcps1.3.3.2.4.2.1.5.1.1.3.2.4.1.3 "><p id="mrs_01_2351__en-us_topic_0000001219149679_p156601422115218">10</p>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="mrs_01_2351__en-us_topic_0000001219149679_li48586439515">You can click <strong id="mrs_01_2351__en-us_topic_0000001219149679_b551114211453">Delete</strong> to delete custom configuration parameters.</li></ul>
</li><li id="mrs_01_2351__en-us_topic_0000001219149679_li28580431756">Click <strong id="mrs_01_2351__en-us_topic_0000001219149679_b32256271559">OK</strong>.</li></ol>
<div class="notice" id="mrs_01_2351__en-us_topic_0000001219149679_note1981205419598"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><ul id="mrs_01_2351__en-us_topic_0000001219149679_ul392715362511"><li id="mrs_01_2351__en-us_topic_0000001219149679_li392775316251">The UPDATE and DELETE syntaxes do not support filtering clauses containing cross-catalog conditions, for example, <strong id="mrs_01_2351__en-us_topic_0000001219149679_b1052743135919">UPDATE mppdb.table SET column1=value WHERE column2 IN (SELECT column2 from hive.table)</strong>.</li><li id="mrs_01_2351__en-us_topic_0000001219149679_li14238101815115">To use the DELETE syntax, set <strong id="mrs_01_2351__en-us_topic_0000001219149679_b6457172435815">jdbc.pushdown-enabled</strong> to <strong id="mrs_01_2351__en-us_topic_0000001219149679_b208622714586">true</strong> and <strong id="mrs_01_2351__en-us_topic_0000001219149679_b136741361587">unsupported-type-handling</strong> to <strong id="mrs_01_2351__en-us_topic_0000001219149679_b1129104216587">CONVERT_TO_VARCHAR</strong>.</li><li id="mrs_01_2351__en-us_topic_0000001219149679_li3599105642512">The DELETE syntax does not support filtering clauses containing subqueries, for example, <strong id="mrs_01_2351__en-us_topic_0000001219149679_b126683018111">DELETE FROM mppdb.table WHERE column IN (SELECT column FROM mppdb.table1)</strong>.</li><li id="mrs_01_2351__en-us_topic_0000001219149679_li1587322784118"><span id="mrs_01_2351__en-us_topic_0000001219149679_text121984545519">HetuEngine</span> supports a maximum precision of 38 digits for GaussDB data sources of the NUMBER data type </li></ul>
</div></div>
</p></li></ol>
</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>
View Git Blame Copy Permalink