メインコンテンツへスキップ
これは、MySQL ClickPipe 経由でデータをレプリケーションするために、RDS MariaDB インスタンスを設定する手順をまとめたガイドです。
こちらの MySQL に関するよくある質問にも、あわせて目を通すことをお勧めします。よくある質問ページは随時更新されています。

​
バイナリログの保持を有効にする

バイナリログは、MySQLサーバーのインスタンスで行われたデータ変更に関する情報を含む一連のログファイルです。バイナリログファイルはレプリケーションに必要です。以下の両方の手順を実行する必要があります。

​
1. 自動バックアップによるバイナリログの有効化

自動バックアップ機能によって、MySQL でバイナリログを有効にするかどうかが決まります。これは AWS コンソールで設定できます。 レプリケーションの用途に応じて、バックアップ保持期間は十分に長めに設定することを推奨します。

​
2. binlog の保持時間

Amazon RDS for MariaDB では、binlog の保持期間 (変更内容を含む binlog ファイルを保持しておく時間) の設定方法が異なります。binlog ファイルが削除される前に一部の変更が読み取られないと、レプリケーションを継続できなくなります。binlog retention hours のデフォルト値は NULL で、これはバイナリログが保持されないことを意味します。 DB インスタンスでバイナリログを保持する時間数を指定するには、レプリケーションに十分な長さの binlog の保持期間を指定して、mysql.rds_set_configuration 関数を使用します。推奨される最小値は 24 hours です。 
mysql=> call mysql.rds_set_configuration('binlog retention hours', 24);

​
パラメータグループで binlog 設定を構成する

パラメータグループは、RDS Console で MariaDB インスタンスをクリックし、Configurations タブに移動すると確認できます。 パラメータグループのリンクをクリックすると、パラメータグループのページに移動します。右上に Edit ボタンがあります。 binlog_format、binlog_row_metadata、binlog_row_image は次のように設定する必要があります。
  1. binlog_format を ROW に設定します。
  1. binlog_row_metadata を FULL に設定します。
  1. binlog_row_image を FULL に設定します。
次に、右上の Save Changes をクリックします。変更を反映するには、インスタンスの再起動が必要になる場合があります。RDS インスタンスの Configurations タブで、パラメータグループのリンクの横に Pending reboot と表示されている場合は、インスタンスの再起動が必要である可能性が高いことを示しています。
MariaDB クラスターを使用している場合、上記のパラメータは DB インスタンスグループではなく、DB Cluster のパラメータグループにあります。

​
GTID モードを有効にする

Global Transaction Identifiers (GTID) は、MySQL/MariaDB でコミットされた各トランザクションに割り当てられる一意の ID です。これにより、binlog レプリケーションが簡素化され、トラブルシューティングも容易になります。MariaDB ではデフォルトで GTID モードが有効になっているため、利用するためにユーザー側で追加の操作を行う必要はありません。

​
データベースユーザーを設定する

管理者ユーザーとして RDS MariaDB インスタンスに接続し、次のコマンドを実行します。
  1. ClickPipes 専用のユーザーを作成します。 
    CREATE USER 'clickpipes_user'@'host' IDENTIFIED BY 'some-password';
  2. スキーマに対する権限を付与します。次の例では、mysql データベースに対する権限を示しています。レプリケーション対象とする各データベースおよびホストについて、これらのコマンドを繰り返してください。 
    GRANT SELECT ON `mysql`.* TO 'clickpipes_user'@'host';
  3. ユーザーにレプリケーション権限を付与します。 
    GRANT REPLICATION CLIENT ON *.* TO 'clickpipes_user'@'%';
GRANT REPLICATION SLAVE ON *.* TO 'clickpipes_user'@'%';

​
ネットワークアクセスを設定する

​
IP ベースのアクセス制御

RDS インスタンスへのトラフィックを制限する場合は、RDS のセキュリティグループの Inbound rules に、ドキュメントに記載されている固定 NAT IP を追加してください。 プライベートネットワーク経由で RDS インスタンスに接続するには、AWS PrivateLink を利用できます。接続を設定するには、ClickPipes 向け AWS PrivateLink セットアップガイドを参照してください。
最終更新日 2026年6月10日