MySQL: サポートされているデータ型、オブジェクトおよび操作

この項では、MySQL Database上のOracle GoldenGateのサポート情報について説明します。

Oracle GoldenGate for MySQLでは、ソース・データのマッピング、フィルタリングおよび変換がサポートされており、このドキュメントで特に明記されている場合を除き、Oracle GoldenGateでサポートされている他のソース・データベースから導出されたデータのMySQLデータベースへのレプリケーションもサポートされます。

Oracle GoldenGate for MySQLでサポートされるデータ型

Oracle GoldenGate for MySQLでは、次のデータ型がサポートされています。

• BLOB

• BIGINT

• BINARY

• BIT(M)

• CHAR

• DATE

• DATETIME

• DECIMAL

• DOUBLE

• ENUM

• FLOAT

• INT

• JSON

• LONGBLOB

• LONGTEXT

• MEDIUMBLOB

• MEDIUMINT

• MEDIUMTEXT

• SMALLINT

• TEXT

• TIME

• TIMESTAMP

• TINYBLOB

• TINYINT

• TINYTEXT

• VARBINARY

• VARCHAR

• VECTOR

• YEAR

制限事項および説明

Oracle GoldenGate for MySQLの実行時には、次の点に注意する必要があります。

• ファンクション索引は、取得または配信ではサポートされていません。

• Oracle GoldenGateでは、BLOB型またはTEXT型が主キーとして使用される場合はサポートされません。

• Oracle GoldenGateでは、TIME型の範囲が00:00:00から23:59:59までサポートされます。

• Oracle GoldenGateでは、0001/01/03:00:00:00から9999/12/31:23:59:59のタイムスタンプ・データをサポートします。タイムスタンプがGMTからローカル時間に変換されると、これらの制限も結果のタイムスタンプに適用されます。タイムゾーンに応じて、変換により時間が追加または引かれる場合があり、これにより、タイムスタンプがサポートされている上限を超えたり、下回ったりすることがあります。

• Oracle GoldenGateでは、マイナスの日付はサポートされていません。

• 浮動小数点数の範囲および精度のサポートは、ホスト・マシンによって異なります。一般的に、精度は16桁まで正確ですが、想定される近似を判断するにはデータベースのドキュメントを確認してください。Oracle GoldenGateでは、サポートされている精度を超える値は丸めされるか切り捨てられます。

• ENUM型を非strictのsql_modeで使用すると、非strictのsql_modeでは無効なENUM値の入力が防止されず、エラーが返されます。この状況を回避するには、次のいずれかの操作を行います。

  • sql_modeをSTRICTとして使用して、Extractを再起動します。これによってユーザーはどのデータ型の無効な値も入力できなくなります。IEユーザーはデータ型の有効な値のみを入力できます。

  • 非strictのsql_modeを引き続き使用しますが、ENUMデータ型は使用しません。

  • 非strictのsql_modeを引き続き使用し、データベースの有効な値でENUMデータ型を使用します。無効な値を指定した場合、データベースではそのまま受け入れられますがExtractは異常終了します。

• JSONデータ型では、単一列の表はサポートされていません。JSONデータ型の単一列を持つ表に対して構成されている場合、Extractは異常終了します。

• JSONデータ型はCDRをサポートしていません。GETBEFORECOLSが構成され、表にJSONデータ型の列がある場合、次のメッセージがレポート・ファイルに記録されます。

  INFO OGG-06556 The following columns will not be considered for CDR

  CDR制限事項は、GETBEFORECOLSとCOMPARECOLSが使用される場合に適用されます。

• MySQL Extractは異常終了せず、表定義で定義されていないENUM列の値を'invalid_enum'として処理します。

サポートされていないMySQLデータ型

Oracle GoldenGate for MySQLでは、次のデータ型はサポートされていません。

すべての空間型(GEOMETRYなど)およびSET。

MySQLでは、次のGEOMETRY型はすべてサポートされていません。

• POINT

• ライニング

• POLYGON

• マルチポイント

• マルチネストリング

• 複数ポリゴン

• GEOMCOLLECTION ノート: Extractは、サポートされていないデータ・タイプのいずれかを含む表からキャプチャするように構成されている場合には異常終了するため、Extractがサポートされないデータ型の列を含む表からキャプチャするように構成されていないことを確認します。

MySQLについてサポートされているオブジェクトおよび操作

Oracle GoldenGate for MySQLでは、次のオブジェクトおよび操作がサポートされています。

• Oracle GoldenGateでは、ソースおよびターゲット・データベースのトランザクション表に対する次のDML操作がサポートされます。

  • 挿入演算

  • 更新操作(圧縮を含む)

  • 削除操作(圧縮を含む)

  • 切捨て操作

• Oracle GoldenGateでは、DDL (データ定義言語)操作の抽出およびレプリケーションがサポートされます。

• Oracle GoldenGateでは、MySQLおよび使用されるデータベース・ストレージ・エンジンでサポートされる行の最大サイズおよび列の最大数を上限に、トランザクション表がサポートされます。InnoDBでは、最大1017列がサポートされます。

• Oracle GoldenGateでは、生成された列の抽出がサポートされています。

• レプリケーションはMySQL Generated列に対して許可されないため、すべてのソースGenerated列データをGenerated以外の列にマップする必要があります。

• Oracle GoldenGateでは、AUTO_INCREMENT列属性がサポートされます。Extractによって増分値がバイナリ・ログからキャプチャされて、Replicatの挿入操作でターゲット表に適用されます。

• Oracle GoldenGateでは、MySQLネイティブ・レプリケーションとの同時操作が可能です。

• Oracle GoldenGateでは、MySQLのDYNSQL機能がサポートされます。

ノート: XAトランザクションは取得でサポートされておらず、binlogに記録されたXAトランザクションがExtractを異常終了します。したがって、取得するためにExtractが構成されているデータベースに対してXAトランザクションを使用しないでください。Oracle GoldenGate取得用に構成されていないデータベースに対してXAトランザクションが使用されている場合は、MySQLサーバー構成ファイルのパラメータbinlog-ignore-dbを使用して、それらのデータベースをMySQLバイナリ・ログへのロギングから除外します。

自動ハートビート表のサポートに関する制限事項は次のとおりです。

• ハートビート表の追加時のエラーを回避するため、ハートビート表の作成先のデータベースがすでに存在することを確認します。

• ハートビート履歴遅延ビューで、heartbeat_received_ts、incoming_heartbeat_age、outgoing_heartbeat_ageなどのフィールドの情報は、システム時間について示しています。オペレーティング・システム時間に現在の正確なタイムゾーン情報が設定されていることを確認する必要があります。

• ファイルの終わり(EOF)による位置指定は、MySQLでサポートされています。Oracle GoldenGate Extract for MySQLの場合は、ファイルの末尾に対応する位置が検出され、そこからトランザクションの読取りが開始されます。データがバイナリ・ログに対して継続的に書き込まれている場合、EOFの位置は正確ではありません。

  Extractは、次を使用して追加および変更されます。

  ADD EXTRACT *group_name*, TRANLOG, EOF

  ALTER EXTRACT *group_name*, EOF

MySQL DDLのオブジェクトと操作のサポートの詳細

DDL操作のキャプチャとレプリケーションについて、Oracle GoldenGateでサポートされるMySQLオブジェクトと操作タイプのリストを次に示します。

• MySQLのためのDDLレプリケーションは、ソースとターゲットがMySQLデータベースである間でのみサポートされています。

• DDL操作の抽出およびレプリケーションは、MySQL 8.0以上でサポートされています。サポートされているDDL操作は次のとおりです。

  • CREATE TABLE (CREATE TABLE AS SELECTを除く)

  • DROP TABLE

  • TRUNCATE TABLE (GETTRUNCATESを使用したサポート)

  • ALTER TABLE TRUNCATE PARTITION

  • ALTER TABLE ADD COLUMN

  • ALTER TABLE ADD COLUMN AFTER

  • ALTER TABLE DROP COLUMN

  • ALTER TABLE MODIFY COLUMN (COLUMN_NAME, TYPE, SIZE)

  • ALTER TABLE ADD (constraints) PRIMARY KEY

  • ALTER TABLE DROP PRIMARY KEY

• MySQL 8.0では、ローカルおよびリモートDDLキャプチャがサポートされています。

• TRUNCATE操作は、GETTRUNCATES ExtractおよびReplicatパラメータを介してDMLとしてサポートされているため、MySQL DDLサポート用にOracle GoldenGateを構成する必要はありません。

• DDLレプリケーションは、Oracle GoldenGateの双方向構成ではサポートされていません。

• DDLレプリケーションは、binlog_row_metadataデータベース設定をFULLに設定できないクラウド・ベースのデータベース・サービスではサポートされていません。

MySQLについてサポートされていないオブジェクトおよび操作

Oracle GoldenGate for MySQLでは次のオブジェクトおよび操作がサポートされていません。

• Invisible列

• Replicat用のOracle GoldenGateのBATCHSQL機能。

• 次の文字セットはサポートされていません。

  • ULIB_CS_ARMSCII8、 /*アメリカ国民166-9 */

  • ULIB_CS_GEOSTD8、/* Geogian Standard */

  • ULIB_CS_KEYBCS2、/* Kemennicky MS-DOS

• FETCHMOCOLSおよびFETCHMODCOLEXCEPT TABLEオプションを使用したNLS LOBデータの取得は、DDLが有効な場合はサポートされません。

• 表の名前を変更しています。

• ストアド・プロシージャ内部のDDL文はサポートされません。

• Oracle GoldenGateインストール・サーバーのタイムゾーンがソース・データベース・サーバーのタイムゾーンと一致しない場合、ターゲット・データベースに送信されるTIMESTAMデータはソース・データベースとは異なります。Oracle GoldenGate Microservicesインストールの場合、タイムゾーンが同一かどうかに関係なく、ExtractはタイムゾーンをUTCに解決します。次の問合せを実行して、ソース・データベースのタイムゾーンを確認します。

  select @@system_time_zone;

  これにより、PDTなどのタイムゾーン値が返されます。

  TZというソースExtractを含む変数をデプロイメントに作成し、ソース・データベースのタイムゾーンの値に設定します。その後、実行中のOracle GoldenGateプロセスを停止し、管理サービスを再起動してから、ExtractおよびReplicatを起動します。

• ビューとの間の抽出およびレプリケーションはサポートされていません。

• スレーブによって適用されるトランザクションのログは、スレーブのbinlogではなくリレイ・ログに記録されます。スレーブがマスターから受け取るトランザクションをbinlogに書き込むには、my.cnfでログslave-updatesオプションを1に指定して、レプリケーション・スレーブを起動する必要があります。これ以外に、他のバイナリ・ログ・パラメータも設定する必要があります。マスターのトランザクションがスレーブのbinlog内にあると、スレーブのbinlogを取得および処理するためにスレーブに定期的な取得を設定できます。

SingleStoreDBのオブジェクトおよび操作の制限

Oracle GoldenGate for MySQLでは、SingleStoreDBおよびSingleStoreDB Cloudをサポートするようになりましたが、次の制限があります。

• ベース表のみが書込み可能であるため、SingleStoreDB内のビューへのレプリケーションはサポートされていません。

• SHARDキーの一部である列の更新はサポートされていません。

• 明示的なSHARDキーのない表での主キーの更新はサポートされていません。これは、この状況ではSingleStoreDBによって主キーがSHARDキーとして割り当てられ、SHARDキー列の更新が許可されないためです。

• 複数のパーティションにまたがる主キーまたは一意キーのないSingleStoreDB表に対するReplicatのDBOPTIONS LIMITROWS動作はサポートされていません。

• DBOPTIONS LIMITROWSおよびNOLIMITROWSパラメータ・オプションは、SingleStoreDBではサポートされていません。

• SingleStoreDBはデータベース間トランザクションをサポートしていません。つまり、Replicatは単一のスキーマ/データベースへのマッピングのみをサポートできます。これにはチェックポイント表とハートビート表のマッピングが含まれるため、これらのオブジェクトは、レプリケートするユーザー表と同じスキーマ/データベースの下に作成する必要があります。

システム・スキーマ

次のスキーマまたはオブジェクトは、ワイルドカードなしで明示的に指定した場合を除いて、Oracle GoldenGateによる自動レプリケートは実行されません。

• MySQL

  • 'information_schema'

  • 'performance_schema'

  • 'mysql'

  • 'sys'

• SingleStore

  • 'information_schema'

  • 'cluster'

  • 'memsql'