Snowflake Connector for MySQL 特性¶

注釈

Snowflake Connector for MySQL はコネクタ規約に従います。

バージョンサポート¶

当社の一般的なポリシーでは、 Snowflake Connector for MySQL は公式にサポートされている MySQL Long-Term Support（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 の複製制限によって4 GB 以下に制限されます。トランザクションが制限を超えると、影響を受けるテーブルの複製は永久に失敗します。

エージェント認証¶

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

データベースエージェントのユーザーには以下の付与が必要です。

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

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