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

46 lines
22 KiB
HTML

<a name="dataartsstudio_01_0091"></a><a name="dataartsstudio_01_0091"></a>
<h1 class="topictitle1">Migrating Data from Oracle to CSS</h1>
<div id="body8662426"><div class="section" id="dataartsstudio_01_0091__en-us_topic_0108275437_section21020958143223"><h4 class="sectiontitle">Scenario</h4><p id="dataartsstudio_01_0091__en-us_topic_0108275437_p4504939393411">Cloud Search Service provides users with structured and unstructured data search, statistics, and report capabilities. This section describes how to use CDM to migrate data from the Oracle database to Cloud Search Service. The procedure is as follows:</p>
<ol id="dataartsstudio_01_0091__en-us_topic_0108275437_ol6383336515"><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li93832315512"><a href="#dataartsstudio_01_0091__en-us_topic_0108275437_section2178135115010">Creating a CDM Cluster and Binding an EIP to the Cluster</a></li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li122097151386"><a href="#dataartsstudio_01_0091__en-us_topic_0108275437_section13928112795019">Creating a Cloud Search Service Link</a></li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li1416216222816"><a href="#dataartsstudio_01_0091__en-us_topic_0108275437_section1667801135017">Creating an Oracle Link</a></li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li69277289815"><a href="#dataartsstudio_01_0091__en-us_topic_0108275437_section5711134141215">Creating a Migration Job</a></li></ol>
</div>
<div class="section" id="dataartsstudio_01_0091__en-us_topic_0108275437_section5787168294234"><h4 class="sectiontitle">Prerequisites</h4><ul id="dataartsstudio_01_0091__en-us_topic_0108275437_ul56609460102758"><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li44641429102758">You have subscribed to Cloud Search Service and obtained the IP address and port number of the Cloud Search Service cluster.</li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li1047318349244">You have obtained the IP address, name, username, and password of the Oracle database.</li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li6653319277">If the Oracle database is deployed on an on-premises data center or a third-party cloud, ensure that an IP address that can be accessed from the public network has been configured for the Oracle database, or the VPN or Direct Connect between the on-premises data center and has been established.</li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li178721321413">You have uploaded the Oracle database driver on the <span class="menucascade" id="dataartsstudio_01_0091__en-us_topic_0108275437_en-us_topic_0286032703_menucascade177204413614"><b><span class="uicontrol" id="dataartsstudio_01_0091__en-us_topic_0108275437_en-us_topic_0286032703_uicontrol17264483610">Job Management</span></b> &gt; <b><span class="uicontrol" id="dataartsstudio_01_0091__en-us_topic_0108275437_en-us_topic_0286032703_uicontrol1072134453617">Links</span></b> &gt; <b><span class="uicontrol" id="dataartsstudio_01_0091__en-us_topic_0108275437_en-us_topic_0286032703_uicontrol12728448364">Driver Management</span></b></span> page.</li></ul>
</div>
<div class="section" id="dataartsstudio_01_0091__en-us_topic_0108275437_section2178135115010"><a name="dataartsstudio_01_0091__en-us_topic_0108275437_section2178135115010"></a><a name="en-us_topic_0108275437_section2178135115010"></a><h4 class="sectiontitle">Creating a CDM Cluster and Binding an EIP to the Cluster</h4><ol id="dataartsstudio_01_0091__en-us_topic_0108275437_ol617820350509"><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li12781647122612"><span id="dataartsstudio_01_0091__en-us_topic_0108275437_p342142211225">Create a CDM cluster.</span><p><div class="p" id="dataartsstudio_01_0091__en-us_topic_0108275437_p162411448162610">The key configurations are as follows:<ul id="dataartsstudio_01_0091__en-us_topic_0108275437_ul619314352509"><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li19761175453810">The flavor of the CDM cluster is selected based on the amount of data to be migrated. Generally, cdm.medium meets the requirements for most migration scenarios.</li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li119313352501">The CDM and Cloud Search Service clusters must be in the same VPC. In addition, it is recommended that the CDM cluster be in the same subnet and security group as the Cloud Search Service cluster.</li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li419323520504">If the same subnet and security group cannot be used for security purposes, ensure that a security group rule has been configured to allow the CDM cluster to access the Cloud Search Service cluster.</li></ul>
</div>
</p></li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li419363515504"><span>After the CDM cluster is created, on the <strong id="dataartsstudio_01_0091__en-us_topic_0108275437_b18829192835913">Cluster Management</strong> page, click <span class="uicontrol" id="dataartsstudio_01_0091__en-us_topic_0108275437_uicontrol182932814599"><b>Bind EIP</b></span> in the <strong id="dataartsstudio_01_0091__en-us_topic_0108275437_b7829428175917">Operation</strong> column to bind an EIP to the cluster. The CDM cluster uses the EIP to access the Oracle data source.</span><p><div class="note" id="dataartsstudio_01_0091__en-us_topic_0108275437_note24642513383"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="dataartsstudio_01_0091__en-us_topic_0108275471_p1693084519332">If SSL encryption is configured for the access channel of a local data source, CDM cannot connect to the data source using the EIP.</p>
</div></div>
</p></li></ol>
</div>
<div class="section" id="dataartsstudio_01_0091__en-us_topic_0108275437_section13928112795019"><a name="dataartsstudio_01_0091__en-us_topic_0108275437_section13928112795019"></a><a name="en-us_topic_0108275437_section13928112795019"></a><h4 class="sectiontitle">Creating a Cloud Search Service Link</h4><ol id="dataartsstudio_01_0091__en-us_topic_0108275437_ol2092852715016"><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li135396271350"><span>Click <span class="uicontrol" id="dataartsstudio_01_0091__en-us_topic_0108275298_uicontrol19806194174318"><b>Job Management</b></span> in the <strong id="dataartsstudio_01_0091__en-us_topic_0108275298_b2806249435">Operation</strong> column of the CDM cluster. On the displayed page, click the <strong id="dataartsstudio_01_0091__en-us_topic_0108275298_b480613424310">Links</strong> tab and then <strong id="dataartsstudio_01_0091__en-us_topic_0108275298_b10806184174313">Create Link</strong>. The <strong id="dataartsstudio_01_0091__en-us_topic_0108275298_b16807154184319">Select Connector</strong> page is displayed.</span></li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li3943142717504"><span>Select <span class="uicontrol" id="dataartsstudio_01_0091__en-us_topic_0108275437_uicontrol11292928261"><b>Cloud Search Service</b></span> and click <span class="uicontrol" id="dataartsstudio_01_0091__en-us_topic_0108275437_uicontrol59955341361"><b>Next</b></span>. On the page that is displayed, configure the CSS link parameters.</span><p><ul id="dataartsstudio_01_0091__en-us_topic_0108275437_ul1094362745018"><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li79437273507"><strong id="dataartsstudio_01_0091__en-us_topic_0108275437_b166221591570">Name</strong>: Enter a custom link name, for example, <span class="parmvalue" id="dataartsstudio_01_0091__en-us_topic_0108275437_parmvalue10622893716"><b>csslink</b></span>.</li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li18338133301920"><strong id="dataartsstudio_01_0091__en-us_topic_0108275437_b2893141015591">Elasticsearch Server List</strong>: Enter the IP address and port number of the Cloud Search Service cluster (cluster later than 5.<em id="dataartsstudio_01_0091__en-us_topic_0108275437_i1782675814106">x</em>). The format is <em id="dataartsstudio_01_0091__en-us_topic_0108275437_i1189315105595">ip:port</em>. Use semicolons to separate multiple addresses. For example, <strong id="dataartsstudio_01_0091__en-us_topic_0108275437_b389312105592">192.168.0.1:9200;192.168.0.2:9200</strong>.</li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li8960162715012"><strong id="dataartsstudio_01_0091__en-us_topic_0108275437_b845025383">Username</strong> and <strong id="dataartsstudio_01_0091__en-us_topic_0108275437_b3139149188">Password</strong>: Enter the username and password used for logging in to the Cloud Search Service cluster. The user must have the read and write permissions on the database.</li></ul>
</p></li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li11960112710508"><span>Click <span class="uicontrol" id="dataartsstudio_01_0091__en-us_topic_0108275437_uicontrol228245913106"><b>Save</b></span>. The <span class="uicontrol" id="dataartsstudio_01_0091__en-us_topic_0108275437_uicontrol02821659201014"><b>Link Management</b></span> page is displayed.</span></li></ol>
</div>
<div class="section" id="dataartsstudio_01_0091__en-us_topic_0108275437_section1667801135017"><a name="dataartsstudio_01_0091__en-us_topic_0108275437_section1667801135017"></a><a name="en-us_topic_0108275437_section1667801135017"></a><h4 class="sectiontitle">Creating an Oracle Link</h4><ol id="dataartsstudio_01_0091__en-us_topic_0108275437_ol9959102018507"><li id="dataartsstudio_01_0091__en-us_topic_0108275437_en-us_topic_0108275437_li135396271350"><span>Click <span class="uicontrol" id="dataartsstudio_01_0091__uicontrol3698028162718"><b>Job Management</b></span> in the <strong id="dataartsstudio_01_0091__b8698132832713">Operation</strong> column of the CDM cluster. On the displayed page, click the <strong id="dataartsstudio_01_0091__b15698182817273">Links</strong> tab and then <strong id="dataartsstudio_01_0091__b17698128122713">Create Link</strong>. The <strong id="dataartsstudio_01_0091__b2069820286274">Select Connector</strong> page is displayed.</span></li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li099012201501"><span>Select <span class="uicontrol" id="dataartsstudio_01_0091__en-us_topic_0108275437_uicontrol1249631517494"><b>Oracle</b></span> and click <span class="uicontrol" id="dataartsstudio_01_0091__en-us_topic_0108275437_uicontrol1350212152491"><b>Next</b></span> to configure parameters for the Oracle link.</span><p><ul id="dataartsstudio_01_0091__en-us_topic_0108275437_ul499092035010"><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li107172116506"><strong id="dataartsstudio_01_0091__en-us_topic_0108275437_b877953961714">Name</strong>: Enter a custom link name, for example, <span class="uicontrol" id="dataartsstudio_01_0091__en-us_topic_0108275437_uicontrol137294911172"><b>oracle_link</b></span>.</li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li107142111508"><strong id="dataartsstudio_01_0091__en-us_topic_0108275437_b84235270615457">Database Server</strong> and <strong id="dataartsstudio_01_0091__en-us_topic_0108275437_b8423527061550">Port</strong>: Enter the address and port number of the Oracle server.</li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li177821185018"><strong id="dataartsstudio_01_0091__en-us_topic_0108275437_b84235270615927">Database Name</strong>: Enter the name of the Oracle database whose data is to be exported.</li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li1075213506"><strong id="dataartsstudio_01_0091__en-us_topic_0108275437_b842352706151031">Username</strong> and <strong id="dataartsstudio_01_0091__en-us_topic_0108275437_b842352706151033">Password</strong>: Enter the username and password used for logging in to the Oracle database. The user must have the permission to read the Oracle metadata.</li></ul>
</p></li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li12701164313598"><span>Click <span class="uicontrol" id="dataartsstudio_01_0091__en-us_topic_0108275437_uicontrol10981171481818"><b>Save</b></span>. The <span class="uicontrol" id="dataartsstudio_01_0091__en-us_topic_0108275437_uicontrol698101491818"><b>Link Management</b></span> page is displayed.</span></li></ol>
</div>
<div class="section" id="dataartsstudio_01_0091__en-us_topic_0108275437_section5711134141215"><a name="dataartsstudio_01_0091__en-us_topic_0108275437_section5711134141215"></a><a name="en-us_topic_0108275437_section5711134141215"></a><h4 class="sectiontitle">Creating a Migration Job</h4><ol id="dataartsstudio_01_0091__en-us_topic_0108275437_ol139311427141216"><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li12211241111211"><span>Choose <span class="menucascade" id="dataartsstudio_01_0091__en-us_topic_0108275437_menucascade16515161831811"><b><span class="uicontrol" id="dataartsstudio_01_0091__en-us_topic_0108275437_uicontrol1949861813184">Table/File Migration</span></b> &gt; <b><span class="uicontrol" id="dataartsstudio_01_0091__en-us_topic_0108275437_uicontrol949881811183">Create Job</span></b></span> to create a job for exporting data from the Oracle database to Cloud Search Service.</span><p><div class="fignone" id="dataartsstudio_01_0091__en-us_topic_0108275437_fig1121115411121"><span class="figcap"><b>Figure 1 </b>Creating a job for migrating data from Oracle to Cloud Search Service</span><br><span><img id="dataartsstudio_01_0091__en-us_topic_0108275437_image98978431177" src="en-us_image_0000002269114889.png" title="Click to enlarge" class="imgResize"></span></div>
<ul id="dataartsstudio_01_0091__en-us_topic_0108275437_ul11211104191217"><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li1221164117123"><strong id="dataartsstudio_01_0091__en-us_topic_0108275437_b97197583191">Job Name</strong>: Enter a unique name.</li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li16211144119127"><strong id="dataartsstudio_01_0091__en-us_topic_0108275437_b950148162215">Source Job Configuration</strong><ul id="dataartsstudio_01_0091__en-us_topic_0108275437_ul32111741141219"><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li42111641101218"><strong id="dataartsstudio_01_0091__b1179694232719">Source Link Name</strong>: Select the <span class="uicontrol" id="dataartsstudio_01_0091__uicontrol17797104214273"><b>oracle_link</b></span> link created in <a href="#dataartsstudio_01_0091__en-us_topic_0108275437_section1667801135017">Creating an Oracle Link</a>.</li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li2228134117121"><strong id="dataartsstudio_01_0091__en-us_topic_0108275437_b12457173117225">Schema/Tablespace</strong>: Enter the name of the database whose data is to be migrated.</li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li1522844110129"><strong id="dataartsstudio_01_0091__en-us_topic_0108275437_b768043913217">Table Name</strong>: Enter the name of the table to be migrated.</li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li62282414121">Retain the default values of the optional parameters in <strong id="dataartsstudio_01_0091__en-us_topic_0108275437_b911422195219">Show Advanced Attributes</strong>.</li></ul>
</li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li18228144118121"><strong id="dataartsstudio_01_0091__en-us_topic_0108275437_b11504114962211">Destination Job Configuration</strong><ul id="dataartsstudio_01_0091__en-us_topic_0108275437_ul3228104151220"><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li3228144112129"><strong id="dataartsstudio_01_0091__b1321694552714">Destination Link Name</strong>: Select the <span class="parmvalue" id="dataartsstudio_01_0091__parmvalue162171045152710"><b>csslink</b></span> link created in <a href="#dataartsstudio_01_0091__en-us_topic_0108275437_section13928112795019">Creating a Cloud Search Service Link</a>.</li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li152281841191217"><strong id="dataartsstudio_01_0091__en-us_topic_0108275437_b1522852013432">Index</strong>: Select the Elasticsearch index of the data to be written. You can also enter a new index. CDM automatically creates the index on Cloud Search Service.</li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li183264324104"><strong id="dataartsstudio_01_0091__en-us_topic_0108275437_b7396811255">Type</strong>: Select the Elasticsearch type of the data to be written. You can enter a new type. CDM automatically creates a type at the migration destination.</li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li105251435958">Retain the default values of the optional parameters in <strong id="dataartsstudio_01_0091__en-us_topic_0108275437_b11557182955216">Show Advanced Attributes</strong>.</li></ul>
</li></ul>
</p></li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li59151048111210"><span>Click <span class="uicontrol" id="dataartsstudio_01_0091__uicontrol20919748142711"><b>Next</b></span>. The <strong id="dataartsstudio_01_0091__b5919148122717">Map Field</strong> page is displayed. CDM automatically matches the source and destination fields, as shown in <a href="#dataartsstudio_01_0091__en-us_topic_0108275437_fig68696231445">Figure 2</a>.</span><p><ul id="dataartsstudio_01_0091__en-us_topic_0108275437_ul2086033675113"><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li286063610513">If the field mapping is incorrect, you can drag the fields to adjust the mapping.</li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li13691739219">If the type is automatically created at the migration destination, you need to configure the type and name of each field.</li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li557993195213">CDM supports field conversion during the migration. </li></ul>
<div class="fignone" id="dataartsstudio_01_0091__en-us_topic_0108275437_fig68696231445"><a name="dataartsstudio_01_0091__en-us_topic_0108275437_fig68696231445"></a><a name="en-us_topic_0108275437_fig68696231445"></a><span class="figcap"><b>Figure 2 </b>Field mapping of Cloud Search Service</span><br><span><img id="dataartsstudio_01_0091__en-us_topic_0108275437_image8869122344416" src="en-us_image_0000002269114877.png" title="Click to enlarge" class="imgResize"></span></div>
</p></li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li47753211373"><span>Click <span class="uicontrol" id="dataartsstudio_01_0091__en-us_topic_0108275315_uicontrol6471103355516"><b>Next</b></span> and set task parameters. Generally, retain the default values of all parameters.</span><p><div class="p" id="dataartsstudio_01_0091__en-us_topic_0108275315_p574914560220">In this step, you can configure the following optional functions:<ul id="dataartsstudio_01_0091__en-us_topic_0108275315_ul65067533203334"><li id="dataartsstudio_01_0091__en-us_topic_0108275315_li37800576203334"><strong id="dataartsstudio_01_0091__en-us_topic_0108275315_b95381451163716">Retry If Failed</strong>: Determine whether to automatically retry the job if it fails. Retain the default value <span class="parmvalue" id="dataartsstudio_01_0091__en-us_topic_0108275315_parmvalue137031560212"><b>Never</b></span>.</li><li id="dataartsstudio_01_0091__en-us_topic_0108275315_li158210387356"><strong id="dataartsstudio_01_0091__en-us_topic_0108275315_b117553917428">Group</strong>: Select the group to which the job belongs. The default group is <span class="parmvalue" id="dataartsstudio_01_0091__en-us_topic_0108275315_parmvalue1229163714324"><b>DEFAULT</b></span>. On the <span class="wintitle" id="dataartsstudio_01_0091__en-us_topic_0108275315_wintitle161211277446"><b>Job Management</b></span> page, jobs can be displayed, started, or exported by group.</li><li id="dataartsstudio_01_0091__en-us_topic_0108275315_li33236331203339"><strong id="dataartsstudio_01_0091__en-us_topic_0108275315_b447277982112428">Schedule Execution</strong>: Determine whether to automatically execute the job at a scheduled time. Retain the default value <span class="parmvalue" id="dataartsstudio_01_0091__en-us_topic_0108275315_parmvalue12389152254610"><b>No</b></span> in this example.</li><li id="dataartsstudio_01_0091__en-us_topic_0108275315_li65386286258"><strong id="dataartsstudio_01_0091__en-us_topic_0108275315_b0990135545110">Concurrent Extractors</strong>: Enter the number of concurrent extractors. An appropriate value improves migration efficiency. Retain the default value <span class="parmvalue" id="dataartsstudio_01_0091__en-us_topic_0108275315_parmvalue1939217251214"><b>1</b></span>.</li><li id="dataartsstudio_01_0091__en-us_topic_0108275315_li1396265172616"><strong id="dataartsstudio_01_0091__en-us_topic_0108275315_b115901914176">Write Dirty Data</strong>: Specify this parameter if data that fails to be processed or filtered out during job execution needs to be written to OBS for future viewing. Before writing dirty data, create an OBS link on the CDM console. Retain the default value <span class="parmvalue" id="dataartsstudio_01_0091__en-us_topic_0108275315_parmvalue1890595274511"><b>No</b></span> so that dirty data is not recorded.</li></ul>
<div class="fignone" id="dataartsstudio_01_0091__en-us_topic_0108275315_fig81141229205912"><span class="figcap"><b>Figure 3 </b>Configuring the task</span><br><span><img id="dataartsstudio_01_0091__en-us_topic_0108275315_image1793431113212" src="en-us_image_0000002269114701.png" title="Click to enlarge" class="imgResize"></span></div>
</div>
</p></li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li1577510223710"><span>Click <span class="uicontrol" id="dataartsstudio_01_0091__en-us_topic_0108275326_uicontrol1362446142110"><b>Save and Run</b></span>. The <strong id="dataartsstudio_01_0091__en-us_topic_0108275326_b867281052113">Job Management</strong> page is displayed, on which you can view the job execution progress and result.</span></li><li id="dataartsstudio_01_0091__en-us_topic_0108275437_li1189115352456"><span>After the job is successfully executed, in the <strong id="dataartsstudio_01_0091__en-us_topic_0108275326_b78588166211">Operation</strong> column of the job, click <span class="uicontrol" id="dataartsstudio_01_0091__en-us_topic_0108275326_uicontrol6858616102110"><b>Historical Record</b></span> to view the job's historical execution records and read/write statistics.</span><p><p id="dataartsstudio_01_0091__en-us_topic_0108275326_p1891735144518">On the <strong id="dataartsstudio_01_0091__en-us_topic_0108275326_b1470242882110">Historical Record</strong> page, click <span class="uicontrol" id="dataartsstudio_01_0091__en-us_topic_0108275326_uicontrol147021628182113"><b>Log</b></span> to view the job logs.</p>
</p></li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dataartsstudio_01_0086.html">Tutorials</a></div>
</div>
</div>
<script language="JavaScript">
<!--
initImageViewer('.imgResize');
var msg_imageMax = "view original image";
var msg_imageClose = "close";
//--></script>