すべてのプロダクト
Search
ドキュメントセンター

ApsaraDB for OceanBase:同期オブジェクトとそのフィルタ条件を表示および変更する

最終更新日:Jun 26, 2025

このトピックでは、データ伝送サービスを使用して、構成済みのデータ同期タスクの同期オブジェクトを表示および変更し、これらのオブジェクトの SQL フィルタ条件を変更する方法について説明します。

背景

指定された制限内で同期中に同期オブジェクトを追加または削除し、そのフィルタ条件を変更できます。変更内容は記録されます。オブジェクト追加タスクが完了すると、関連付けられた元のタスクと統合されます。統合が完了すると、元のタスクは正常に実行され、オブジェクト追加タスクは自動的に解放されます。

一致ルールに基づいて選択された同期オブジェクトを変更し、これらのオブジェクトの SQL フィルタ条件を変更する方法については、「一致ルールの構成と変更」をご参照ください。

制限事項

  • 開始されていません実行中、または 一時停止 状態のデータ同期タスクの場合、その同期オブジェクトを追加または削除できます。

    重要

    [一時停止] 状態のデータ同期タスクの場合、タスクの [増分同期] ステップも [一時停止] 状態の場合、同期オブジェクトを追加することはできません。

  • 失敗 状態のデータ同期タスクの場合、その同期オブジェクトを追加することはできません。

  • 変更中 または 統合中 状態のデータ同期タスクの場合、その同期オブジェクトを再度変更することはできません。

  • データ同期タスクの 増分同期 ステップが 一時停止 または 失敗 状態の場合、同期オブジェクトを追加することはできません。

  • 一時停止失敗開始されていません、または 実行中 状態のデータ同期タスクの場合、行フィルタ条件を変更できます。

同期オブジェクトの表示

  1. ApsaraDB for OceanBase コンソール にログオンします。

  2. 左側のナビゲーションウィンドウで、データ伝送 > データ同期 を選択します。

  3. データ同期 ページで、ターゲットタスクの名前をクリックして詳細ページに移動します。

    image.png

  4. 右上隅にある [オブジェクトの表示] をクリックし、[同期オブジェクト] タブと [オブジェクトの変更] タブの情報を確認します。

    • [同期オブジェクト] タブには、現在のタスクの同期オブジェクトが表示されます。[オブジェクトの追加] または オブジェクトの削除 をクリックして、オブジェクトを追加または削除し、行フィルタ条件を変更できます。

    • [オブジェクトの変更] タブには、すべてのオブジェクト変更のタイプ、ステータス、および発生時刻が表示されます。

同期オブジェクトの追加

  1. ターゲットタスクの詳細ページで、右上隅にある [オブジェクトの表示] をクリックします。

    image.png

  2. [オブジェクトの表示] ダイアログボックスで、同期オブジェクト > オブジェクトの追加 を選択します。

    image.png

  3. オブジェクトの追加 ダイアログボックスで、追加する同期オブジェクトを選択します。

    重要
    • デフォルトでは、新しく追加された同期オブジェクトは、元のデータ同期タスクのすべての構成オプションを継承します。オブジェクト追加操作を中止した場合、ターゲットデータベースに追加されたオブジェクトを手動で削除する必要があります。

    • ソースデータソースにスキーマ名またはデータベース名を指定した場合、指定したスキーマ名またはデータベース名の下にある同期オブジェクトのみを追加できます。

    • データ同期タスクのターゲットがメッセージキューの場合、オブジェクトの追加 ダイアログボックスで、左側の ソースオブジェクト セクションで同期オブジェクトを選択し、> をクリックして右側のリストに追加します。オブジェクトをトピックにマップ ダイアログボックスで、必要に応じてマッピング方法を選択します。

      image.png

      追加する同期オブジェクトを選択した後、トピックの変更、行フィルタの設定、オブジェクトの削除などの操作を実行できます。

      image.png

    • データ同期タスクのターゲットがデータベースの場合、オブジェクトの追加 ダイアログボックスで、左側の ソースオブジェクト セクションで同期オブジェクトを選択し、> をクリックして右側のリストに追加します。

      image

      追加する同期オブジェクトを選択した後、ターゲットオブジェクトの名前変更、行フィルタの設定、オブジェクトの削除などの操作を実行できます。

      image

  4. [次へ] をクリックします。

  5. システムは、追加された移行オブジェクトに対して自動的に事前チェックを実行します。追加された同期オブジェクトがすべてのチェック項目に合格したら、[保存] をクリックします。

  6. 情報を確認し、表示されるダイアログボックスで [OK] をクリックします。

    • 一時停止または失敗したデータ同期タスクの場合、操作をキャンセルして同期オブジェクトを再度変更できます。追加された同期オブジェクトは、データ同期タスクが正常に戻った後にのみターゲットデータベースに移行されます。

    • 実行中のデータ同期タスクに同期オブジェクトを追加する場合、保存 をクリックした後、追加された同期オブジェクトはすぐにターゲットデータベースに同期されます。

    オブジェクト追加操作が開始されると、対応するレコードが生成されます。レコードの詳細を表示するには、タスクの詳細ページで [オブジェクトの表示] をクリックし、オブジェクトの変更 タブをクリックします。

    image.png

    オブジェクト追加レコードのステータスは、保留中キャンセル済み変更中実行中中止統合中成功、または 失敗 です。オブジェクト追加レコードに対して実行できる操作と元のデータ同期タスクのステータスは、オブジェクト追加レコードのステータスによって異なります。

    説明

    元のデータ同期タスクが 開始されていません 状態の場合、オブジェクト追加操作に対して 成功 状態の変更レコードが生成されます。元のデータ同期タスクが 一時停止 状態の場合、オブジェクト追加操作に対して 保留中 状態の変更レコードが生成されます。

    オブジェクト追加レコードのステータスは、元のデータ同期タスクが 実行中 状態の場合にのみ変更され、元のタスクのステータスはオブジェクト追加レコードのステータスとともに変更されます。次の表で詳細を説明します。

    オブジェクト追加レコードのステータス

    サポートされている操作

    元のタスクのステータス

    保留中

    詳細を表示し、追加をキャンセルします。

    実行中

    キャンセル済み

    なし

    実行中

    変更中

    なし

    変更中

    実行中

    詳細を表示し、追加を中止します。

    変更中

    中止

    詳細を表示します。

    実行中

    統合中

    詳細を表示します。

    統合中

    成功

    詳細を表示します。

    実行中

    失敗

    詳細を表示し、追加を再試行します。

    [原因の表示] をクリックしてタスクの詳細ページに移動し、失敗の原因を表示することもできます。

    変更中または統合中

同期オブジェクトの削除

  1. ターゲットタスクの詳細ページで、右上隅にある [オブジェクトの表示] をクリックします。

    image.png

  2. ダイアログボックスで、同期オブジェクト > オブジェクトの削除オブジェクトの削除 を選択します。

    image.png

  3. オブジェクトの削除 ダイアログボックスで、右側の ターゲットオブジェクト セクションで削除する同期オブジェクトにカーソルを合わせ、[削除] をクリックします。

    image.png

    データ同期タスクのターゲットがメッセージキューの場合、複数の同期オブジェクトを選択して [一括削除] をクリックできます。表示されるダイアログボックスで、[OK] をクリックします。

    image.png

  4. オブジェクトの削除 ダイアログボックスで、[削除] をクリックします。

  5. 表示される確認ダイアログボックスで、削除する同期オブジェクトを確認し、[OK] をクリックします。

    タスクが 一時停止失敗、または 実行中 状態の場合、OK をクリックすると、同期オブジェクトはすぐにターゲットデータベースから削除されます。

    重要
    • 削除された同期オブジェクトは復元できません。慎重に行ってください。

    • オブジェクト削除操作の最終結果は、すべての同期オブジェクトに対して成功または失敗のいずれかになります。

    オブジェクト削除操作が開始されると、対応するレコードが生成されます。レコードの詳細を表示するには、タスクの詳細ページで [オブジェクトの表示] をクリックし、オブジェクトの変更 タブをクリックします。

    image.png

    オブジェクト削除レコードのステータスは、保留中キャンセル済み変更中成功、または 失敗 です。オブジェクト削除レコードに対して実行できる操作と元のデータ同期タスクのステータスは、オブジェクト削除レコードのステータスによって異なります。

    オブジェクト削除レコードのステータス

    サポートされている操作

    元のタスクのステータス

    保留中

    詳細を表示し、削除をキャンセルします。

    実行中

    キャンセル済み

    なし

    実行中

    変更中

    詳細を表示します。

    変更中

    成功

    詳細を表示します。

    実行中

    失敗

    詳細を表示し、削除を再試行します。

    [原因の表示] をクリックしてタスクの詳細ページに移動し、失敗の原因を表示することもできます。

    変更中

同期オブジェクトのフィルタ条件の変更

データ同期タスクの実行中に オブジェクトの指定 オプションを使用して選択された同期オブジェクトのデータをフィルタリングする SQL 条件を変更できます。

  1. ターゲットタスクの詳細ページで、右上隅にある [オブジェクトの表示] をクリックします。

    image.png

  2. [オブジェクトの表示] ダイアログボックスで、[同期オブジェクト] タブをクリックし、ターゲットスキーマを展開し、ターゲットオブジェクトにカーソルを合わせて、[設定] をクリックします。

    image

  3. [設定] ダイアログボックスの [行フィルタ] セクションで、標準 SQL WHERE 句を指定して行フィルタを構成または変更します。詳細については、「SQL 条件を使用したデータのフィルタリング」をご参照ください。

    image

  4. [構文の検証] をクリックします。

  5. 検証が成功したら、[設定] ダイアログボックスで [OK] をクリックします。

  6. 表示されるダイアログボックスで、[適用] をクリックして変更をオブジェクトに適用します。

  7. [オブジェクトの変更] タブで、変更の進行状況を表示します。

    image

    [詳細の表示] をクリックして [設定変更の詳細] ページに移動し、ターゲットデータテーブルにカーソルを合わせて、[設定の表示] をクリックして変更された行フィルタを表示することもできます。

    image