パラメータの確認と変更

本記事では、データ移行タスクのパラメータを確認し、変更する方法について説明します。

パラメータの確認

未購入、未起動、実行中、改訂中、マージ中、完了、および 構成変更中 の状態にあるデータ移行タスクのパラメータを確認できます。

1. OceanBase Cloudコンソールにログインします。

2. 左側のナビゲーションバーで、データサービス > データ移行 をクリックします。

3. データ移行 ページで、データ移行 タブをクリックします。

4. タスクリスト ページで、ターゲットタスクの後ろの ... > パラメータを表示 をクリックします。

   ターゲットタスクの名前をクリックして詳細ページに移動し、右上の パラメータを表示 をクリックすることもできます。

5. パラメータを表示 パネルで、現在のタスクの各設定を確認します。

パラメータの変更

変更が可能なパラメータ

未購入、未起動、一時停止中、および 失敗 ステータスのデータ移行タスクでは、パラメータの変更が可能です。ステータスによって、変更できるパラメータは異なります。

手順

1. OceanBase Cloudコンソールにログインします。

2. 左側のナビゲーションバーで、データサービス > データ移行 をクリックします。

3. データ移行 ページで、データ移行 タブをクリックします。

4. タスクリスト ページで、ターゲットタスクの後ろにある ... > パラメータの変更 をクリックします。

   ターゲットタスクの名前をクリックして詳細ページに移動し、右上の ... > パラメータの変更 をクリックすることもできます。

5. パラメータの変更 パネルで、業務ニーズに応じて変更を行います。

   • 構造移行

     OracleデータベースからOceanBaseデータベースのOracle互換モードテナントへのデータ移行タスクの タイプとオブジェクトの選択 ページで、構造移行 を選択し、かつデータ送信元とデータ送信先の文字セットが一致しない場合にのみ、以下のパラメータが表示されます。

     

     データ送信元とデータ送信先の文字セットが一致しない場合（例：データ送信元がGBK、データ送信先がUTF-8）、フィールドの切り捨てやデータの不整合が発生する可能性があります。文字タイプ長の倍率 を設定することで、文字型フィールドの長さを増やすことができます。

     注意

     拡張後の長さは、データ送信先の最大制限を超えてはなりません。

   • フル移行

     タイプとオブジェクトの選択 ページで、フル移行 を選択した場合にのみ、以下のパラメータが表示されます。

     

     パラメータ	説明
     読み取り同時実行設定	このパラメータは、フル移行段階でデータ送信元からデータを読み取る同時実行数を設定します。最大値は512です。同時実行数が高すぎると、データ送信元の負荷が過大になり、業務に影響を与える可能性があります。
     書き込み同時実行構成	このパラメータは、フル移行段階でデータ送信先にデータを書き込む同時実行数を設定します。最大値は512です。同時実行数が高すぎると、データ送信先の負荷が過大になり、業務に影響を与える可能性があります。
     全件移行レートの制限	実際のニーズに応じて、フル移行のレート制限を有効にするかどうかを決定できます。有効にする場合は、RPS（フル移行段階で1秒間にデータ送信先に移行できるデータ行数の最大値の制限）とBPS（フル移行段階で1秒間にデータ送信先に移行できるデータ量の最大値の制限）を設定してください。 説明 ここで設定されたRPSとBPSは、スロットリング機能としてのみ機能します。フル移行で実際に達成可能な性能は、データ送信元、データ送信先、インスタンス仕様の設定などの要因の影響を受けます。
     データ送信先テーブルに既にレコードがある場合の処理ポリシー	処理ポリシーには、移行停止 と 無視 が含まれます： 移行停止 を選択した場合、データ送信先のテーブルオブジェクトにデータが存在すると、フル移行はエラーとなり、移行は許可されません。データ送信先のデータを適切に処理してから、移行を続行してください。 注意 エラー発生後に再開をクリックすると、データ移行はこの構成オプションを無視し、テーブルデータの移行を続行します。ご注意ください。 無視 を選択した場合、データ送信先のテーブルオブジェクトにデータが存在し、元のデータと書き込むデータが競合すると、データ移行は競合データをログに記録し、元のデータを変更しないポリシーでデータを書き込みます。
     インデックスの遅延作成を許可	インデックスの作成をフル移行完了後に行うことで、移行の所要時間を短縮できます。ここでは、インデックスの作成を後回しにするかどうかを設定できます。注意事項は以下のとおりです。 注意 移行タイプの選択 ページで、スキーマ移行 と フル移行 を同時に選択している場合にのみ、このオプションの設定がサポートされます。 ユニークキーのインデックスは、作成を後回しにすることができません。

     インデックスの作成を後回しにする場合、OceanBaseデータベースのハードウェア条件と現在の業務トラフィック状況に基づき、CLIツールによる以下のテナントパラメータの調整を推奨します。

     // ファイルメモリバッファサイズの制限
     ALTER SYSTEM SET _temporary_file_io_area_size = '10' tenant = 'xxx';
     // OceanBaseデータベースV4.xのレート制限の無効化
     ALTER SYSTEM SET sys_bkgd_net_percentage = 100;
     

   • 増分同期

     タイプとオブジェクトの選択 ページで、増分同期 を選択した場合にのみ、以下のパラメータが表示されます。

     

     パラメータ	説明
     DML/DDL同期	増分同期 には DML同期 と DDL同期 が含まれます。必要に応じてカスタマイズ設定できます。詳細については、DML/DDLのカスタム設定を参照してください。
     書き込み同時実行数設定	このパラメータは、増分同期フェーズでデータ送信先にデータを書き込む同時実行数を設定します。最大制限は512です。同時実行数が高すぎると、データ送信先の負荷が過大になり、業務に影響を与える可能性があります。
     増分移行レートの制限	実際のニーズに応じて、増分同期レートの制限を有効にするかどうかを決定できます。有効にする場合は、RPS（増分同期フェーズで1秒間にデータ送信先に同期できるデータ行数の最大値の制限）とBPS（増分同期フェーズで1秒間にデータ送信先に同期できるデータ量の最大値の制限）を設定してください。 説明 ここで設定されたRPSとBPSは、速度と転送量の制限にのみ使用されます。増分同期が実際に達成できる性能は、データ送信元、データ送信先、インスタンス仕様の設定などの要因の影響を受けます。
     増分同期開始時点	移行タイプ選択時に フル移行 を選択した場合、このパラメータは表示されません。 移行タイプ選択時に フル移行 を選択せず、増分同期 を選択した場合は、ここで指定した時刻以降のデータを移行します。デフォルトは現在のシステム時刻です。詳細については、増分同期時点の設定を参照してください。 注意 双方向同期タスクのパラメータを変更する場合にのみ、このパラメータが表示されます。
     データ競合時の処理ポリシー	エラーを無視し、データ送信先の元のデータを維持する と 競合を無視し、データ送信元のデータでデータ送信先のデータを上書きする が含まれます。
     Binlog位置の定期更新	この機能を有効にする場合は、頻度を設定する必要があります。設定可能な頻度範囲は1〜60秒です。 設定完了後、データ移行は増分同期フェーズで、設定した頻度に基づいて、MySQLソースデータベースで定期的に CREATE DATABASE IF NOT EXISTS test コマンドを実行し、Binlog位置を更新します。 注意 このパラメータは、MySQLデータベースのデータをOceanBaseデータベースのMySQL互換モードテナントに移行する場合にのみ表示されます。
     Online DDLツールへの対応	この機能を有効にすると、データベースがOnline DDLツールを使用してオンラインのスキーマ変更を実行する際、データ移行は一時テーブルオブジェクトをフィルタリングし、データ移行タスクの安定性を向上させます。詳細については、Online DDLツールへの対応についてを参照してください。 注意 現在、Online DDLツールへの対応は、データ送信元がMySQLデータベースであり、Alibaba Cloud DMS、gh-ost、またはpt-oscを使用してオンラインのスキーマ変更操作を行うシナリオのみをサポートしています。

   • 詳細オプション

     データ送信先のOceanBaseデータベースがV4.3.0以降のバージョンであり、かつ パラメータの変更 ページで、増分同期 > DDL同期期間 を新たに選択した場合にのみ、このセクションのパラメータが表示されます。新規データ移行タスク作成時に既に データ送信先のテーブルストレージタイプ が設定されている場合は、こちらの変更はサポートされません。

     

     データ送信先のテーブルオブジェクトのストレージタイプには、デフォルト、行ストレージ、リスト、および 行列混合ストレージ が含まれます。この設定は、構造移行または増分同期時のデータ送信先のテーブルオブジェクトのストレージタイプを決定するために使用されます。

     説明

     デフォルト オプションは、データ送信先のパラメータに応じて他のオプションを適応させるものです。構造移行のテーブルオブジェクトや増分DDLで新規に追加されたテーブルオブジェクトは、設定されたストレージタイプに基づいて対応する構造が書き込まれます。

6. 変更完了後、保存 をクリックします。