スキーマ変更の伝播サポート

ClickPipes がソーステーブルで検出できるスキーマ変更の種類を説明するページ

MySQL 向け ClickPipes では、ソーステーブルのスキーマ変更を検出でき、場合によってはその変更を宛先テーブルに自動で伝播できます。各 DDL 操作の扱いは以下のとおりです。

スキーマ変更の種類	挙動
新しいカラムの追加 (ALTER TABLE ADD COLUMN ...)	自動的に伝播されます。新しいカラムは、スキーマ変更後にレプリケートされたすべての行に追加されます
デフォルト値付きの新しいカラムの追加 (ALTER TABLE ADD COLUMN ... DEFAULT ...)	自動的に伝播されます。新しいカラムは、スキーマ変更後にレプリケートされたすべての行に追加されますが、既存の行には、テーブル全体を再読み込みしない限りデフォルト値は反映されません
既存カラムの削除 (ALTER TABLE DROP COLUMN ...)	検出はされますが、伝播はされません。削除されたカラムには、スキーマ変更後にレプリケートされたすべての行で NULL が入ります

現在、スナップショット中のカラム追加はサポートされていません。推奨される回避策は、予定しているスキーマ変更の前後でスナップショットを実行することです。また、ClickPipe がすでに失敗している場合は、適切な型のカラムを宛先テーブルに手動で追加してください。

​

MySQL 5.x の制限事項

8.0.1 より前の MySQL バージョンでは、binlog に完全なカラムメタデータ (binlog_row_metadata=FULL) が含まれないため、ClickPipes はカラムを順序位置で追跡します。つまり、次のようになります。

• 末尾へのカラム追加 (ALTER TABLE ADD COLUMN ...) はサポートされます。
• カラム位置がずれる DDL は、順序位置に基づく確実な対応付けができなくなるため、パイプでエラーになります。これには以下が含まれます。
  • ALTER TABLE DROP COLUMN ...
  • ALTER TABLE ADD COLUMN ... AFTER ... / FIRST
  • ALTER TABLE MODIFY COLUMN ... AFTER ... / FIRST
  • ALTER TABLE CHANGE COLUMN ... AFTER ... / FIRST

このエラーが発生した場合は、パイプを再同期する必要があります。