TiDB データ移行の上流データベースコンフィグレーションファイル

このドキュメントでは、アップストリーム データベースの構成ファイルについて紹介します。これには、構成ファイル テンプレートと、このファイル内の各構成パラメータの説明が含まれます。

コンフィグレーションファイルテンプレート

以下は、アップストリーム データベースの構成ファイル テンプレートです。

source-id: "mysql-replica-01" # Whether to enable GTID. enable-gtid: false # Whether to enable relay log. enable-relay: false # Since DM v2.0.2, this configuration item is deprecated. To enable the relay log feature, use the `start-relay` command instead. relay-binlog-name: "" # The file name from which DM-worker starts to pull the binlog. relay-binlog-gtid: "" # The GTID from which DM-worker starts to pull the binlog. # relay-dir: "relay-dir" # The directory used to store relay log. The default value is "relay-dir". This configuration item is marked as deprecated since v6.1 and replaced by a parameter of the same name in the dm-worker configuration. from: host: "127.0.0.1" port: 3306 user: "root" password: "ZqMLjZ2j5khNelDEfDoUhkD5aV5fIJOe0fiog9w=" # The user password of the upstream database. It is recommended to use the password encrypted with dmctl. security: # The TLS configuration of the upstream database ssl-ca: "/path/to/ca.pem" ssl-cert: "/path/to/cert.pem" ssl-key: "/path/to/key.pem" # purge: # interval: 3600 # expires: 0 # remain-space: 15 # checker: # check-enable: true # backoff-rollback: 5m0s # backoff-max: 5m0s # The maximum value of backoff, should be larger than 1s # Configure binlog event filters. New in DM v2.0.2 # case-sensitive: false # filters: # - schema-pattern: dmctl # table-pattern: t_1 # events: [] # sql-pattern: # - alter table .* add column `aaa` int # action: Ignore

注記:

DM v2.0.1 では、 enable-gtidenable-relayを同時にtrueに設定しないでください。そうしないと、増分データが失われる可能性があります。

コンフィグレーションパラメータ

このセクションでは、構成ファイル内の各構成パラメータについて説明します。

グローバル構成

パラメータ説明
source-idMySQL インスタンス ID を表します。
enable-gtidGTID を使用してアップストリームからbinlogをプルするかどうかを決定します。デフォルト値はfalseです。通常、 enable-gtid手動で設定する必要はありません。ただし、アップストリーム データベースで GTID が有効になっていて、プライマリ/セカンダリ スイッチが必要な場合は、 enable-gtidtrueに設定する必要があります。
enable-relayリレー ログ機能を有効にするかどうかを決定します。デフォルト値はfalseです。DM v2.0.2 以降、この構成項目は非推奨です。 リレーログ機能を有効にするにするには、代わりにstart-relayコマンドを使用します。
relay-binlog-nameDM-worker がbinlogの取得を開始するファイル名を指定します。たとえば、 "mysql-bin.000002"です。これはenable_gtidfalseの場合にのみ機能します。このパラメータが指定されていない場合、DM-worker は複製される最も古いbinlogファイルから取得を開始します。通常、手動設定は必要ありません。
relay-binlog-gtidDM-worker がbinlogのプルを開始する GTID を指定します。たとえば、 "e9a1fc22-ec08-11e9-b2ac-0242ac110003:1-7849" 。これはenable_gtidtrue場合にのみ機能します。このパラメータが指定されていない場合、DM-worker はレプリケートされている最新の GTID からプルを開始します。通常、手動構成は必要ありません。
relay-dirリレー ログ ディレクトリを指定します。
hostアップストリーム データベースのホストを指定します。
portアップストリーム データベースのポートを指定します。
userアップストリーム データベースのユーザー名を指定します。
passwordアップストリーム データベースのユーザー パスワードを指定します。dmctl で暗号化されたパスワードを使用することをお勧めします。
securityアップストリーム データベースの TLS 構成を指定します。証明書の構成されたファイル パスは、すべてのノードからアクセスできる必要があります。構成されたファイル パスがローカル パスである場合、クラスター内のすべてのノードは、各ホストの同じパスに証明書のコピーを保存する必要があります。

リレーログクリーンアップ戦略の構成( purge

通常、リレーログが大量に存在し、ディスク容量が不足している場合を除き、これらのパラメータを手動で設定する必要はありません。

パラメータ説明デフォルト値
intervalリレー ログの有効期限を定期的にチェックする時間間隔を秒単位で設定します。3600
expiresリレー ログの有効期限を時間単位で設定します。リレー処理ユニットによって書き込まれていないリレー ログ、または既存のデータ移行タスクによって読み取る必要がないリレー ログは、有効期限を過ぎると DM によって削除されます。このパラメータを指定しないと、自動パージは実行されません。0
remain-space空きディスク容量の最小量をギガバイト単位で設定します。使用可能なディスク容量がこの値より小さい場合、DM-worker はリレー ログを削除しようとします。15

注記:

自動データ消去戦略は、 intervalが 0 でなく、2 つの構成項目expiresremain-spaceのうち少なくとも 1 つが 0 でない場合にのみ有効になります。

タスクステータスチェッカーの設定( checker

DM は定期的に現在のタスク ステータスとエラー メッセージをチェックし、タスクを再開するとエラーが解消されるかどうかを判断します。必要に応じて、DM は自動的にタスクの再開を再試行します。DM は指数バックオフ戦略を使用してチェック間隔を調整します。その動作は、次の構成によって調整できます。

パラメータ説明
check-enableこの機能を有効にするかどうか。
backoff-rollbackバックオフ戦略の現在のチェック間隔がこの値より大きく、タスクの状態が正常である場合、DM は間隔を短縮しようとします。
backoff-maxバックオフ戦略のチェック間隔の最大値は 1 秒より大きくなければなりません。

Binlogイベント フィルター

DM v2.0.2 以降では、ソース構成ファイルでbinlogイベント フィルターを構成できます。

パラメータ説明
case-sensitiveフィルタリング ルールで大文字と小文字を区別するかどうかを決定します。デフォルト値はfalseです。
filtersbinlogイベントのフィルタリング ルールを設定します。詳細については、 Binlogイベント フィルター パラメータの説明を参照してください。

このページは役に立ちましたか?