> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# RDS MariaDB ソースの設定ガイド

> Amazon RDS MariaDB を ClickPipes のソースとして設定するための手順ガイド

これは、MySQL ClickPipe 経由でデータをレプリケーションするために、RDS MariaDB インスタンスを設定する手順をまとめたガイドです。

> [!NOTE]
>
> [こちら](https://clickhouse.com/docs/ja/integrations/clickpipes/mysql/faq.md)の MySQL に関するよくある質問にも、あわせて目を通すことをお勧めします。よくある質問ページは随時更新されています。

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

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

**1. 自動バックアップでバイナリログを有効にする**

自動バックアップ機能によって、MySQL のバイナリログを有効にするかどうかが決まります。これは AWS コンソールで設定できます。

![RDS で自動バックアップを有効にする](https://mintcdn.com/private-7c7dfe99/KW34O4k4cC0oxlHH/images/integrations/data-ingestion/clickpipes/mysql/source/rds/rds-backups.webp?fit=max\&auto=format\&n=KW34O4k4cC0oxlHH\&q=85\&s=88828f15321d2cfda5570c7b03755bf2)

レプリケーションのユースケースに応じて、バックアップ保持期間を十分長く設定することをお勧めします。

**2. binlog の保持時間**

Amazon RDS for MariaDB では、binlog の保持期間 (変更内容を含む binlog ファイルを保持しておく時間) の設定方法が異なります。binlog ファイルが削除される前に一部の変更が読み取られないと、レプリケーションを継続できなくなります。binlog retention hours のデフォルト値は NULL で、これはバイナリログが保持されないことを意味します。

DB インスタンスでバイナリログを保持する時間数を指定するには、レプリケーションに十分な長さの binlog の保持期間を指定して、mysql.rds\_set\_configuration 関数を使用します。推奨される最小値は `24 hours` です。

```text theme={null}
mysql=> call mysql.rds_set_configuration('binlog retention hours', 24);
```

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

パラメータグループは、RDS Console で MariaDB インスタンスをクリックし、`Configurations` タブに移動すると確認できます。

![RDS でパラメータグループを確認する場所](https://mintcdn.com/private-7c7dfe99/KW34O4k4cC0oxlHH/images/integrations/data-ingestion/clickpipes/mysql/parameter_group/rds_config.webp?fit=max\&auto=format\&n=KW34O4k4cC0oxlHH\&q=85\&s=6036d21ce1fc3406e4f55afd0438d3f7)

パラメータグループのリンクをクリックすると、パラメータグループのページに移動します。右上に `Edit` ボタンがあります。

![パラメータグループを編集](https://mintcdn.com/private-7c7dfe99/KW34O4k4cC0oxlHH/images/integrations/data-ingestion/clickpipes/mysql/parameter_group/edit_button.webp?fit=max\&auto=format\&n=KW34O4k4cC0oxlHH\&q=85\&s=192065830ca746a62c66263ec2a20b0d)

`binlog_format`、`binlog_row_metadata`、`binlog_row_image` は次のように設定する必要があります。

1. `binlog_format` を `ROW` に設定します。

![Binlog format を ROW に設定](https://mintcdn.com/private-7c7dfe99/KW34O4k4cC0oxlHH/images/integrations/data-ingestion/clickpipes/mysql/parameter_group/binlog_format.webp?fit=max\&auto=format\&n=KW34O4k4cC0oxlHH\&q=85\&s=1a7a35322b2245e40effe756d3d2ad3b)

2. `binlog_row_metadata` を `FULL` に設定します。

![Binlog row metadata を FULL に設定](https://mintcdn.com/private-7c7dfe99/KW34O4k4cC0oxlHH/images/integrations/data-ingestion/clickpipes/mysql/parameter_group/binlog_row_metadata.webp?fit=max\&auto=format\&n=KW34O4k4cC0oxlHH\&q=85\&s=0c74f95749753ac8b403f7bcf98577b7)

3. `binlog_row_image` を `FULL` に設定します。

![Binlog row image を FULL に設定](https://mintcdn.com/private-7c7dfe99/KW34O4k4cC0oxlHH/images/integrations/data-ingestion/clickpipes/mysql/parameter_group/binlog_row_image.webp?fit=max\&auto=format\&n=KW34O4k4cC0oxlHH\&q=85\&s=3429000da2c1e3133c96c89ea39f151c)

次に、右上の `Save Changes` をクリックします。変更を反映するには、インスタンスの再起動が必要になる場合があります。RDS インスタンスの `Configurations` タブで、パラメータグループのリンクの横に `Pending reboot` と表示されている場合は、インスタンスの再起動が必要である可能性が高いことを示しています。

> [!TIP]
>
> MariaDB クラスターを使用している場合、上記のパラメータは DB インスタンスグループではなく、[DB Cluster](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_WorkingWithParamGroups.CreatingCluster.html) のパラメータグループにあります。

## GTID モードを有効にする

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

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

管理者ユーザーとして RDS MariaDB インスタンスに接続し、次のコマンドを実行します。

1. ClickPipes 専用のユーザーを作成します。

   ```sql theme={null}
   CREATE USER 'clickpipes_user'@'host' IDENTIFIED BY 'some-password';
   ```

2. スキーマに対する権限を付与します。次の例では、`mysql` データベースに対する権限を示しています。レプリケーション対象とする各データベースおよびホストについて、これらのコマンドを繰り返してください。

   ```sql theme={null}
   GRANT SELECT ON `mysql`.* TO 'clickpipes_user'@'host';
   ```

3. ユーザーにレプリケーション権限を付与します。

   ```sql theme={null}
   GRANT REPLICATION CLIENT ON *.* TO 'clickpipes_user'@'%';
   GRANT REPLICATION SLAVE ON *.* TO 'clickpipes_user'@'%';
   ```

### IAM認証を使用する (任意)

> [!NOTE]
>
> AWS は、[バージョン 10.6.5 で RDS for MariaDB 向けの IAM database authentication を導入しました](https://aws.amazon.com/blogs/database/iam-authentication-with-amazon-rds-for-mariadb/) 。サポート状況は、使用するエンジンの正確なバージョンと AWS リージョンによって異なります。このオプションを使用する前に、[AWS の現在のサポート対象リージョンとエンジンバージョン](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RDS_Fea_Regions_DB-eng.Feature.IamDatabaseAuthentication.html)を確認してください。

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

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

RDS インスタンスへのトラフィックを制限する場合は、RDS のセキュリティグループの `Inbound rules` に、[ドキュメントに記載されている固定 NAT IP](https://clickhouse.com/docs/ja/integrations/clickpipes/networking/static-ips.md) を追加してください。

![RDS でセキュリティグループはどこにありますか？](https://mintcdn.com/private-7c7dfe99/KW34O4k4cC0oxlHH/images/integrations/data-ingestion/clickpipes/mysql/source/rds/security-group-in-rds-mysql.webp?fit=max\&auto=format\&n=KW34O4k4cC0oxlHH\&q=85\&s=41438dc20ba5bf00f8891b847ec9dee7)

![上記のセキュリティグループのインバウンドルールを編集](https://mintcdn.com/private-7c7dfe99/ODDx2ujqe_LWUyTV/images/integrations/data-ingestion/clickpipes/postgres/source/rds/edit_inbound_rules.webp?fit=max\&auto=format\&n=ODDx2ujqe_LWUyTV\&q=85\&s=9808abca84e218a11bf9a241473ba062)

### AWS PrivateLink 経由のプライベートアクセス

プライベートネットワーク経由で RDS インスタンスに接続するには、AWS PrivateLink を使用できます。接続を設定するには、[ClickPipes 向け AWS PrivateLink セットアップガイド](https://clickhouse.com/docs/ja/resources/support-center/knowledge-base/cloud-services/aws-privatelink-setup-for-clickpipes.md)に従ってください。
