Files
doc-exports/docs/dataartsstudio/umn/dataartsstudio_01_1211.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

156 lines
21 KiB
HTML

<a name="dataartsstudio_01_1211"></a><a name="dataartsstudio_01_1211"></a>
<h1 class="topictitle1">RDS for MySQL/MySQL Database Link Parameters</h1>
<div id="body8662426"><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_p2116754152029"><a href="#dataartsstudio_01_1211__en-us_topic_0000001265868438_table5321744015490">Table 1</a> lists the parameters for a link to a MySQL database.</p>
<div class="note" id="dataartsstudio_01_1211__en-us_topic_0000001265868438_note8867140110"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_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_1211__en-us_topic_0000001265868438_table5321744015490"></a><a name="en-us_topic_0000001265868438_table5321744015490"></a><table cellpadding="4" cellspacing="0" summary="" id="dataartsstudio_01_1211__en-us_topic_0000001265868438_table5321744015490" frame="border" border="1" rules="all"><caption><b>Table 1 </b>MySQL database link parameters</caption><thead align="left"><tr id="dataartsstudio_01_1211__en-us_topic_0000001265868438_row185605615490"><th align="left" class="cellrowborder" valign="top" width="16.5%" id="mcps1.3.3.2.4.1.1"><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_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_1211__en-us_topic_0000001265868438_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_1211__en-us_topic_0000001265868438_p12195902165556">Example Value</p>
</th>
</tr>
</thead>
<tbody><tr id="dataartsstudio_01_1211__en-us_topic_0000001265868438_row1489193511311"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_p6539611111311">Name</p>
</td>
<td class="cellrowborder" valign="top" width="61.550000000000004%" headers="mcps1.3.3.2.4.1.2 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_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_1211__en-us_topic_0000001265868438_p22437462113249">mysql_link</p>
</td>
</tr>
<tr id="dataartsstudio_01_1211__en-us_topic_0000001265868438_row23645714155554"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_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_1211__en-us_topic_0000001265868438_p159175149315">IP address or domain name of the database to connect</p>
<p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_p19166366171423">Click <span class="uicontrol" id="dataartsstudio_01_1211__en-us_topic_0000001265868438_uicontrol1624123413177"><b>Select</b></span> next to the text box and select a MySQL DB instance in the displayed dialog box.</p>
</td>
<td class="cellrowborder" valign="top" width="21.95%" headers="mcps1.3.3.2.4.1.3 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_p54006514165556">192.168.0.1</p>
</td>
</tr>
<tr id="dataartsstudio_01_1211__en-us_topic_0000001265868438_row35721234155558"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_p7738819155558">Port</p>
</td>
<td class="cellrowborder" valign="top" width="61.550000000000004%" headers="mcps1.3.3.2.4.1.2 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_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_1211__en-us_topic_0000001265868438_p178971459711">3306</p>
</td>
</tr>
<tr id="dataartsstudio_01_1211__en-us_topic_0000001265868438_row58054787162632"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_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_1211__en-us_topic_0000001265868438_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_1211__en-us_topic_0000001265868438_p22858665165556">dbname</p>
</td>
</tr>
<tr id="dataartsstudio_01_1211__en-us_topic_0000001265868438_row121116115490"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_p3099525315490">Username</p>
</td>
<td class="cellrowborder" valign="top" width="61.550000000000004%" headers="mcps1.3.3.2.4.1.2 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_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_1211__en-us_topic_0000001265868438_p14053644165556">cdm</p>
</td>
</tr>
<tr id="dataartsstudio_01_1211__en-us_topic_0000001265868438_row4576104015490"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_p1565673415490">Password</p>
</td>
<td class="cellrowborder" valign="top" width="61.550000000000004%" headers="mcps1.3.3.2.4.1.2 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_p3952172933412">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_1211__en-us_topic_0000001265868438_p44559445165556">-</p>
</td>
</tr>
<tr id="dataartsstudio_01_1211__en-us_topic_0000001265868438_row1439712166267"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_p18131153152229">Use Local API</p>
</td>
<td class="cellrowborder" valign="top" width="61.550000000000004%" headers="mcps1.3.3.2.4.1.2 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_p59337251152229">(Optional) Whether to use the local API of the database for acceleration.</p>
<p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_p7644611844">When you create a MySQL link, CDM automatically enables the <strong id="dataartsstudio_01_1211__en-us_topic_0000001265868438_b10807173215567">local_infile</strong> system variable of the MySQL database to enable the LOAD DATA function, which accelerates data import to the MySQL database. If this parameter is enabled, the date type that does not meet the format requirements will be stored as 0000-00-00. For details, visit the official MySQL website.</p>
<p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_p185441332104613">If CDM fails to enable this function, contact the database administrator to enable the <strong id="dataartsstudio_01_1211__en-us_topic_0000001265868438_b07888546188">local_infile</strong> system variable. Alternatively, set <strong id="dataartsstudio_01_1211__en-us_topic_0000001265868438_b1778865441812">Use Local API</strong> to <strong id="dataartsstudio_01_1211__en-us_topic_0000001265868438_b14788175413185">No</strong> to disable API acceleration.</p>
<p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_p55566957111936">If data is imported to RDS for MySQL, the LOAD DATA function is disabled by default. In such a case, you need to modify the parameter group of the MySQL instance and set <span class="parmname" id="dataartsstudio_01_1211__en-us_topic_0000001265868438_parmname39208007419118"><b>local_infile</b></span> to <span class="parmvalue" id="dataartsstudio_01_1211__en-us_topic_0000001265868438_parmvalue1217021123103851"><b>ON</b></span> to enable the LOAD DATA function.</p>
<div class="note" id="dataartsstudio_01_1211__en-us_topic_0000001265868438_note4673912112650"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_p42065216112650">If <span class="parmname" id="dataartsstudio_01_1211__en-us_topic_0000001265868438_parmname5838373112711"><b>local_infile</b></span> on RDS is uneditable, it is the default parameter group. You need to create a parameter group, modify its values, and apply it to the RDS for MySQL instance. For details, see the <i><cite id="dataartsstudio_01_1211__en-us_topic_0000001265868438_cite28577112922">Relational Database Service User Guide</cite></i>.</p>
</div></div>
</td>
<td class="cellrowborder" valign="top" width="21.95%" headers="mcps1.3.3.2.4.1.3 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_p41588042152229">Yes</p>
</td>
</tr>
<tr id="dataartsstudio_01_1211__en-us_topic_0000001265868438_row15561131344619"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_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_1211__en-us_topic_0000001265868438_p1651731719256"><span id="dataartsstudio_01_1211__en-us_topic_0000001265868438_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_1211__en-us_topic_0000001265868438_p4141154315252">-</p>
</td>
</tr>
<tr id="dataartsstudio_01_1211__en-us_topic_0000001265868438_row19539167464"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_p18412133418352">Agent</p>
</td>
<td class="cellrowborder" valign="top" width="61.550000000000004%" headers="mcps1.3.3.2.4.1.2 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_p8181757113917"><span id="dataartsstudio_01_1211__en-us_topic_0000001265868438_text1218115773915">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_1211__en-us_topic_0000001265868438_p1241253413354">-</p>
</td>
</tr>
<tr id="dataartsstudio_01_1211__en-us_topic_0000001265868438_row19647185583312"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_p13647205511335">local_infile Character Set</p>
</td>
<td class="cellrowborder" valign="top" width="61.550000000000004%" headers="mcps1.3.3.2.4.1.2 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_p166475554331">When using local_infile to import data to MySQL, you can configure the encoding format.</p>
</td>
<td class="cellrowborder" valign="top" width="21.95%" headers="mcps1.3.3.2.4.1.3 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_p564805513333">utf8</p>
</td>
</tr>
<tr id="dataartsstudio_01_1211__en-us_topic_0000001265868438_row1983251620289"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_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_1211__en-us_topic_0000001265868438_p28330168284">Select a driver version that adapts to the database type.</p>
</td>
<td class="cellrowborder" valign="top" width="21.95%" headers="mcps1.3.3.2.4.1.3 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_p88332016112819">-</p>
</td>
</tr>
<tr id="dataartsstudio_01_1211__en-us_topic_0000001265868438_row2500625417340"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_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_1211__en-us_topic_0000001265868438_p5197104317340">(Optional) Displayed when you click <strong id="dataartsstudio_01_1211__en-us_topic_0000001265868438_b58531203196">Show Advanced Attributes</strong>.</p>
<p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_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_1211__en-us_topic_0000001265868438_p4890496717340">1000</p>
</td>
</tr>
<tr id="dataartsstudio_01_1211__en-us_topic_0000001265868438_row1034405462816"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_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_1211__en-us_topic_0000001265868438_p1792313318298">(Optional) Displayed when you click <strong id="dataartsstudio_01_1211__en-us_topic_0000001265868438_b19804941141912">Show Advanced Attributes</strong>.</p>
<p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_p13923635293">Number of records submitted each time. Set this parameter based on the data destination 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_1211__en-us_topic_0000001265868438_p18345554102810">10000</p>
</td>
</tr>
<tr id="dataartsstudio_01_1211__en-us_topic_0000001265868438_row23768220141711"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_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_1211__en-us_topic_0000001265868438_p1472085442710">(Optional) Whether to connect to the database using SSL. This parameter is available for a MySQL link.</p>
</td>
<td class="cellrowborder" valign="top" width="21.95%" headers="mcps1.3.3.2.4.1.3 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_p42313489141711">Yes</p>
</td>
</tr>
<tr id="dataartsstudio_01_1211__en-us_topic_0000001265868438_row6497846117345"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_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_1211__en-us_topic_0000001265868438_p4818086317345">(Optional) Click <span class="uicontrol" id="dataartsstudio_01_1211__en-us_topic_0000001265868438_uicontrol247215115204"><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_1211__en-us_topic_0000001265868438_p151027540282">The following are some examples:<ul id="dataartsstudio_01_1211__en-us_topic_0000001265868438_ul1284813922912"><li id="dataartsstudio_01_1211__en-us_topic_0000001265868438_li67681857202918"><strong id="dataartsstudio_01_1211__en-us_topic_0000001265868438_b1549475325217">connectTimeout=600000</strong> and <strong id="dataartsstudio_01_1211__en-us_topic_0000001265868438_b1249565319524">socketTimeout=300000</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 (ms) and socket timeout interval (ms) to prevent failures caused by timeout.</li><li id="dataartsstudio_01_1211__en-us_topic_0000001265868438_li14273135114328"><strong id="dataartsstudio_01_1211__en-us_topic_0000001265868438_b13505165113522">tinyInt1isBit=true</strong> (default): If the length of tinyInt is 1, the value is converted to a Boolean value. <strong id="dataartsstudio_01_1211__en-us_topic_0000001265868438_b2999557105214">tinyInt1isBit=false</strong>: The value is converted to an integer.<p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_p2265191419528">If data fails to be written because true or false is read from the source, set this parameter to <strong id="dataartsstudio_01_1211__en-us_topic_0000001265868438_b4156141702811">false</strong> to avoid migration errors. For details, see <a href="https://dev.mysql.com/doc/connector-j/en/connector-j-reference-type-conversions.html" target="_blank" rel="noopener noreferrer">MySQL Documentation</a>.</p>
</li><li id="dataartsstudio_01_1211__en-us_topic_0000001265868438_li836212252319"><strong id="dataartsstudio_01_1211__en-us_topic_0000001265868438_b4452645185313">useCursorFetch=false</strong>: By default, <strong id="dataartsstudio_01_1211__en-us_topic_0000001265868438_b5457134516534">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. Open-source MySQL databases support the <strong id="dataartsstudio_01_1211__en-us_topic_0000001265868438_b1137447145313">useCursorFetch</strong> parameter, and you do not need to set this parameter.</li><li id="dataartsstudio_01_1211__en-us_topic_0000001265868438_li88487982918"><strong id="dataartsstudio_01_1211__en-us_topic_0000001265868438_b12769132368">allowPublicKeyRetrieval=true</strong>: By default, public key retrieval is disabled for MySQL databases. If TLS is unavailable and an RSA public key is used for encryption, connection to an MySQL database may fail. In this case, you can enable public key retrieval to avoid connection failures.</li><li id="dataartsstudio_01_1211__en-us_topic_0000001265868438_li181271019321"><strong id="dataartsstudio_01_1211__en-us_topic_0000001265868438_b2357131781114">useSSL=false</strong>: Enable SSL encryption using this attribute when the CDM cluster version is 2.10.0.300 and the MySQL version is later than 5.7.43.</li></ul>
</div>
</td>
<td class="cellrowborder" valign="top" width="21.95%" headers="mcps1.3.3.2.4.1.3 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_p1033584517345">sslmode=require</p>
</td>
</tr>
<tr id="dataartsstudio_01_1211__en-us_topic_0000001265868438_row5885315517348"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_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_1211__en-us_topic_0000001265868438_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_1211__en-us_topic_0000001265868438_p2129746617348">`</p>
</td>
</tr>
<tr id="dataartsstudio_01_1211__en-us_topic_0000001265868438_row252692516350"><td class="cellrowborder" valign="top" width="16.5%" headers="mcps1.3.3.2.4.1.1 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_p95261525113519">Batch Size</p>
</td>
<td class="cellrowborder" valign="top" width="61.550000000000004%" headers="mcps1.3.3.2.4.1.2 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_p185274254354">Number of rows written each time. It should be less than Commit Size. When the number of rows written reaches the value of Commit Size, the rows will be committed to the database.</p>
</td>
<td class="cellrowborder" valign="top" width="21.95%" headers="mcps1.3.3.2.4.1.3 "><p id="dataartsstudio_01_1211__en-us_topic_0000001265868438_p1752772510357">100</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>