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-gtid
とenable-relay
を同時にtrue
に設定しないでください。そうしないと、増分データが失われる可能性があります。
コンフィグレーションパラメータ
このセクションでは、構成ファイル内の各構成パラメータについて説明します。
グローバル構成
パラメータ | 説明 |
---|---|
source-id | MySQL インスタンス ID を表します。 |
enable-gtid | GTID を使用してアップストリームからbinlogをプルするかどうかを決定します。デフォルト値はfalse です。通常、 enable-gtid 手動で設定する必要はありません。ただし、アップストリーム データベースで GTID が有効になっていて、プライマリ/セカンダリ スイッチが必要な場合は、 enable-gtid をtrue に設定する必要があります。 |
enable-relay | リレー ログ機能を有効にするかどうかを決定します。デフォルト値はfalse です。DM v2.0.2 以降、この構成項目は非推奨です。 リレーログ機能を有効にするにするには、代わりにstart-relay コマンドを使用します。 |
relay-binlog-name | DM-worker がbinlogの取得を開始するファイル名を指定します。たとえば、 "mysql-bin.000002" です。これはenable_gtid がfalse の場合にのみ機能します。このパラメータが指定されていない場合、DM-worker は複製される最も古いbinlogファイルから取得を開始します。通常、手動設定は必要ありません。 |
relay-binlog-gtid | DM-worker がbinlogのプルを開始する GTID を指定します。たとえば、 "e9a1fc22-ec08-11e9-b2ac-0242ac110003:1-7849" 。これはenable_gtid がtrue 場合にのみ機能します。このパラメータが指定されていない場合、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 つの構成項目expires
とremain-space
のうち少なくとも 1 つが 0 でない場合にのみ有効になります。
タスクステータスチェッカーの設定( checker
)
DM は定期的に現在のタスク ステータスとエラー メッセージをチェックし、タスクを再開するとエラーが解消されるかどうかを判断します。必要に応じて、DM は自動的にタスクの再開を再試行します。DM は指数バックオフ戦略を使用してチェック間隔を調整します。その動作は、次の構成によって調整できます。
パラメータ | 説明 |
---|---|
check-enable | この機能を有効にするかどうか。 |
backoff-rollback | バックオフ戦略の現在のチェック間隔がこの値より大きく、タスクの状態が正常である場合、DM は間隔を短縮しようとします。 |
backoff-max | バックオフ戦略のチェック間隔の最大値は 1 秒より大きくなければなりません。 |
Binlogイベント フィルター
DM v2.0.2 以降では、ソース構成ファイルでbinlogイベント フィルターを構成できます。
パラメータ | 説明 |
---|---|
case-sensitive | フィルタリング ルールで大文字と小文字を区別するかどうかを決定します。デフォルト値はfalse です。 |
filters | binlogイベントのフィルタリング ルールを設定します。詳細については、 Binlogイベント フィルター パラメータの説明を参照してください。 |