重要
このページは英語版のページを機械翻訳しています。原文はこちらからご覧ください。

アップストリームデータベースConfiguration / コンフィグレーションファイル

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

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

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

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に設定しないでください。そうしないと、増分データが失われる可能性があります。

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

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

グローバル構成

パラメータ説明
source-idMySQLインスタンスIDを表します。
enable-gtidGTIDを使用してアップストリームからbinlogをプルするかどうかを決定します。デフォルト値はfalseです。通常、 enable-gtidを手動で構成する必要はありません。ただし、アップストリームデータベースでGTIDが有効になっていて、プライマリ/セカンダリスイッチが必要な場合は、 enable-gtidを設定する必要がありtrue 。
enable-relayリレーログ機能を有効にするかどうかを決定します。デフォルト値はfalseです。 DM v2.0.2以降、この構成アイテムは非推奨になりました。 リレーログ機能を有効にするにするには、代わりにstart-relayコマンドを使用します。
relay-binlog-nameDM-workerがbinlogのプルを開始するファイル名を指定します。たとえば、 "mysql-bin.000002" 。 enable_gtidがfalseの場合にのみ機能します。このパラメーターが指定されていない場合、DM-workerは最新のものから開始してbinlogをプルします。
relay-binlog-gtidDMワーカーがbinlogのプルを開始するGTIDを指定します。たとえば、 "e9a1fc22-ec08-11e9-b2ac-0242ac110003:1-7849" 。 enable_gtidがtrueの場合にのみ機能します。このパラメーターが指定されていない場合、DM-workerは最新のGTIDから開始してbinlogをプルします。
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です。
filtersbinlogイベントフィルタリングルールを設定します。詳細については、 Binlogイベントフィルターパラメーターの説明を参照してください。
このページの内容