doc-exports/docs/dataartsstudio/umn/dataartsstudio_03_0101.html

<a name="dataartsstudio_03_0101"></a><a name="dataartsstudio_03_0101"></a>

<h1 class="topictitle1">How Do I Use Java to Invoke CDM RESTful APIs to Create Data Migration Jobs?</h1>
<div id="body8662426"><p id="dataartsstudio_03_0101__en-us_topic_0108275414_p8060118">CDM provides RESTful APIs to implement automatic job creation or execution control by program invocation.</p>
<p id="dataartsstudio_03_0101__en-us_topic_0108275414_p5666003711515">The following describes how to use CDM to migrate data from table <strong id="dataartsstudio_03_0101__en-us_topic_0108275414_b842352706145132">city1</strong> in the MySQL database to table <strong id="dataartsstudio_03_0101__en-us_topic_0108275414_b842352706145139">city2</strong> on DWS, and how to use Java to invoke CDM RESTful APIs to create, start, query, and delete a CDM job.</p>
<div class="p" id="dataartsstudio_03_0101__en-us_topic_0108275414_p9532825113618">Prepare the following data in advance:<ol id="dataartsstudio_03_0101__en-us_topic_0108275414_ol24882980115215"><li id="dataartsstudio_03_0101__en-us_topic_0108275414_li48592148115448">Username, account name, and project ID of the cloud account</li><li id="dataartsstudio_03_0101__en-us_topic_0108275414_li28517943143446">Create a CDM cluster and obtain the cluster ID.<p id="dataartsstudio_03_0101__en-us_topic_0108275414_p62432154143451"><a name="dataartsstudio_03_0101__en-us_topic_0108275414_li28517943143446"></a><a name="en-us_topic_0108275414_li28517943143446"></a>On the <strong id="dataartsstudio_03_0101__en-us_topic_0108275414_b11815103603718">Cluster Management</strong> page, click the CDM cluster name to view the cluster ID, for example, <span class="parmvalue" id="dataartsstudio_03_0101__en-us_topic_0108275414_parmvalue26191161144546"><b>c110beff-0f11-4e75-8b10-da7cd882b0ef</b></span>.</p>
</li><li id="dataartsstudio_03_0101__en-us_topic_0108275414_li33914591144641">Create a MySQL database and a DWS database, and create tables <strong id="dataartsstudio_03_0101__en-us_topic_0108275414_b84235270615423">city1</strong> and <strong id="dataartsstudio_03_0101__en-us_topic_0108275414_b84235270615426">city2</strong>. The statements for creating tables are as follows:<pre class="screen" id="dataartsstudio_03_0101__en-us_topic_0108275414_screen10915522102720">MySQL:
create table city1(code varchar(10),name varchar(32));
insert into city1 values('NY','New York');
DWS:
create table city2(code varchar(10),name varchar(32));</pre>
</li><li id="dataartsstudio_03_0101__en-us_topic_0108275414_li6285312145126">In the CDM cluster, create a link to MySQL, such as a link named <span class="uicontrol" id="dataartsstudio_03_0101__en-us_topic_0108275414_uicontrol203285099915430"><b>mysqltestlink</b></span>. Create a link to DWS, such as a link named <span class="uicontrol" id="dataartsstudio_03_0101__en-us_topic_0108275414_uicontrol526734515154336"><b>dwstestlink</b></span>.</li><li id="dataartsstudio_03_0101__en-us_topic_0108275414_li60309994151758">Run the following code. You are advised to use the HttpClient package of version 4.5. Maven configuration is as follows:<pre class="screen" id="dataartsstudio_03_0101__en-us_topic_0108275414_screen676774919292">&lt;project&gt;
&lt;modelVersion&gt;4.0.0&lt;/modelVersion&gt;
&lt;groupId&gt;cdm&lt;/groupId&gt;
&lt;artifactId&gt;cdm-client&lt;/artifactId&gt;
&lt;version&gt;1&lt;/version&gt;
&lt;dependencies&gt;
&lt;dependency&gt;
&lt;groupId&gt;org.apache.httpcomponents&lt;/groupId&gt;
&lt;artifactId&gt;httpclient&lt;/artifactId&gt;
&lt;version&gt;4.5&lt;/version&gt;
&lt;/dependency&gt;
&lt;/dependencies&gt;
&lt;/project&gt;</pre>
</li></ol>
</div>
<div class="section" id="dataartsstudio_03_0101__en-us_topic_0108275414_section33199160153236"><h4 class="sectiontitle">Sample Code</h4><p id="dataartsstudio_03_0101__en-us_topic_0108275414_p11663208153245">The code for using Java to invoke CDM RESTful APIs to create, start, query, and delete a CDM job is as follows:</p>
<pre class="screen" id="dataartsstudio_03_0101__en-us_topic_0108275414_screen19695124153018">package cdmclient;
import java.io.IOException;
import org.apache.http.Header;
import org.apache.http.HttpEntity;
import org.apache.http.HttpHost;
import org.apache.http.auth.AuthScope;
import org.apache.http.auth.UsernamePasswordCredentials;
import org.apache.http.client.CredentialsProvider;
import org.apache.http.client.config.RequestConfig;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpDelete;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.client.methods.HttpPut;
import org.apache.http.entity.StringEntity;
import org.apache.http.impl.client.BasicCredentialsProvider;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;</pre>
<pre class="screen" id="dataartsstudio_03_0101__en-us_topic_0108275414_screen1860121213019">public class CdmClient {
private final static String DOMAIN_NAME="<em id="dataartsstudio_03_0101__en-us_topic_0108275414_i1419517508227"></em> <em id="dataartsstudio_03_0101__en-us_topic_0108275414_i3196195062219">account name</em>";
private final static String USER_NAME="<em id="dataartsstudio_03_0101__en-us_topic_0108275414_i572214984112"></em> <em id="dataartsstudio_03_0101__en-us_topic_0108275414_i16722498417">username</em>";
Private final static String USER_PASSWORD= "<em id="dataartsstudio_03_0101__en-us_topic_0108275414_i3322159151414">Password of the cloud user</em>";
private final static String PROJECT_ID="<em id="dataartsstudio_03_0101__en-us_topic_0108275414_i1813864257154938">Project ID</em>";
private final static String CLUSTER_ID="<em id="dataartsstudio_03_0101__en-us_topic_0108275414_i84235269715504">CDM cluster ID</em>";
private final static String JOB_NAME="<em id="dataartsstudio_03_0101__en-us_topic_0108275414_i842352697155044">Job name</em>";
private final static String FROM_LINKNAME="<em id="dataartsstudio_03_0101__en-us_topic_0108275414_i84235269715526">Source link name</em>";
private final static String TO_LINKNAME="<em id="dataartsstudio_03_0101__en-us_topic_0108275414_i842352697155338">Destination link name</em>";
Private final static String IAM_ENDPOINT= "<em id="dataartsstudio_03_0101__en-us_topic_0108275414_i19890729121512">IAM endpoint</em>";
Private final static String CDM_ENDPOINT= "<em id="dataartsstudio_03_0101__en-us_topic_0108275414_i108041752181818">CDM endpoint</em>";</pre>
<pre class="screen" id="dataartsstudio_03_0101__en-us_topic_0108275414_screen2805131814300">private CloseableHttpClient httpclient;
private String token;

public CdmClient() {
this.httpclient = createHttpClient();
this.token = login();
}

private CloseableHttpClient createHttpClient() {
CloseableHttpClient httpclient =HttpClients.createDefault();
return httpclient;
}

private String login(){
HttpPost httpPost = new HttpPost("https://"+IAM_ENDPOINT+"/v3/auth/tokens");
String json =
"{\r\n"+
"\"auth\": {\r\n"+
"\"identity\": {\r\n"+
"\"methods\": [\"password\"],\r\n"+
"\"password\": {\r\n"+
"\"user\": {\r\n"+
"\"name\": \""+USER_NAME+"\",\r\n"+
"\"password\": \""+USER_PASSWORD+"\",\r\n"+
"\"domain\": {\r\n"+
"\"name\": \""+DOMAIN_NAME+"\"\r\n"+
"}\r\n"+
"}\r\n"+
"}\r\n"+
"},\r\n"+
"\"scope\": {\r\n"+
"\"project\": {\r\n"+
"\"name\": \"<em id="dataartsstudio_03_0101__en-us_topic_0108275414_i14811518203015">PROJECT_NAME</em>\"\r\n"+
"}\r\n"+
"}\r\n"+
"}\r\n"+
"}\r\n";
try {
StringEntity s = new StringEntity(json);
s.setContentEncoding("UTF-8");
s.setContentType("application/json");
httpPost.setEntity(s);
CloseableHttpResponse response = httpclient.execute(httpPost);
Header tokenHeader = response.getFirstHeader("X-Subject-Token");
String token = tokenHeader.getValue();
System.out.println("Login successful");
return token;
} catch (Exception e) {
throw new RuntimeException("login failed.", e);
}
}</pre>
<pre class="screen" id="dataartsstudio_03_0101__en-us_topic_0108275414_screen16498155213013">/*Create a job.*/

public void createJob(){
HttpPost httpPost = new HttpPost("https://"+CDM_ENDPOINT+"/cdm/v1.0/"+PROJECT_ID+"/clusters/"+CLUSTER_ID+"/cdm/job");

/**The JSON information here is complex. You can create a job on the job management page, click <strong id="dataartsstudio_03_0101__en-us_topic_0108275414_b842352706145621">Job JSON Definition</strong> next to the job, copy the JSON content and convert it into a Java character string, and paste it here.
*In the JSON message body, you only need to replace the link name, data import and export table names, field list of the tables, and fields used for partitioning in the source table.**/

String json =
"{\r\n"+
"\"jobs\": [\r\n"+
"{\r\n"+
"\"from-connector-name\": \"generic-jdbc-connector\",\r\n"+
"\"name\": \""+JOB_NAME+"\",\r\n"+
"\"to-connector-name\": \"generic-jdbc-connector\",\r\n"+
"\"driver-config-values\": {\r\n"+
"\"configs\": [\r\n"+
"{\r\n"+
"\"inputs\": [\r\n"+
"{\r\n"+
"\"name\": \"throttlingConfig.numExtractors\",\r\n"+
"\"value\": \"1\"\r\n"+
"}\r\n"+
"],\r\n"+
"\"validators\": [],\r\n"+
"\"type\": \"JOB\",\r\n"+
"\"id\": 30,\r\n"+
"\"name\": \"throttlingConfig\"\r\n"+
"}\r\n"+
"]\r\n"+
"},\r\n"+
"\"from-link-name\": \""+FROM_LINKNAME+"\",\r\n"+
"\"from-config-values\": {\r\n"+
"\"configs\": [\r\n"+
"{\r\n"+
"\"inputs\": [\r\n"+
"{\r\n"+
"\"name\": \"fromJobConfig.schemaName\",\r\n"+
"\"value\": \"sqoop\"\r\n"+
"},\r\n"+
"{\r\n"+
"\"name\": \"fromJobConfig.tableName\",\r\n"+
"\"value\": \"city1\"\r\n"+
"},\r\n"+
"{\r\n"+
"\"name\": \"fromJobConfig.columnList\",\r\n"+
"\"value\": \"code&amp;name\"\r\n"+
"},\r\n"+
"{\r\n"+
"\"name\": \"fromJobConfig.partitionColumn\",\r\n"+
"\"value\": \"code\"\r\n"+
"}\r\n"+
"],\r\n"+
"\"validators\": [],\r\n"+
"\"type\": \"JOB\",\r\n"+
"\"id\": 7,\r\n"+
"\"name\": \"fromJobConfig\"\r\n"+
"}\r\n"+
"]\r\n"+
"},\r\n"+
"\"to-link-name\": \""+TO_LINKNAME+"\",\r\n"+
"\"to-config-values\": {\r\n"+
"\"configs\": [\r\n"+
"{\r\n"+
"\"inputs\": [\r\n"+
"{\r\n"+
"\"name\": \"toJobConfig.schemaName\",\r\n"+
"\"value\": \"sqoop\"\r\n"+
"},\r\n"+
"{\r\n"+
"\"name\": \"toJobConfig.tableName\",\r\n"+
"\"value\": \"city2\"\r\n"+
"},\r\n"+
"{\r\n"+
"\"name\": \"toJobConfig.columnList\",\r\n"+
"\"value\": \"code&amp;name\"\r\n"+
"}, \r\n"+
"{\r\n"+
"\"name\": \"toJobConfig.shouldClearTable\",\r\n"+
"\"value\": \"true\"\r\n"+
"}\r\n"+
"],\r\n"+
"\"validators\": [],\r\n"+
"\"type\": \"JOB\",\r\n"+
"\"id\": 9,\r\n"+
"\"name\": \"toJobConfig\"\r\n"+
"}\r\n"+
"]\r\n"+
"}\r\n"+
"}\r\n"+
"]\r\n"+
"}\r\n";
try {
StringEntity s = new StringEntity(json);
s.setContentEncoding("UTF-8");
s.setContentType("application/json");
httpPost.setEntity(s);
httpPost.addHeader("X-Auth-Token", this.token);
httpPost.addHeader("X-Language", "en-us");
CloseableHttpResponse response = httpclient.execute(httpPost);
int status = response.getStatusLine().getStatusCode();
if(status == 200){
System.out.println("Create job successful.");
}else{
System.out.println("Create job failed.");
HttpEntity entity = response.getEntity();
System.out.println(EntityUtils.toString(entity));
}
} catch (Exception e) {
e.printStackTrace();
throw new RuntimeException("Create job failed.", e);
}
}</pre>
<pre class="screen" id="dataartsstudio_03_0101__en-us_topic_0108275414_screen1154514325318">/*Start the job.*/

public void startJob(){
HttpPut httpPut = new HttpPut("https://"+CDM_ENDPOINT+"/cdm/v1.0/"+PROJECT_ID+"/clusters/"+CLUSTER_ID+"/cdm/job/"+JOB_NAME+"/start");
String json = "";
try {
StringEntity s = new StringEntity(json);
s.setContentEncoding("UTF-8");
s.setContentType("application/json");
httpPut.setEntity(s);
httpPut.addHeader("X-Auth-Token", this.token);
httpPut.addHeader("X-Language", "en-us");
CloseableHttpResponse response = httpclient.execute(httpPut);
int status = response.getStatusLine().getStatusCode();
if(status == 200){
System.out.println("Start job successful.");
}else{
System.out.println("Start job failed.");
HttpEntity entity = response.getEntity();
System.out.println(EntityUtils.toString(entity));
}
} catch (Exception e) {
e.printStackTrace();
throw new RuntimeException("Start job failed.", e);
}
}</pre>
<pre class="screen" id="dataartsstudio_03_0101__en-us_topic_0108275414_screen954723283115">/*Query the job running status cyclically until the job is complete.*/

public void getJobStatus(){
HttpGet httpGet = new HttpGet("https://"+CDM_ENDPOINT+"/cdm/v1.0/"+PROJECT_ID+"/clusters/"+CLUSTER_ID+"/cdm/job/"+JOB_NAME+"/status");
try {
httpGet.addHeader("X-Auth-Token", this.token);
httpGet.addHeader("X-Language", "en-us");
boolean flag = true;
while(flag){
CloseableHttpResponse response = httpclient.execute(httpGet);
int status = response.getStatusLine().getStatusCode();
if(status == 200){
HttpEntity entity = response.getEntity();
String msg = EntityUtils.toString(entity);
if(msg.contains("\"status\":\"SUCCEEDED\"")){
System.out.println("Job succeeded");
break;
}else if (msg.contains("\"status\":\"FAILED\"")){
System.out.println("Job failed.");
break;
}else{
Thread.sleep(1000);
}

}else{
System.out.println("Get job status failed.");
HttpEntity entity = response.getEntity();
System.out.println(EntityUtils.toString(entity));
break;
}
}
} catch (Exception e) {
e.printStackTrace();
throw new RuntimeException("Get job status failed.", e);
}
}
</pre>
<pre class="screen" id="dataartsstudio_03_0101__en-us_topic_0108275414_screen933165113314">/*Delete the job.*/

public void deleteJob(){
HttpDelete httpDelte = new HttpDelete("https://"+CDM_ENDPOINT+"/cdm/v1.0/"+PROJECT_ID+"/clusters/"+CLUSTER_ID+"/cdm/job/"+JOB_NAME);
try {
httpDelte.addHeader("X-Auth-Token", this.token);
httpDelte.addHeader("X-Language", "en-us");
CloseableHttpResponse response = httpclient.execute(httpDelte);
int status = response.getStatusLine().getStatusCode();
if(status == 200){
System.out.println("Delete job successful.");
}else{
System.out.println("Delete job failed.");
HttpEntity entity = response.getEntity();
System.out.println(EntityUtils.toString(entity));
}
} catch (Exception e) {
e.printStackTrace();
throw new RuntimeException("Delete job failed.", e);
}
}</pre>
<pre class="screen" id="dataartsstudio_03_0101__en-us_topic_0108275414_screen524319596318">/*Close the process.*/

public void close(){
try {
httpclient.close();
} catch (IOException e) {
throw new RuntimeException("Close failed.", e);
}
}

public static void main(String[] args){
CdmClient cdmClient = new CdmClient();
cdmClient.createJob();
cdmClient.startJob();
cdmClient.getJobStatus();
cdmClient.deleteJob();
cdmClient.close();
}
}</pre>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dataartsstudio_03_0027.html">DataArts Migration (CDM Jobs)</a></div>
</div>
</div>