TiDB データ移行におけるデータソース構成の管理

このドキュメントでは、MySQL パスワードの暗号化、データソースの操作、 dmctlを使用したアップストリーム MySQL インスタンスと DM ワーカー間のバインディングの変更など、データソース構成を管理する方法について説明します。

データベースのパスワードを暗号化する

DM 構成ファイルでは、dmctl で暗号化されたパスワードを使用することをお勧めします。元のパスワードは 1 つで、暗号化するたびに暗号化されたパスワードは異なります。

注記：
v8.0.0 以降では、 dmctl encryptコマンドを使用する前に、DM-master にsecret-key-path設定する必要があります。

./dmctl encrypt 'abc!@#123'

MKxn0Qo3m3XOyjCnhEMtsUCm83EhGQDZ/T4=

データソースを操作する

operate-sourceコマンドを使用して、データソース構成を DM クラスターにロード、一覧表示、または削除できます。

help operate-source

`create`/`stop`/`show` upstream MySQL/MariaDB source.

Usage:
  dmctl operate-source <operate-type> [config-file ...] [--print-sample-config] [flags]

Flags:
  -h, --help                  help for operate-source
  -p, --print-sample-config   print sample config file of source

Global Flags:
  -s, --source strings   MySQL Source ID

フラグの説明

create : 1 つ以上のアップストリームデータベースソースを作成します。複数のデータソースの作成が失敗すると、DM はコマンドが実行されなかった状態にロールバックします。
stop : 1 つ以上の上流データベースソースを停止します。複数のデータソースの停止に失敗した場合、一部のデータソースが停止される可能性があります。
show : 追加されたデータソースと対応する DM ワーカーを表示します。
config-file : source.yamlのファイルパスを指定し、複数のファイルパスを渡すことができます。
--print-sample-config : サンプル構成ファイルを印刷します。このパラメータは他のパラメータを無視します。

使用例

ソース構成ファイルを作成するには、次のoperate-sourceコマンドを使用します。

operate-source create ./source.yaml

source.yamlの設定についてはアップストリームデータベースコンフィグレーションファイルの概要を参照してください。

返される結果の例を次に示します。

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

データソースの構成を確認する

注記：
configコマンドは DM v6.0 以降のバージョンでのみサポートされます。それより前のバージョンでは、 get-configコマンドを使用する必要があります。

source-idがわかっている場合は、 dmctl --master-addr <master-addr> config source <source-id>実行してデータソース構成を取得できます。

config source mysql-replica-01

{
  "result": true,
    "msg": "",
    "cfg": "enable-gtid: false
      flavor: mysql
      source-id: mysql-replica-01
      from:
        host: 127.0.0.1
        port: 8407
        user: root
        password: '******'
}

source-idわからない場合は、まずdmctl --master-addr <master-addr> operate-source show実行してすべてのデータソースを一覧表示できます。

operate-source show

{
    "result": true,
    "msg": "",
    "sources": [
        {
            "result": true,
            "msg": "source is added but there is no free worker to bound",
            "source": "mysql-replica-02",
            "worker": ""
        },
        {
            "result": true,
            "msg": "",
            "source": "mysql-replica-01",
            "worker": "dm-worker-1"
        }
    ]
}

アップストリームのMySQLインスタンスとDMワーカー間のバインディングを変更する

transfer-sourceコマンドを使用して、アップストリーム MySQL インスタンスと DM ワーカー間のバインディングを変更できます。

help transfer-source

Transfers an upstream MySQL/MariaDB source to a free worker.
Usage:
  dmctl transfer-source <source-id> <worker-id> [flags]
Flags:
  -h, --help   help for transfer-source
Global Flags:
  -s, --source strings   MySQL Source ID.

転送する前に、DM は、バインド解除するワーカーにまだ実行中のタスクがあるかどうかを確認します。ワーカーに実行中のタスクがある場合は、まずタスクを一時停止する実行し、バインドを変更してからタスクを再開する実行する必要があります。

使用例

DM ワーカーのバインディングがわからない場合は、 dmctl --master-addr <master-addr> list-member --worker実行して、すべてのワーカーの現在のバインディングを一覧表示できます。

list-member --worker

{
    "result": true,
    "msg": "",
    "members": [
        {
            "worker": {
                "msg": "",
                "workers": [
                    {
                        "name": "dm-worker-1",
                        "addr": "127.0.0.1:8262",
                        "stage": "bound",
                        "source": "mysql-replica-01"
                    },
                    {
                        "name": "dm-worker-2",
                        "addr": "127.0.0.1:8263",
                        "stage": "free",
                        "source": ""
                    }
                ]
            }
        }
    ]
}

上記の例では、 mysql-replica-01 dm-worker-1にバインドされています。以下のコマンドは、 mysql-replica-01のバインディングワーカーをdm-worker-2に転送します。

transfer-source mysql-replica-01 dm-worker-2

{
    "result": true,
    "msg": ""
}

dmctl --master-addr <master-addr> list-member --workerを実行して、コマンドが有効になるかどうかを確認します。

list-member --worker

{
    "result": true,
    "msg": "",
    "members": [
        {
            "worker": {
                "msg": "",
                "workers": [
                    {
                        "name": "dm-worker-1",
                        "addr": "127.0.0.1:8262",
                        "stage": "free",
                        "source": ""
                    },
                    {
                        "name": "dm-worker-2",
                        "addr": "127.0.0.1:8263",
                        "stage": "bound",
                        "source": "mysql-replica-01"
                    }
                ]
            }
        }
    ]
}

TiDB データ移行におけるデータ ソース構成の管理