Snowflake Connector for MySQL の特徴¶

重要

MySQL 用Snowflakeコネクタにご興味をお持ちいただきありがとうございます。現在、大幅に改善されたエクスペリエンスを提供する次世代のソリューションに焦点を当てています。したがって、このコネクタを一般提供ステータスに移行することは、現在の製品ロードマップにはありません。このコネクタはプレビュー機能として引き続き使用できますが、将来のバグ修正および改善のサポートは保証されないことに注意してください。新しいソリューションは :doc:` MySQL 用Openflowコネクタ</user-guide/data-integration/openflow/connectors/mysql/about>` として利用可能で、より優れたパフォーマンス、カスタマイズ性、強化された展開オプションが含まれます。

バージョンサポート¶

一般的なポリシーでは、 Snowflake Connector for MySQL は公式にサポートされているすべての MySQL 長期サポート（LTS）バージョンをサポートします。ユーザーが新しいバージョンに移行するにつれて、古いバージョンのサポートを段階的に終了し、新しいバージョンがリリースされたらそのサポートを発表する予定です。

コネクタはさまざまな MySQL クラウドフレーバーをサポートしていますが、その一部には追加設定が必要です。Snowflake Connector for MySQL データソースの前提条件をご参照ください。

次のテーブルは、テスト済みおよび公式にサポートされているバージョンです。

公式にサポートされている PostgreSQL バージョンのリスト¶
	8.0	8.4
標準	有り	有り
AWS RDS	有り
Amazon Aurora	有り、バージョン3として
GCP Cloud SQL	有り	有り
Azure Database	無し

サーバー設定¶

コネクタが正しく動作するには、 MySQL サーバーで以下の設定を確認し、調整してください。

`log_bin`	`on` に設定。これにより、構造やデータの変更を記録するバイナリログが有効になります。
`binlog_format`	`row` に設定。コネクタは行ベースの複製のみをサポートします。MySQL 8.xバージョンがこの設定をサポートする最後のバージョンとなる可能性があり、将来のバージョンでは行ベースの複製のみがサポートされます。 GCP クラウド SQL では適用されません。正しい値に固定されています。
`binlog_row_metadata`	`full` に設定。コネクタが動作するためには、すべての行メタデータが必要で、最も重要であるのは列名と主キー情報です。
`binlog_row_image`	`full` に設定。コネクタは、すべての列がバイナリログに書き込まれていることを要求します。 Amazon Auroraでは適用されません。正しい値に固定されています。
`binlog_row_value_options`	空のままにする。このオプションは JSON 列にのみ影響し、 `UPDATE` ステートメントに対して、 JSON ドキュメントの変更部分のみを含めるように設定できます。コネクタは、完全なドキュメントがバイナリログに書き込まれていることを要求します。
`binlog_expire_logs_seconds`	少なくとも数時間以上設定して、データベースエージェントが延長された一時停止やダウンタイム後に増分複製を継続できるようにします。スケジュール複製を使用している場合は、構成されたスケジュールよりも長い値を指定する必要があります。

バイナリログ¶

MySQL のバイナリログは、有効にすると、指定されたインスタンス内の すべての テーブルから変更を収集します。テーブルまたは列を除外する方法はありません。したがって、コネクタはデータベース内のすべてのテーブルから変更を受信し、データベースエージェントは、複製用に構成するテーブルからの変更を処理しますが、他のすべてのテーブルへの変更は破棄します。

すべての変更には、まずデータベースエージェントがロードする必要があり、また BLOB 列の更新など一部の**特に大規模な変更**には、複製用に構成されていないテーブルで作成された場合でも、データベースエージェントのメモリを使い果たし、クラッシュする可能性があります。データベースに特に大きな値を格納する場合は、データベースエージェントとそのコンテナに十分なメモリが構成することを確認してください。

トランザクションサイズ は、 `MySQLの複製制限<https://dev.mysql.com/doc/refman/8.4/en/group-replication-limitations.html#group-replication-limitations-transaction-size>`_ によって4 GB 未満に制限されます。トランザクションが制限を超えると、影響を受けるテーブルの複製が永久に失敗します。

エージェント認証¶

現在サポートされている認証方法は、ユーザー名とパスワードのみです。データベースエージェントの構成のすべてのデータソースエントリには、独自の認証情報のセットが含まれており、これらはデータソースごとに異なる場合があります。

データベースエージェントのユーザーには、次の権限の付与が必要です。

すべてのスキーマとテーブルに対する REPLICATION SLAVE
すべてのスキーマとテーブルの REPLICATION CLIENT
すべてのスキーマおよびすべてのテーブルに対する SELECT

データベースエージェントのユーザーを作成する方法については、必要なユーザーを作成するをご参照ください。