データ移行タスクを作成する

start-taskコマンドを使用してデータ移行タスクを作成できます。データ移行タスクが開始されると、DM 権限と設定を事前にチェックします実行されます。

help start-task

Starts a task as defined in the configuration file

Usage:
  dmctl start-task [-s source ...] [--remove-meta] <config-file> [flags]

Flags:
  -h, --help                help for start-task
      --remove-meta         whether to remove task's meta data
      --start-time string   specify the start time of binlog replication, e.g. '2021-10-21 00:01:00' or 2021-10-21T00:01:00

Global Flags:
      --config string        Path to config file.
      --master-addr string   Master API server address, this parameter is required when interacting with the dm-master
      --rpc-timeout string   RPC timeout, default is 10m. (default "10m")
  -s, --source strings       MySQL Source ID.
      --ssl-ca string        Path of file that contains list of trusted SSL CAs for connection.
      --ssl-cert string      Path of file that contains X509 certificate in PEM format for connection.
      --ssl-key string       Path of file that contains X509 key in PEM format for connection.
  -V, --version              Prints version and exit.

使用例

start-task [ -s "mysql-replica-01"] ./task.yaml

フラグの説明

• -s : (オプション) 実行するMySQLソースを指定しますtask.yaml 。設定されている場合、コマンドはMySQLソース上で指定されたタスクのサブタスクのみを開始します。
• config-file : (必須) task.yamlのファイル パスを指定します。
• remove-meta : (オプション) タスクを開始するときに、タスクの以前のメタデータを削除するかどうかを指定します。
• start-time : (オプション) binlogレプリケーションの開始時刻を指定します。
  • 形式: '2021-10-21 00:01:00'または2021-10-21T00:01:00 。
  • 増分タスクの場合、このフラグを使用してタスクの大まかな開始位置を指定できます。このフラグは、タスク設定ファイル内のbinlogの位置や下流チェックポイント内のbinlogの位置よりも優先されます。
  • タスクに既にチェックポイントがある場合、このフラグを使用してタスクを開始すると、レプリケーションがチェックポイントを通過するまでDMは自動的にセーフモードを有効にします。これは、タスクを以前の位置にリセットすることで発生するデータ重複エラーを回避するためです。
    • タスクを以前の位置にリセットすると、その時点でのテーブル スキーマが現在の時点でのダウンストリームと異なる場合、タスクはエラーを報告する可能性があります。
    • タスクを後の位置にリセットする場合、スキップされたbinlogの下流にダーティ データが残る可能性があることに注意してください。
  • より早い開始時刻を指定すると、DM は利用可能な最も古いbinlog位置から移行を開始します。
  • 開始時刻を遅く指定すると、DM はエラーを報告します: start-time {input-time} is too late, no binlog location matches it 。

返された結果

start-task task.yaml

{
    "result": true,
    "msg": "",
    "sources": [
        {
            "result": true,
            "msg": "",
            "source": "mysql-replica-01",
            "worker": "worker1"
        }
    ]
}