すべてのプロダクト
Search
ドキュメントセンター

DataWorks:GenerateDISyncTaskConfigForCreating

最終更新日:Mar 21, 2026

Data Integration で同期タスクを作成する際に使用される非同期スレッドの ID を生成します。

操作説明

DataWorks では、CreateDISyncTask API オペレーションを使用して、Data Integration で直接バッチ同期タスクを作成できます。リアルタイム同期タスクまたはその他の種類の同期タスクを作成する場合は、まず GenerateDISyncTaskConfigForCreating API オペレーションを呼び出して非同期スレッドの ID を生成し、次にその ID を使用して QueryDISyncTaskConfigProcessResult API オペレーションを呼び出して、非同期で生成されたパラメーターを取得する必要があります。その後、取得したパラメーターを CreateDISyncTask のリクエストパラメーターとして指定し、CreateDISyncTask API オペレーションを呼び出して、リアルタイム同期タスクまたはその他の種類の同期タスクを作成します。DataWorks では、Data Integration におけるリアルタイム同期タスクおよびその他の種類の同期タスクは、非同期モードでのみ作成可能です。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター

必須 / 任意

説明

ProjectId

integer

必須

DataWorks ワークスペースの ID です。DataWorks コンソール(https://workbench.data.aliyun.com/console)にログインし、「ワークスペース」ページから ID を確認できます。

このパラメーターを設定して、API オペレーションを適用する DataWorks ワークスペースを指定する必要があります。

10000

TaskType

string

必須

非同期モードで Data Integration に作成するタスクの種類です。有効な値は以下のとおりです。

  • DI_REALTIME:リアルタイム同期タスク

  • DI_SOLUTION:その他の種類の同期タスク

DataWorks では、Data Integration におけるリアルタイム同期タスクおよびその他の種類の同期タスクは、非同期モードでのみ作成可能です。

  • DI_OFFLINE

  • DI_REALTIME

  • DI_SOLUTION

DI_REALTIME

TaskParam

string

必須

同期タスクのスクリプトです。DataWorks では、以下の種類の同期タスクを作成できます。

  • MySQL から MaxCompute へのデータ同期タスク

  • MySQL から Kafka へのデータ同期タスク

  • MySQL から Hologres へのデータ同期タスク

SelectedTables パラメーターは、複数のデータベースから同期するテーブルを指定するために使用します。Tables パラメーターは、単一のデータベースから同期するテーブルを指定するために使用します。

  • スクリプトに SelectedTables パラメーターが含まれている場合、システムは SelectedTables パラメーターで指定したテーブルからデータを同期します。

  • スクリプトに Tables パラメーターが含まれている場合、システムは Tables パラメーターで指定したテーブルからデータを同期します。

以下は、MySQL から MaxCompute へのデータ同期を行うスクリプトのサンプルです。

{
  "type": "realtime",
  "version": "1.0",
  "setting": {
    "resourceGroup": "S_res_group_280749521950784_1623033752022",
    "taskType": "oneclick_to_odps"
  },
  "steps": [
    {
      "stepType": "mysql",
      "parameter": {
        "connection": [
          {
            "datasourceType": "mysql",
            "datasource": "mysql_pub1",
            "selectedTables": [
              {
                "dbName": "mysql_db",
                "schema": [
                  {
                    "tableInfos": [
                      {
                        "table": "molin_di_test_in_pk_v4"
                      }
                    ]
                  }
                ]
              }
            ]
          }
        ]
      },
      "name": "Reader",
      "category": "reader"
    },
    {
      "stepType": "odps",
      "parameter": {
        "datasource": "odps_source"
      },
      "name": "Writer",
      "category": "writer"
    }
  ]
}

以下は、MySQL から Kafka へのデータ同期を行うスクリプトのサンプルです。

{
  "type": "realtime",
  "version": "1.0",
  "setting": {
    "resourceGroup": "S_res_group_280749521950784_1623033752022",
    "taskType": "oneclick_to_kafka"
  },
  "steps": [
    {
      "stepType": "mysql",
      "parameter": {
        "connection": [
          {
            "datasourceType": "mysql",
            "datasource": "pkset_test",
            "selectedTables": [
              {
                "dbName": "mysql_db",
                "schema": [
                  {
                    "tableInfos": [
                      {
                        "table": "molin_di_test_in_pk_v4"
                      }
                    ]
                  }
                ]
              }
            ]
          }
        ]
      },
      "name": "Reader",
      "category": "reader"
    },
    {
      "stepType": "kafka",
      "parameter": {
        "datasource": "azn_kafka"
      },
      "name": "Writer",
      "category": "writer"
    }
  ]
}

以下は、MySQL から Hologres へのデータ同期を行うスクリプトのサンプルです。

{
  "type": "realtime",
  "version": "1.0",
  "setting": {
    "resourceGroup": "S_res_group_280749521950784_1623033752022",
    "taskType": "oneclick_to_holo"
  },
  "steps": [
    {
      "stepType": "mysql",
      "parameter": {
        "connection": [
          {
            "datasourceType": "mysql",
            "datasource": "mysql_pub",
            "selectedTables": [
              {
                "dbName": "mysql_db",
                "schema": [
                  {
                    "tableInfos": [
                      {
                        "table": "molin_di_test_in2_pk_v3"
                      }
                    ]
                  }
                ]
              }
            ]
          }
        ]
      },
      "name": "Reader",
      "category": "reader"
    },
    {
      "stepType": "holo",
      "parameter": {
        "datasource": "holo"
      },
      "name": "Writer",
      "category": "writer"
    }
  ]
}

{ "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

  • false

true

RequestId

string

リクエスト ID です。

0bc1411515937635973****

Data

object

非同期スレッドの ID に関する情報です。

Status

string

非同期スレッドの ID が正常に生成されたかどうかを示します。有効な値は以下のとおりです。

  • success:非同期スレッドの ID が正常に生成されたことを示します。

  • fail:非同期スレッドの 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.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。