Files
doc-exports/docs/dataartsstudio/umn/dataartsstudio_01_0044.html
chenxiaoxiong f9e2808b7c DataArts UMN 20250810 version
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
Co-authored-by: chenxiaoxiong <chenxiaoxiong@huawei.com>
Co-committed-by: chenxiaoxiong <chenxiaoxiong@huawei.com>
2025-09-02 10:44:13 +00:00

147 lines
17 KiB
HTML

<a name="dataartsstudio_01_0044"></a><a name="dataartsstudio_01_0044"></a>
<h1 class="topictitle1">PostgreSQL/SQLServer Link Parameters</h1>
<div id="body8662426"><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p18117455259"><a href="#dataartsstudio_01_0044__en-us_topic_0108275292_table5321744015490">Table 1</a> lists the parameters for creating a link to PostgreSQL/SQLServer. Greenplum, Kingbase, and GaussDB can be connected through the PostgreSQL connector. The source and destination data sources supported by migration jobs are the same as those for PostgreSQL.</p>
<div class="note" id="dataartsstudio_01_0044__en-us_topic_0108275292_note36461362017"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p167832113185">Do not change the password or user when the job is running. If you do so, the password will not take effect immediately and the job will fail.</p>
</div></div>
<div class="tablenoborder"><a name="dataartsstudio_01_0044__en-us_topic_0108275292_table5321744015490"></a><a name="en-us_topic_0108275292_table5321744015490"></a><table cellpadding="4" cellspacing="0" summary="" id="dataartsstudio_01_0044__en-us_topic_0108275292_table5321744015490" frame="border" border="1" rules="all"><caption><b>Table 1 </b>PostgreSQL/SQLServer link parameters</caption><thead align="left"><tr id="dataartsstudio_01_0044__en-us_topic_0108275292_row185605615490"><th align="left" class="cellrowborder" valign="top" width="16.5%" id="mcps1.3.3.2.4.1.1"><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p3088488815490">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="61.550000000000004%" id="mcps1.3.3.2.4.1.2"><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p1864797615490">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="21.95%" id="mcps1.3.3.2.4.1.3"><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p12195902165556">Example Value</p>
</th>
</tr>
</thead>
<tbody><tr id="dataartsstudio_01_0044__en-us_topic_0108275292_row1489193511311"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p6539611111311">Name</p>
</td>
<td class="cellrowborder" valign="top" width="61.550000000000004%" headers="mcps1.3.3.2.4.1.2 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p6573133312010">Link name, which should be defined based on the data source type, so it is easier to remember what the link is for</p>
</td>
<td class="cellrowborder" valign="top" width="21.95%" headers="mcps1.3.3.2.4.1.3 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p22437462113249">sql_link</p>
</td>
</tr>
<tr id="dataartsstudio_01_0044__en-us_topic_0108275292_row23645714155554"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p36254680155554">Database Server</p>
</td>
<td class="cellrowborder" valign="top" width="61.550000000000004%" headers="mcps1.3.3.2.4.1.2 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p159175149315">IP address or domain name of the database to connect</p>
<p id="dataartsstudio_01_0044__en-us_topic_0108275292_p19166366171423">Click <span class="uicontrol" id="dataartsstudio_01_0044__en-us_topic_0108275292_uicontrol182791116154415"><b>Select</b></span> next to the text box to obtain the list of instances.</p>
</td>
<td class="cellrowborder" valign="top" width="21.95%" headers="mcps1.3.3.2.4.1.3 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p54006514165556">192.168.0.1</p>
</td>
</tr>
<tr id="dataartsstudio_01_0044__en-us_topic_0108275292_row35721234155558"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p7738819155558">Port</p>
</td>
<td class="cellrowborder" valign="top" width="61.550000000000004%" headers="mcps1.3.3.2.4.1.2 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p3924762417149">Port of the database to connect</p>
</td>
<td class="cellrowborder" valign="top" width="21.95%" headers="mcps1.3.3.2.4.1.3 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p155499111367">The port number varies depending on the database. Examples:</p>
<p id="dataartsstudio_01_0044__en-us_topic_0108275292_p44954710165556">Default port of SQL Server: <strong id="dataartsstudio_01_0044__en-us_topic_0108275292_b948385843719">1433</strong></p>
<p id="dataartsstudio_01_0044__en-us_topic_0108275292_p178971459711">Default port of PostgreSQL: <strong id="dataartsstudio_01_0044__en-us_topic_0108275292_b1251514112381">5432</strong></p>
</td>
</tr>
<tr id="dataartsstudio_01_0044__en-us_topic_0108275292_row58054787162632"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p4817321162632">Database Name</p>
</td>
<td class="cellrowborder" valign="top" width="61.550000000000004%" headers="mcps1.3.3.2.4.1.2 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p45683474171354">Name of the database to connect</p>
</td>
<td class="cellrowborder" valign="top" width="21.95%" headers="mcps1.3.3.2.4.1.3 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p22858665165556">dbname</p>
</td>
</tr>
<tr id="dataartsstudio_01_0044__en-us_topic_0108275292_row121116115490"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p3099525315490">Username</p>
</td>
<td class="cellrowborder" valign="top" width="61.550000000000004%" headers="mcps1.3.3.2.4.1.2 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p2758753215490">Username used for accessing the database This account must have the permissions required to read and write data tables and metadata.</p>
</td>
<td class="cellrowborder" valign="top" width="21.95%" headers="mcps1.3.3.2.4.1.3 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p14053644165556">cdm</p>
</td>
</tr>
<tr id="dataartsstudio_01_0044__en-us_topic_0108275292_row4576104015490"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p1565673415490">Password</p>
</td>
<td class="cellrowborder" valign="top" width="61.550000000000004%" headers="mcps1.3.3.2.4.1.2 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p6023590815490">Password of the user</p>
</td>
<td class="cellrowborder" valign="top" width="21.95%" headers="mcps1.3.3.2.4.1.3 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p44559445165556">-</p>
</td>
</tr>
<tr id="dataartsstudio_01_0044__en-us_topic_0108275292_row15561131344619"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p815422212356">Use Agent</p>
</td>
<td class="cellrowborder" valign="top" width="61.550000000000004%" headers="mcps1.3.3.2.4.1.2 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p1651731719256"><span id="dataartsstudio_01_0044__en-us_topic_0108275292_text79507435388">The agent function will be unavailable soon and does not need to be configured.</span></p>
</td>
<td class="cellrowborder" valign="top" width="21.95%" headers="mcps1.3.3.2.4.1.3 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p4141154315252">-</p>
</td>
</tr>
<tr id="dataartsstudio_01_0044__en-us_topic_0108275292_row19539167464"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p18412133418352">Agent</p>
</td>
<td class="cellrowborder" valign="top" width="61.550000000000004%" headers="mcps1.3.3.2.4.1.2 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p179409111394"><span id="dataartsstudio_01_0044__en-us_topic_0108275292_text1940816391">The agent function will be unavailable soon and does not need to be configured.</span></p>
</td>
<td class="cellrowborder" valign="top" width="21.95%" headers="mcps1.3.3.2.4.1.3 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p1570915504257">-</p>
</td>
</tr>
<tr id="dataartsstudio_01_0044__en-us_topic_0108275292_row8884162619471"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p17885182674711">Driver Class Name</p>
</td>
<td class="cellrowborder" valign="top" width="61.550000000000004%" headers="mcps1.3.3.2.4.1.2 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p4827321125813">Class name of the uploaded driver</p>
<p id="dataartsstudio_01_0044__en-us_topic_0108275292_p138851626184713">Select <strong id="dataartsstudio_01_0044__en-us_topic_0108275292_b940112541176">org.postgresql.Driver</strong> or <strong id="dataartsstudio_01_0044__en-us_topic_0108275292_b233171489">com.kingbase8.Driver</strong>.</p>
</td>
<td class="cellrowborder" valign="top" width="21.95%" headers="mcps1.3.3.2.4.1.3 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p788552614713">-</p>
</td>
</tr>
<tr id="dataartsstudio_01_0044__en-us_topic_0108275292_row5943122520489"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p237624617348">Reference Sign</p>
</td>
<td class="cellrowborder" valign="top" width="61.550000000000004%" headers="mcps1.3.3.2.4.1.2 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p5825824617348">(Optional) Delimiter between the names of the referenced tables or columns. For details, see the product documentation of the corresponding database.</p>
</td>
<td class="cellrowborder" valign="top" width="21.95%" headers="mcps1.3.3.2.4.1.3 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p2129746617348">"</p>
</td>
</tr>
<tr id="dataartsstudio_01_0044__en-us_topic_0108275292_row1983251620289"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p1483391622812">Driver Version</p>
</td>
<td class="cellrowborder" valign="top" width="61.550000000000004%" headers="mcps1.3.3.2.4.1.2 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p28330168284">Different types of relational databases adapt to different drivers. For details, see <a href="dataartsstudio_01_0132.html#dataartsstudio_01_0132__en-us_topic_0286032703_section631855342818">How Do I Obtain a Driver?</a></p>
</td>
<td class="cellrowborder" valign="top" width="21.95%" headers="mcps1.3.3.2.4.1.3 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p88332016112819">-</p>
</td>
</tr>
<tr id="dataartsstudio_01_0044__en-us_topic_0108275292_row2500625417340"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p1224068017340">Fetch Size</p>
</td>
<td class="cellrowborder" valign="top" width="61.550000000000004%" headers="mcps1.3.3.2.4.1.2 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p5197104317340">(Optional) Displayed when you click <strong id="dataartsstudio_01_0044__en-us_topic_0108275292_b1587534953816">Show Advanced Attributes</strong>.</p>
<p id="dataartsstudio_01_0044__en-us_topic_0108275292_p6431931117532">Number of rows obtained by each request. Set this parameter based on the data source and the job's data size. If the value is either too large or too small, the job may run for a long time.</p>
</td>
<td class="cellrowborder" valign="top" width="21.95%" headers="mcps1.3.3.2.4.1.3 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p4890496717340">1000</p>
</td>
</tr>
<tr id="dataartsstudio_01_0044__en-us_topic_0108275292_row1837555074812"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p1989555882818">Commit Size</p>
</td>
<td class="cellrowborder" valign="top" width="61.550000000000004%" headers="mcps1.3.3.2.4.1.2 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p1792313318298">(Optional) Displayed when you click <strong id="dataartsstudio_01_0044__en-us_topic_0108275292_b6203026665952">Show Advanced Attributes</strong>.</p>
<p id="dataartsstudio_01_0044__en-us_topic_0108275292_p13923635293">Number of records submitted each time. Set this parameter based on the destination and data size of the job. If the value is too large or too small, the job execution time may be affected.</p>
</td>
<td class="cellrowborder" valign="top" width="21.95%" headers="mcps1.3.3.2.4.1.3 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p18345554102810">10000</p>
</td>
</tr>
<tr id="dataartsstudio_01_0044__en-us_topic_0108275292_row8648150174913"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p46177674141711">SSL Encryption</p>
</td>
<td class="cellrowborder" valign="top" width="61.550000000000004%" headers="mcps1.3.3.2.4.1.2 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p1472085442710">Whether to connect to the database in SSL mode</p>
</td>
<td class="cellrowborder" valign="top" width="21.95%" headers="mcps1.3.3.2.4.1.3 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p42313489141711">Yes</p>
</td>
</tr>
<tr id="dataartsstudio_01_0044__en-us_topic_0108275292_row6497846117345"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p2876397817345">Link Attributes</p>
</td>
<td class="cellrowborder" valign="top" width="61.550000000000004%" headers="mcps1.3.3.2.4.1.2 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p4818086317345">(Optional) Click <span class="uicontrol" id="dataartsstudio_01_0044__en-us_topic_0108275292_uicontrol143481412163910"><b>Add</b></span> to add the JDBC connector attributes of multiple specified data sources. For details, see the JDBC connector document of the corresponding database.</p>
<div class="p" id="dataartsstudio_01_0044__en-us_topic_0108275292_p3176513115010">The following are some examples:<ul id="dataartsstudio_01_0044__en-us_topic_0108275292_ul1284813922912"><li id="dataartsstudio_01_0044__en-us_topic_0108275292_li67681857202918"><strong id="dataartsstudio_01_0044__en-us_topic_0108275292_b777456143615">connectTimeout=60</strong> and <strong id="dataartsstudio_01_0044__en-us_topic_0108275292_b99571823616">socketTimeout=300</strong>: When a large amount of data needs to be migrated or the entire table is retrieved using query statements, the migration fails due to connection timeout. In this case, you can customize the connection timeout interval (s) and socket timeout interval (s) to prevent failures caused by timeout.</li><li id="dataartsstudio_01_0044__en-us_topic_0108275292_li836212252319"><strong id="dataartsstudio_01_0044__en-us_topic_0108275292_b0417150361">useCursorFetch=false</strong>: By default, <strong id="dataartsstudio_01_0044__en-us_topic_0108275292_b732421619483">useCursorFetch</strong> is enabled, indicating that the JDBC connector communicates with relational databases using a binary protocol. Some third-party systems may have compatibility issues, causing migration time conversion errors. In this case, you can disable this function.</li><li id="dataartsstudio_01_0044__en-us_topic_0108275292_li9948037164220"><strong id="dataartsstudio_01_0044__en-us_topic_0108275292_b147221356437">trustServerCertificate=true</strong>: A PKIX error may be reported during the creation of a secure connection. You are advised to set this parameter to <strong id="dataartsstudio_01_0044__en-us_topic_0108275292_b7836144363212">true</strong>.</li><li id="dataartsstudio_01_0044__en-us_topic_0108275292_li1844193243612"><strong id="dataartsstudio_01_0044__en-us_topic_0108275292_b15258154317367">sslmode=require</strong>: The link to PostgreSQL may fail when SSL authentication is enabled. Set this parameter to <strong id="dataartsstudio_01_0044__en-us_topic_0108275292_b951815332219">require</strong>.</li></ul>
</div>
</td>
<td class="cellrowborder" valign="top" width="21.95%" headers="mcps1.3.3.2.4.1.3 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p1033584517345">sslmode=require</p>
</td>
</tr>
<tr id="dataartsstudio_01_0044__en-us_topic_0108275292_row1582665634819"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p1513318543325">Link Secret Attributes</p>
</td>
<td class="cellrowborder" valign="top" width="61.550000000000004%" headers="mcps1.3.3.2.4.1.2 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p17107122911366">(Optional) Displayed when you click <strong id="dataartsstudio_01_0044__en-us_topic_0108275292_b12345115718813">Show Advanced Attributes</strong>.</p>
<p id="dataartsstudio_01_0044__en-us_topic_0108275292_p11321154183220">Custom secret attributes of the link</p>
</td>
<td class="cellrowborder" valign="top" width="21.95%" headers="mcps1.3.3.2.4.1.3 "><p id="dataartsstudio_01_0044__en-us_topic_0108275292_p927481593614">sk=09fUgD5WOF1L6f</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dataartsstudio_01_0157.html">Configuring Link Parameters</a></div>
</div>
</div>