> ## 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.

# Aurora MySQL ソース設定ガイド

> Amazon Aurora MySQL を ClickPipes のソースとして設定するためのステップバイステップガイド

このステップバイステップガイドでは、[MySQL ClickPipe](https://clickhouse.com/docs/ja/integrations/clickpipes/mysql/index.md) を使用して、Amazon Aurora MySQL から ClickHouse Cloud にデータをレプリケートするよう設定する方法を説明します。MySQL CDC (変更データキャプチャ) に関するよくある質問については、[MySQL よくある質問ページ](https://clickhouse.com/docs/ja/integrations/clickpipes/mysql/faq.md) を参照してください。

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

バイナリログは、MySQL サーバーインスタンスで行われたデータ変更に関する情報を含む一連のログファイルであり、レプリケーションにはバイナリログファイルが必要です。Aurora MySQL でバイナリログ保持を設定するには、[バイナリログを有効にし](#enable-binlog-logging)、[binlog の保持期間を延長する](#binlog-retention-interval)必要があります。

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

自動バックアップ機能によって、MySQL でバイナリログを有効にするかどうかが決まります。自動バックアップは、RDS Console で **Modify** > **Additional configuration** > **Backup** に移動し、**Enable automated backups** チェックボックスを選択することで (まだ選択されていない場合) インスタンスに設定できます。

![Aurora で自動バックアップを有効にする](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)

レプリケーションのユースケースに応じて、**Backup retention period** は十分に長い値に設定することを推奨します。

**2. binlog の保持期間を延長する**

> [!WARNING]
>
> ClickPipes がレプリケーションの再開を試みた際、設定された binlog の保持期間が原因で必要な binlog ファイルがすでに削除されていると、ClickPipe はエラー状態になり、再同期が必要になります。

デフォルトでは、Aurora MySQL はバイナリログをできるだけ早く削除します (つまり、*遅延パージ*) 。障害発生時でもレプリケーションに必要な バイナリログ ファイルを利用できるようにするため、binlog の保持期間は少なくとも **72 時間** に延長することを推奨します。バイナリログ の保持期間 ([`binlog retention hours`](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/mysql-stored-proc-configuring.html#mysql_rds_set_configuration-usage-notes.binlog-retention-hours)) を設定するには、[`mysql.rds_set_configuration`](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/mysql-stored-proc-configuring.html#mysql_rds_set_configuration) プロシージャを使用します。

[//]: # "注: 多くの CDC（変更データキャプチャ）プロバイダーは、Aurora RDS の最大保持期間（7 日間 / 168 時間）を推奨しています。これはディスク使用量に影響するため、ここでは控えめに最小 3 日間 / 72 時間を推奨しています。"

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

この設定がされていない、または間隔が短すぎると、バイナリログに欠落が生じ、ClickPipes がレプリケーションを再開できなくなるおそれがあります。

## binlog 設定を構成する

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

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

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

パラメータグループのリンクをクリックすると、その詳細ページに移動します。右上に **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)

以下のパラメータを次のように設定する必要があります。

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

![Binlog フォーマットを 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 行メタデータ](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 行イメージ](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** をクリックします。変更を反映するには、インスタンスの再起動が必要な場合があります。Aurora インスタンスの **Configuration** タブで、パラメータグループのリンクの横に `Pending reboot` と表示されていれば、それが目印です。

## GTID モードを有効にする (推奨)

> [!TIP]
>
> MySQL ClickPipe は、GTID モードを使用しないレプリケーションにも対応しています。ただし、パフォーマンス向上とトラブルシューティングのしやすさのため、GTID モードを有効にすることを推奨します。

[Global Transaction Identifiers (GTIDs)](https://dev.mysql.com/doc/refman/8.0/en/replication-gtids.html) は、MySQL でコミットされた各トランザクションに割り当てられる一意の ID です。これにより、binlog レプリケーションが簡素化され、トラブルシューティングもしやすくなります。MySQL ClickPipe が GTID ベースのレプリケーションを使用できるようにするため、GTID モードを有効にすることを**推奨**します。

GTID ベースのレプリケーションは、Amazon Aurora MySQL v2 (MySQL 5.7) および v3 (MySQL 8.0) 、ならびに Aurora Serverless v2 でサポートされています。Aurora MySQL インスタンスで GTID モードを有効にするには、次の手順に従ってください。

1. RDS Console で、MySQL インスタンスをクリックします。
2. **Configuration** タブをクリックします。
3. パラメータグループのリンクをクリックします。
4. 右上の **Edit** ボタンをクリックします。
5. `enforce_gtid_consistency` を `ON` に設定します。
6. `gtid-mode` を `ON` に設定します。
7. 右上の **Save Changes** をクリックします。
8. 変更を反映するため、インスタンスを再起動します。

![GTID が有効](https://mintcdn.com/private-7c7dfe99/KW34O4k4cC0oxlHH/images/integrations/data-ingestion/clickpipes/mysql/enable_gtid.webp?fit=max\&auto=format\&n=KW34O4k4cC0oxlHH\&q=85\&s=3e5f43eadc040115889be1aff97bcd4a)

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

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

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

   ```sql theme={null}
   CREATE USER 'clickpipes_user'@'%' 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認証を使用する (任意)

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

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

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

![Aurora MySQL でセキュリティグループはどこで確認できますか？](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 経由のプライベートアクセス

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

## 次のステップ

Amazon Aurora MySQL インスタンスで binlogレプリケーションが設定され、ClickHouse Cloud への安全な接続が確立されたら、[最初の MySQL ClickPipe を作成できます](https://clickhouse.com/docs/ja/integrations/clickpipes/mysql/index.md#create-your-clickpipe)。MySQL CDC (変更データキャプチャ) に関する一般的な質問については、[MySQL よくある質問ページ](https://clickhouse.com/docs/ja/integrations/clickpipes/mysql/faq.md)を参照してください。
