Data Integration で同期タスクを作成する際に使用される非同期スレッドの ID を生成します。
操作説明
DataWorks では、CreateDISyncTask API オペレーションを使用して、Data Integration で直接バッチ同期タスクを作成できます。リアルタイム同期タスクまたはその他の種類の同期タスクを作成する場合は、まず GenerateDISyncTaskConfigForCreating API オペレーションを呼び出して非同期スレッドの ID を生成し、次にその ID を使用して QueryDISyncTaskConfigProcessResult API オペレーションを呼び出して、非同期で生成されたパラメーターを取得する必要があります。その後、取得したパラメーターを CreateDISyncTask のリクエストパラメーターとして指定し、CreateDISyncTask API オペレーションを呼び出して、リアルタイム同期タスクまたはその他の種類の同期タスクを作成します。DataWorks では、Data Integration におけるリアルタイム同期タスクおよびその他の種類の同期タスクは、非同期モードでのみ作成可能です。
今すぐお試しください
テスト
RAM 認証
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| ProjectId |
integer |
必須 |
DataWorks ワークスペースの ID です。DataWorks コンソール(https://workbench.data.aliyun.com/console)にログインし、「ワークスペース」ページから ID を確認できます。 このパラメーターを設定して、API オペレーションを適用する DataWorks ワークスペースを指定する必要があります。 |
10000 |
| TaskType |
string |
必須 |
非同期モードで Data Integration に作成するタスクの種類です。有効な値は以下のとおりです。
DataWorks では、Data Integration におけるリアルタイム同期タスクおよびその他の種類の同期タスクは、非同期モードでのみ作成可能です。
|
DI_REALTIME |
| TaskParam |
string |
必須 |
同期タスクのスクリプトです。DataWorks では、以下の種類の同期タスクを作成できます。
SelectedTables パラメーターは、複数のデータベースから同期するテーブルを指定するために使用します。Tables パラメーターは、単一のデータベースから同期するテーブルを指定するために使用します。
以下は、MySQL から MaxCompute へのデータ同期を行うスクリプトのサンプルです。
以下は、MySQL から Kafka へのデータ同期を行うスクリプトのサンプルです。
以下は、MySQL から Hologres へのデータ同期を行うスクリプトのサンプルです。 |
{ "type": "realtime", "version": "1.0", "setting": { "resourceGroup": "S_res_group_280749521950784_1623033752022", "scheduleResgroupId": 30003913, "name": "openapi_realtime_solution_0813_1739", "taskType": "oneclick_to_odps" }, "steps": [ { "stepType": "mysql", "parameter": { "connection": [ { "datasourceType": "mysql", "datasource": "mysql_pub", "table": [ "xyx" ] } ] }, "name": "Reader", "category": "reader" }, { "stepType": "odps", "parameter": { "datasource": "odps_first" }, "name": "Writer", "category": "writer" } ] } |
| ClientToken |
string |
任意 |
リクエストのべき等性を保証するためのクライアントトークンです。このパラメーターは、複数回の呼び出しによって重複した操作が発生することを防止するために使用します。 |
ABFUOEUOTRTRJKE |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスパラメーターです。 |
||
| Success |
boolean |
リクエストが成功したかどうかを示します。有効な値は以下のとおりです。
|
true |
| RequestId |
string |
リクエスト ID です。 |
0bc1411515937635973**** |
| Data |
object |
非同期スレッドの ID に関する情報です。 |
|
| Status |
string |
非同期スレッドの ID が正常に生成されたかどうかを示します。有効な値は以下のとおりです。
|
true |
| ProcessId |
integer |
非同期スレッドの ID です。この ID を使用して QueryDISyncTaskConfigProcessResult API オペレーションを呼び出し、非同期で生成されたパラメーターを取得できます。取得したパラメーターは、Data Integration における同期タスクの作成に使用します。 |
10 |
| Message |
string |
非同期スレッドの ID の生成に失敗した理由です。ID が正常に生成された場合は、このパラメーターには値が返されません。 |
XXX is invalid. |
例
成功レスポンス
JSONJSON
{
"Success": true,
"RequestId": "0bc1411515937635973****",
"Data": {
"Status": "true",
"ProcessId": 10,
"Message": "XXX is invalid."
}
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | Invalid.DI.Parameter | The parameter is invalid. | |
| 400 | Invalid.DI.Parameter.File.Existed | The file name already exists. | |
| 500 | InternalError.DI.Parameter | A DI internal error occurred. | |
| 403 | Forbidden.DI.NoPrivilege | No access. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。