本記事では、データ移行タスク完了後にデータ検証を実行する方法について説明します。
使用制限
データ検証タスクの新規作成は、プロジェクトロールが プロジェクトオーナー、プロジェクト管理者、または データサービス管理者 のユーザーのみがサポートします。
対応するソースおよびターゲットデータベースの種類
ソース |
ターゲット |
|---|---|
| MySQL | OceanBase MySQL Compatible |
| OceanBase MySQL Compatible | MySQL |
| Oracle | OceanBase Oracle Compatible |
| OceanBase Oracle Compatible | Oracle |
| OceanBase MySQL Compatible | OceanBase MySQL Compatible |
| OceanBase Oracle Compatible | OceanBase Oracle Compatible |
| TiDB | OceanBase MySQL Compatible |
| PostgreSQL | OceanBase MySQL Compatible |
| PostgreSQL | OceanBase Oracle Compatible |
| Lindorm | OceanBase HBase API Compatible |
| HBase | OceanBase HBase API Compatible |
操作手順
データ検証タスクの新規作成ページにアクセスします。
OB Cloudクラウドデータベースコンソールにログインします。
左側のナビゲーションペインで、データサービス > データ検証 をクリックします。
データ検証 ページで、右上の タスクを作成する をクリックします。
タスク名を編集するテキストボックスに、カスタムの検証タスク名を入力します。
中国語、数字、英字の組み合わせを使用することをお勧めします。名前にはスペースを含めず、長さは64文字を超えないようにしてください。
ソースとターゲットを設定する ステップで、ソース エリアの各パラメータを設定します。
既に作成・保存されているデータソースを参照する必要がある場合、ソース の右側にある クイックフィル をクリックし、ドロップダウンリストから対象のデータソースを選択します。選択後、ソースエリアの設定は自動的に入力されます。現在の設定を新しいデータソースとして保存する場合は、ソース側 エリアの右上にある 保存 アイコンをクリックしてください。
また、クイックフィル のドロップダウンリストで データソースの管理 をクリックすると、データソース ページに移動し、データソースの表示や管理を行えます。この記事では異なる種類のデータソースを一元的に管理します。詳細については、データソースモジュールのドキュメントをご参照ください。
パラメータ説明クラウドベンダー 現在 AWS、Huawei Cloud、Tencent Cloud、Alibaba Cloud をサポートしています。 データベースタイプ 現在、ソース側では MySQL、Oracle、OceanBase MySQL Compatible、OceanBase Oracle Compatible、TiDB、PostgreSQL をサポートしています。実際のニーズに応じて選択してください。 インスタンスタイプ ページの指示に従って、該当するインスタンスタイプを選択します。 リージョン ソースデータベースのリージョンを選択します。 接続タイプ エンドポイント と パブリックIP が含まれます。データベースタイプが MySQL または Oracle の場合にのみ、このパラメータが表示されます。 接続情報 - 接続タイプ を エンドポイント に選択した場合は、エンドポイントサービス名を入力してください。
- 接続タイプ を パブリックIP に選択した場合は、データベースホストのIPアドレスとポート番号を入力してください。
Service Name OracleデータベースのService名です。データベースタイプが Oracle の場合にのみ、このパラメータが表示されます。 Database Name データベース名です。データベースタイプが PostgreSQL の場合にのみ、このパラメータが表示されます。 インスタンス ドロップダウンリストからOceanBaseインスタンスを選択します。データベースタイプが OceanBase MySQL Compatible および OceanBase Oracle Compatible の場合にのみ、このパラメータが表示されます。 テナント OceanBaseインスタンスを選択した後、ドロップダウンリストから使用するOceanBaseテナントを選択します。 データベースアカウント/パスワード ソースデータベースのアカウントとパスワードを入力します。 ソースとターゲットを設定する ステップで、ターゲット側 エリアの各パラメータを設定します。
既に作成・保存されているデータソースを参照する必要がある場合、ターゲット の右側にある クイックフィル をクリックし、ドロップダウンリストから対象のデータソースを選択します。選択後、ターゲットエリアの設定は自動的に入力されます。現在の設定を新しいデータソースとして保存する場合は、ターゲット エリアの右上にある 保存 アイコンをクリックしてください。
また、クイックフィル のドロップダウンリストで データソースの管理 をクリックすると、データソース ページに移動し、データソースの表示や管理を行えます。この記事では異なる種類のデータソースを一元的に管理します。詳細については、データソースモジュールのドキュメントをご参照ください。
パラメータ説明クラウドプロバイダ 現在、AWS、Huawei Cloud、Tencent Cloud、および Alibaba Cloud をサポートしています。ソースと同じクラウドプロバイダを選択することも、異なるクラウド間でデータ検証を行うこともできます。 説明
現在、クラウド間のデータ検証機能はデフォルトで有効になっていません。この機能を使用する場合は、OceanBase Cloudのテクニカルサポートにお問い合わせください。
データベースタイプ ソースのデータベースタイプに応じて、ターゲット側の対応するデータベースタイプを選択してください。 インスタンスタイプ ページの指示に従って、適切なインスタンスタイプを選択します。 リージョン ターゲットデータベースのリージョンを選択します。 接続タイプ エンドポイント と パブリックIP が含まれます。このパラメータは、データベースタイプが MySQL または Oracle の場合にのみ表示されます。 接続情報 - 接続タイプ を エンドポイント に設定した場合は、エンドポイントサービス名を入力してください。
- 接続タイプ を パブリックIP に設定した場合は、データベースホストのIPアドレスとポート番号を入力してください。
Service Name OracleデータベースのService名です。このパラメータは、データベースタイプが Oracle の場合にのみ表示されます。 インスタンス ドロップダウンリストからOceanBaseインスタンスを選択します。このパラメータは、データベースタイプが OceanBase MySQL Compatible および OceanBase Oracle Compatible の場合にのみ表示されます。 テナント OceanBaseインスタンスを選択した後、ドロップダウンリストから使用するOceanBaseテナントを選択します。 データベースアカウント/パスワード ターゲットデータベースのアカウントとパスワードを入力します。 テストして続行 をクリックします。
タイプとオブジェクトを選択してください ステップで、現在のデータ検証タスクの検証タイプを選択します。
現在サポートされている検証タイプは、完全な検証 と 行数の検証 です。詳細については、データ検証の概要をご参照ください。
検証オブジェクト セクションで、検証オブジェクトの選択方法を設定します。
検証オブジェクトは、オブジェクトの指定 と ルールによる一致 の2つの方法で選択できます。
オブジェクトを選択してください セクションで、検証が必要なオブジェクトを選択します。
説明
現在、検証オブジェクトとしてテーブルのみを選択できます。
オブジェクトの指定 を選択した場合、左側で検証が必要なテーブルオブジェクトを選択し、> をクリックして右側のリストに追加します。
データ検証では、テキストをインポートしてオブジェクトを追加したり、ターゲット側のオブジェクトを名前変更したり、行フィルタリングを設定したり、列情報を表示したり、個別またはすべての検証オブジェクトを削除したりする操作がサポートされています。
操作説明オブジェクトのインポート 選択領域の右側のリストで、右上の インポート対象 をクリックします。詳細については、検証オブジェクトのインポートをご参照ください。 名前の変更 データ検証では、検証オブジェクトの名前を変更できます。詳細については、検証オブジェクトの名前変更をご参照ください。 行のフィルタリング 完全な検証 は WHERE条件を使用した行フィルタリングをサポートします。詳細については、SQL条件で検証オブジェクトをフィルタリングするをご参照ください。また、列を表示 セクションで、検証オブジェクトの列情報を確認できます。削除/すべてクリア データ検証では、データマッピング時に、一時的にターゲット側に選択された単一または複数のオブジェクトを削除する操作をサポートしています。 - 単一の移行オブジェクトの削除
選択領域の右側のリストで、対象オブジェクトの後ろにある 削除 アイコンをクリックすると、その移行オブジェクトを削除できます。 - すべての移行オブジェクトの削除
選択領域の右側のリストで、右上の すべてクリア をクリックします。ダイアログボックスで、OK をクリックすると、すべての移行オブジェクトが削除されます。
- 単一の移行オブジェクトの削除
ルールによる一致 を選択した場合、詳細については 検証オブジェクトのマッチングルールの設定をご参照ください。
次へ をクリックし、検証オプション ステップで、各パラメータを設定します。
フル検証
タイプとオブジェクトを選択してください ステップで、完全な検証 を選択した場合にのみ、以下のパラメータが表示されます。
パラメータ説明ソース側並列設定/ターゲット側並列設定 最小値は1、最大値は512、デフォルト値は4です。 検証モード アダプティブモード と INモード が含まれます。 - アダプティブモード:ソース側とターゲット側から同じ範囲のデータをバッチ処理で取得し、正確に比較します。
- INモード:ソース側から指定範囲のデータをバッチ処理で取得し、ターゲット側のデータの一意キーに基づいてターゲット側でIN条件検索を実行し、両側のデータが一致するかどうかを比較します。このモードでは、ターゲット側にソース側にないデータが存在する場合の検証や、検証パフォーマンスの低下が発生する可能性があるため、ターゲット側に想定された余分なデータが存在し検証が不要な場合、またはデータベース・テーブルの集約移行シナリオの場合にのみ使用することを推奨します。
BPSレートを制限するかどうか 単位はMiB/s、最大値は1024です。このボタンを有効にする場合は、少なくともソース側またはターゲット側のいずれか一方の最低レートを選択してください。 行数検証
タイプとオブジェクトを選択してください ステップで、行数の検証 を選択した場合にのみ、以下のパラメータが表示されます。
パラメータ説明並列検証テーブル数 最小値は1、最大値は100、デフォルト値は10です。この設定はソース側とターゲット側の両方に適用されます。 クエリタイムアウト時間 単位は分、最小値は1、最大値は1440、デフォルト値は10です。この設定はソース側とターゲット側の両方に適用されます。
次へ をクリックすると、システムはデータ検証タスクの事前チェックを実行します。
事前チェックに成功したら、タスクを開始する をクリックします。
一時的にタスクを開始する必要がない場合は、保存 をクリックしてデータ検証タスクの詳細ページに移動し、必要に応じて手動で開始できます。詳細については、データ検証タスクの詳細を見るをご参照ください。
データ検証タスクの設定ページにアクセスします。
OceanBase Cloudコンソールにログインします。
左側のナビゲーションペインで、データサービス > データ移行 をクリックします。
データ移行 ページで、データ移行 タブをクリックします。
データ移行 タブで、対象タスクの名前をクリックして詳細ページに進みます。
詳細ページの右上隅にある 検証タスクの設定 をクリックします。
注意
終了中 または 終了済み の状態にあるデータ移行タスクは、検証タスクの設定をサポートしていません。
タスク名を編集するテキストボックスに、カスタムの検証タスク名を入力します。デフォルトの名前
データ移行タスク名-verifyも使用できます。中国語、数字、英字の組み合わせを使用することを推奨します。名前にはスペースを含めることはできず、長さは64文字を超えてはなりません。
ソースとターゲットを設定する ステップで、各パラメータに誤りがないことを確認した後、テストして続行 をクリックします。
タイプとオブジェクトを選択してください ステップで、現在のデータ検証タスクの検証タイプを選択します。
現在サポートされている検証タイプは、完全な検証 と 行数の検証 です。詳細については、データ検証の概要をご参照ください。
検証オブジェクト 領域で、検証対象の選択方法を設定します。
検証対象の選択方法には、オブジェクトの指定 と ルールによる一致 があります。データ移行タスクで選択した対象の方法を維持することも、変更することもできます。
オブジェクトを選択してください 領域で、検証する対象を選択します。
説明
現在、検証対象として選択できるのはテーブルのみです。
検証対象は、データ移行タスクで選択した移行対象と一致させることも、実際の状況に応じて再選択することもできます。
データ検証タスクはデータベース全体の検証をサポートしていません。データ移行タスクでデータベース全体を選択した場合、データ検証タスクはそのデータベース内のすべてのテーブルオブジェクトを選択します。
オブジェクトの指定 を選択した場合、左側で検証するテーブルオブジェクトを選択し、> をクリックして右側のリストに追加します。
データ検証では、テキストをインポートしてオブジェクトを追加したり、ターゲット側のオブジェクト名を変更したり、行フィルターを設定したり、列情報を表示したり、単一またはすべての検証対象を削除したりする操作をサポートしています。
操作説明オブジェクトのインポート 選択領域の右側のリストで、右上の インポート対象 をクリックします。検証オブジェクトのインポートをご参照ください。 名前の変更 データ検証では、検証オブジェクトの名前を変更することができます。検証オブジェクトの名前の変更をご参照ください。 行フィルター 完全な検証 は WHERE条件による行フィルターをサポートしています。SQL条件で検証オブジェクトをフィルタリングするをご参照ください。また、列を表示 セクションで、検証オブジェクトの列情報を確認できます。すべての移動/削除 データ検証では、データマッピング時に、一時的にターゲット側に選択された単一または複数のオブジェクトを移動する操作をサポートしています。 - 単一の移行オブジェクトの移動
選択領域の右側のリストで、ターゲットオブジェクトの後ろにある 削除 アイコンをクリックすると、その移行オブジェクトを移動できます。 - すべての移行オブジェクトの移動
選択領域の右側のリストで、右上の すべてクリア をクリックします。ダイアログボックスで、OK をクリックすると、すべての移行オブジェクトが移動されます。
- 単一の移行オブジェクトの移動
ルールによる一致 を選択します。検証オブジェクトのマッチングルールの設定をご参照ください。
次へ をクリックし、検証オプション ステップで、各パラメータを設定します。
フル検証
タイプとオブジェクトを選択してください ステップで、完全な検証 を選択した場合にのみ、以下のパラメータが表示されます。
パラメータ説明ソース側並列設定/ターゲット側並列設定 最小値は1、最大値は512、デフォルト値は4です。 検証モード アダプティブモード と INモード が含まれます。 - アダプティブモード:ソース側とターゲット側から同じ範囲のデータをバッチ処理で取得し、正確に比較します。
- INモード:ソース側から指定範囲のデータをバッチ処理で取得し、ターゲット側データの一意キーに基づいてターゲット側でIN条件でクエリを実行し、両側のデータが一致するかどうかを比較します。このモードでは、ターゲット側にソース側にないデータが存在する場合や、検証性能が低下する可能性があるため、検証不要な予期された余分なデータがターゲット側に存在する場合、またはデータベース・テーブルの集約移行シナリオでのみ使用することを推奨します。
BPSレートの制限 単位はMiB/s、最大値は1024です。このボタンを有効にする場合は、少なくともソース側またはターゲット側のいずれか一方の最低レートを選択してください。 行数検証
タイプとオブジェクトを選択してください ステップで、行数の検証 を選択した場合にのみ、以下のパラメータが表示されます。
パラメータ説明並列検証テーブル数 最小値は1、最大値は100、デフォルト値は10です。この設定はソース側とターゲット側の両方に適用されます。 クエリタイムアウト時間 単位は分、最小値は1、最大値は1440、デフォルト値は10です。この設定はソース側とターゲット側の両方に適用されます。
次へ をクリックすると、システムはデータ検証タスクの事前チェックを実行します。
事前チェックに成功したら、タスクを開始する をクリックします。
一時的にタスクを開始する必要がない場合は、保存 をクリックしてデータ検証タスクの詳細ページに移動し、必要に応じて手動で開始できます。データ検証タスクの詳細を見るをご参照ください。