検証タスクの新規作成|OceanBase Cloud|ドキュメント|OceanBaseマニュアル

本記事では、データ移行タスク完了後にデータ検証を行う方法について説明します。

制限事項

データ検証タスクの新規作成は、プロジェクトロールが プロジェクト所有者、プロジェクト管理者、または データサービス管理者 のユーザーのみが実行可能です。

対応するデータ送信元およびデータ送信先データベースの種類

データ送信元	データ送信先
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

操作手順

データ検証ページで新しいデータ検証タスクを作成する

データ移行タスクの詳細ページでデータ検証タスクを設定する

データ検証タスクの新規作成ページにアクセスします。
1. OceanBase Cloudコンソールにログインします。
2. 左側のナビゲーションバーで、データサービス > データ検証 をクリックします。
3. データ検証 ページで、右上の タスクを作成する をクリックします。
タスク名を編集するテキストボックスに、カスタムの検証タスク名を入力します。

数字、アルファベットの組み合わせを使用することを推奨します。名前にはスペースを含めず、長さは64文字を超えないようにしてください。

ソースとターゲットを設定する の手順で、ソース セクションの各パラメータを設定します。

既に作成・保存されたデータソースを参照する必要がある場合、クイック入力 ( ソース の右側) をクリックし、ドロップダウンリストから対象のデータソースを選択します。選択完了後、ソースエリアの各設定は自動的に入力されます。現在の設定を新しいデータソースとして保存する場合は、保存アイコン( ソース側 エリアの右上) をクリックしてください。

データソースの管理 ( クイック入力 のドロップダウンリスト内) をクリックすることもできます。これにより、データソース ページに移動し、データソースの表示や管理を行えます。このページでは異なる種類のデータソースを統一的に管理します。詳細については、データソースモジュールのドキュメントを参照してください。

パラメータ	説明
クラウドベンダー	現在、Alibaba Cloud、AWS、および Google Cloud のみをサポートしています。
データベースタイプ	現在、データ送信元では MySQL、Oracle、OceanBase MySQL Compatible、OceanBase Oracle Compatible、TiDB、および PostgreSQL をサポートしています。実際のニーズに応じて選択してください。
インスタンスタイプ	ページの指示に従って、適切なインスタンスタイプを選択します。
リージョン	データ送信元データベースが存在するリージョンを選択します。
接続タイプ	エンドポイント、パブリック接続、およびピアリング接続が含まれます。データベースタイプが MySQL、Oracle、PostgreSQL、または TiDB の場合に表示されます。データベースタイプが OceanBase MySQL Compatible または OceanBase Oracle Compatible の場合は、インスタンスタイプがセルフマネージド型データベースの場合にのみ表示されます。クラウドベンダーが Alibaba Cloud、AWS、または Google Cloud の場合にのみ、ピアリング接続がサポートされます。この接続タイプを選択した場合、ページに表示されているIPアドレスをデータベースインスタンスのセキュリティグループのインバウンドルールまたは許可リストに追加する必要があります。
ピアリング接続ID	接続タイプがピアリング接続として選択されている場合にのみ表示されます。利用可能なピアリング接続をドロップダウンリストから選択します。ドロップダウンリストには、現在のクラウドベンダーとリージョンが一致し、状態が接続済みのピアリング接続のみが表示され、対応するVPC IDとCIDRが表示されます。利用可能な接続がない場合、新規をクリックして、新しいタブでデータサービスのピアリング接続を作成できます。
接続情報	接続タイプをエンドポイントとして選択した場合は、エンドポイントサービス名を入力してください。接続タイプをパブリックネットワーク接続として選択した場合は、データベースホストのIPアドレスとポート番号を入力してください。接続タイプをピアリング接続として選択した場合は、データベースホストのプライベートIPアドレス、またはドメイン名とポート番号を入力してください。
Service Name	OracleデータベースのService名です。このパラメータは、データベースタイプが Oracle の場合にのみ表示されます。
Database Name	データベース名です。このパラメータは、データベースタイプが PostgreSQL の場合にのみ表示されます。
インスタンス	ドロップダウンリストからOceanBaseインスタンスを選択します。このパラメータは、データベースタイプが OceanBase MySQL Compatible または OceanBase Oracle Compatible の場合にのみ表示されます。
テナント	OceanBaseインスタンスを選択した後、ドロップダウンリストから使用するOceanBaseテナントを選択します。
データベースアカウント/パスワード	データ送信元データベースのアカウントとパスワードを入力します。

ソースとターゲットを設定する の手順で、ターゲット セクションの各パラメータを設定します。

既に作成・保存されたデータソースを参照する必要がある場合、クイック入力 ( ターゲット の右側) をクリックし、ドロップダウンリストから対象のデータソースを選択します。選択完了後、ターゲットエリアの各設定は自動的に入力されます。現在の設定を新しいデータソースとして保存する場合は、保存アイコン( ターゲット側 エリアの右上) をクリックしてください。

データソースの管理（クイック入力 ドロップダウンリスト内）をクリックすることもできます。これにより、データソース ページに移動し、データソースの表示や管理を行えます。このページでは異なるタイプのデータソースを一元的に管理できます。詳細については、データソースモジュールのドキュメントを参照してください。

パラメータ	説明
クラウドベンダー	現在、Alibaba Cloud、AWS、および Google Cloud のみをサポートしています。ソース側と同じクラウドベンダーを選択することも、異なるクラウドベンダー間でのデータ検証を行うこともできます。説明現在、クラウドベンダー間のデータ検証機能はデフォルトで無効です。この機能を使用する場合は、OceanBase Cloudのテクニカルサポートにお問い合わせください。
データベースタイプ	ソース側のデータベースタイプに応じて、ターゲット側の対応するデータベースタイプを選択してください。
インスタンスタイプ	ページの指示に従って、適切なインスタンスタイプを選択します。
リージョン	データ送信先データベースのリージョンを選択します。
接続タイプ	エンドポイント、パブリック接続、およびピアリング接続が含まれます。データベースタイプが MySQL、Oracle、PostgreSQL、または TiDB の場合に表示されます。データベースタイプが OceanBase MySQL Compatible または OceanBase Oracle Compatible の場合は、インスタンスタイプがセルフマネージドデータベースの場合にのみ表示されます。クラウドベンダーが Alibaba Cloud、AWS、または Google Cloud の場合にのみ、ピアリング接続がサポートされます。この接続タイプを選択した場合、ページに表示されているIPアドレスをデータベースインスタンスのセキュリティグループのインバウンドルールまたは許可リストに追加する必要があります。
ピアリング接続ID	接続タイプをピアリング接続として選択した場合にのみ表示されます。利用可能なピアリング接続をドロップダウンリストから選択します。ドロップダウンリストには、現在のクラウドベンダーとリージョンが一致し、ステータスが接続済みのピアリング接続のみが表示され、対応するVPC IDとCIDRが表示されます。利用可能な接続がない場合は、新規作成をクリックして、新しいタブでデータサービスのピアリング接続を作成できます。
接続情報	接続タイプをエンドポイントとして選択した場合は、エンドポイントサービス名を入力してください。接続タイプをパブリックネットワーク接続として選択した場合は、データベースホストのIPアドレスとポート番号を入力してください。接続タイプをピアリング接続として選択した場合は、データベースホストのプライベートIPアドレス、またはドメイン名とポート番号を入力してください。
Service Name	OracleデータベースのService名です。このパラメータは、データベースタイプが Oracle の場合にのみ表示されます。
インスタンス	ドロップダウンリストからOceanBaseインスタンスを選択します。このパラメータは、データベースタイプが OceanBase MySQL Compatible または OceanBase Oracle Compatible の場合にのみ表示されます。
テナント	OceanBaseインスタンスを選択した後、ドロップダウンリストから使用するOceanBaseテナントを選択します。
データベースアカウント/パスワード	データ送信先データベースのアカウントとパスワードを入力してください。

テストして続行 をクリックします。
タイプとオブジェクトを選択 の手順で、現在のデータ検証タスクの検証タイプを選択します。

現在サポートされている検証タイプは、完全な検証 と 行数の検証 です。詳細については、データ検証の概要を参照してください。
検証オブジェクト セクションで、検証対象の選択方法を設定します。

検証対象は、オブジェクトの指定 と ルールによる一致 の2つの方法で選択できます。

オブジェクトを選択してください セクションで、検証対象となるオブジェクトを選択します。

説明

現在、検証対象として選択できるのはテーブルのみです。

オブジェクトの指定 を選択した場合、左側で検証対象となるテーブルオブジェクトを選択し、> をクリックして右側のリストに追加します。

データ検証では、テキストのインポートによるオブジェクトの追加、データ送信先オブジェクトの名前変更、行フィルターの設定、列情報の確認、単一またはすべての検証対象の削除の操作がサポートされています。

操作	説明
オブジェクトのインポート	選択領域の右側のリストで、右上のインポート対象をクリックします。詳細については、検証オブジェクトのインポートを参照してください。
名前の変更	データ検証では、検証オブジェクトの名前を変更することができます。詳細については、検証オブジェクトの名前の変更を参照してください。
行フィルタリング	完全な検証では `WHERE` 条件を使用した行フィルタリングがサポートされています。詳細については、SQL条件で検証オブジェクトをフィルタリングするを参照してください。また、列を表示領域で、検証オブジェクトの列情報を確認することもできます。
削除/すべてクリア	データ検証では、データマッピング時に、一時的にターゲット側に選択された1つまたは複数のオブジェクトを削除する操作をサポートしています。単一検証オブジェクトの削除選択エリアの右側のリストで、対象オブジェクトの後ろにある削除アイコンをクリックすると、その検証オブジェクトを削除できます。すべての検証オブジェクトの削除選択エリアの右側のリストで、右上のすべてクリアをクリックします。ダイアログボックスで OK をクリックすると、すべての検証オブジェクトが削除されます。

ルールによる一致 を選択した場合、詳細については検証対象のマッチングルールの設定を参照してください。

次へをクリックし、検証オプション の手順で各パラメータを設定します。
- 全量検証
  
  **完全な検証を選択した場合（タイプとオブジェクトを選択**ステップ）、以下のパラメータが表示されます。

  | パラメータ  |  説明  |
  |-----------------|-----------------|
  | データ送信元同時実行設定/データ送信先同時実行設定 | 最小値は1、最大値は512、デフォルト値は4です。 |
  | 検証モード | <b>適応型モード</b>と<b>INモード</b>が含まれます。<ul><li><b>適応型モード</b>：ソース側とターゲット側から同じ範囲のデータをバッチ処理で取得し、正確に比較します。</li><li><b>INモード</b>：ソース側から指定範囲のデータをバッチ処理で取得し、ターゲット側のデータの一意キーに基づいて、ターゲット側でIN条件を使用してクエリを実行し、両側のデータが一致するかどうかを比較します。このモードでは、ソース側に存在しないターゲット側のデータを検証できず、検証性能も一定程度低下する点に注意してください。ターゲット側に予想される余分なデータが存在し、検証が不要な場合、またはデータベース・テーブルの集約移行シナリオでのみ使用することを推奨します。</li></ul>|
  | BPSレートを制限するかどうか | 単位はMiB/s、最大値は1024です。このボタンを有効にする場合は、少なくともデータ送信元またはデータ送信先のいずれか一方の最低レートを選択してください。|

行数検証

**行数の検証を選択した場合（タイプとオブジェクトを選択**ステップ）、以下のパラメータが表示されます。

  | パラメータ  |  説明  |
  |-------------|-------------|
  | 同時実行検証テーブル数 | 最小値は1、最大値は100、デフォルト値は10です。この設定はデータ送信元とデータ送信先の両方に適用されます。|
  | クエリタイムアウト時間 | 分単位で、最小値は1、最大値は1440、デフォルト値は10です。この設定はデータ送信元とデータ送信先の両方に適用されます。|

次へをクリックすると、システムがデータ検証タスクの事前チェックを実行します。
事前チェックに成功したら、タスクを開始する をクリックします。

一時的にタスクを開始する必要がない場合は、保存をクリックしてデータ検証タスクの詳細ページに移動し、必要に応じて手動で開始できます。詳細についてはデータ検証タスクの詳細を見るを参照してください。

データ検証タスクの設定ページにアクセスします。
1. OceanBase Cloudコンソールにログインします。
2. 左側のナビゲーションバーで、データサービス > データ移行 をクリックします。
3. データ移行 ページで、データ移行 タブをクリックします。
4. データ移行 タブで、対象タスクの名前をクリックして詳細ページに移動します。
5. 詳細ページの右上にある 検証タスクの設定 をクリックします。
  
  注意
  
  終了中および終了済み状態のデータ移行タスクは、検証タスクの設定をサポートしていません。
タスク名を編集するテキストボックスに、カスタムの検証タスク名を入力します。デフォルトの名前Data Migration Task Name-verifyも使用できます。

数字、英字の組み合わせを使用することを推奨します。名前にはスペースを含めることができず、長さは64文字を超えてはなりません。
ソースとターゲットを設定する ステップで、各パラメータが正しいことを確認したら、テストして続行 をクリックします。
タイプとオブジェクトを選択 の手順で、現在のデータ検証タスクの検証タイプを選択します。

現在サポートされている検証タイプは、完全な検証 と 行数の検証 です。詳細については、データ検証の概要を参照してください。
検証オブジェクト セクションで、検証対象の選択方法を設定します。

検証対象の選択方法には、オブジェクトの指定 と ルールによる一致 があります。データ移行タスクで選択した対象の方法をそのまま使用することも、変更することも可能です。

オブジェクトを選択してください セクションで、検証対象となるオブジェクトを選択します。

説明

現在、検証対象として選択できるのはテーブルのみです。
検証対象は、データ移行タスクで選択した移行対象と一致させることも、実際の状況に応じて再選択することも可能です。
データ検証タスクはデータベース全体の検証をサポートしていません。データ移行タスクでデータベース全体を選択した場合、データ検証タスクはそのデータベース内のすべてのテーブルオブジェクトを選択します。

オブジェクトの指定 を選択した場合、左側で検証対象となるテーブルオブジェクトを選択し、> をクリックして右側のリストに追加します。

操作	説明
オブジェクトのインポート	選択領域の右側のリストで、右上のインポート対象をクリックします。詳細については、検証オブジェクトのインポートを参照してください。
名前の変更	データ検証では、検証オブジェクトの名前を変更することができます。詳細については、検証オブジェクトの名前の変更を参照してください。
行フィルタリング	完全な検証では `WHERE` 条件を使用した行フィルタリングがサポートされています。詳細については、SQL条件で検証オブジェクトをフィルタリングするを参照してください。また、列を表示領域で、検証オブジェクトの列情報を確認することもできます。
削除/すべてクリア	データ検証では、データマッピング時に、一時的にターゲット側に選択された単一または複数のオブジェクトを削除する操作をサポートします。単一検証オブジェクトの削除選択領域の右側にあるリストで、対象オブジェクトの後ろにある削除アイコンをクリックすると、その検証オブジェクトを削除できます。すべての検証オブジェクトの削除選択領域の右側にあるリストで、右上の全部クリアをクリックします。ダイアログボックスで OK をクリックすると、すべての検証オブジェクトが削除されます。

マッチングルール を選択した場合、詳細については検証対象のマッチングルールの設定を参照してください。

次へをクリックし、検証オプション の手順で各パラメータを設定します。
- 全量検証
  
  完全な検証 ( タイプとオブジェクトを選択 ステップ) を選択した場合にのみ、以下のパラメータが表示されます。

  | パラメータ  |  説明  |
  |-----------------|-----------------|
  | データ送信元同時実行設定/データ送信先同時実行設定 | 最小値は1、最大値は512、デフォルト値は4です。 |
  | 検証モード | <b>適応モード</b> と <b>INモード</b> が含まれます。<ul><li><b>適応モード</b> : ソース側とターゲット側から同じ範囲のデータをバッチ処理で取得し、正確に比較します。</li><li><b>INモード</b> : ソース側から指定範囲のデータをバッチ処理で取得し、ターゲット側のデータの一意キーに基づいてターゲット側でIN条件を実行し、両側のデータが一致するかどうかを比較します。このモードでは、ソース側に存在しないターゲット側のデータを検証できず、検証性能も一定程度低下する点に注意してください。ターゲット側に予期された余分なデータが存在し、検証が不要な場合、またはデータベース・テーブルの集約移行シナリオの場合にのみ使用することを推奨します。</li></ul>|
  | BPSレートを制限するかどうか | 単位はMiB/s、最大値は1024です。このボタンを有効にする場合は、少なくともデータ送信元またはデータ送信先のいずれか一方の最低レートを選択してください。|

行数検証

行数の検証 ( タイプとオブジェクトを選択 ステップ) を選択した場合にのみ、以下のパラメータが表示されます。

  | パラメータ  |  説明  |
  |-------------|-------------|
  | 同時実行検証テーブル数 | 最小値は1、最大値は100、デフォルト値は10です。この設定はデータ送信元とデータ送信先の両方に適用されます。|
  | クエリタイムアウト時間 | 分単位で、最小値は1、最大値は1440、デフォルト値は10です。この設定はデータ送信元とデータ送信先の両方に適用されます。|

次へをクリックすると、システムがデータ検証タスクの事前チェックを実行します。
事前チェックに成功したら、タスクを開始する をクリックします。

一時的にタスクを開始する必要がない場合は、保存をクリックしてデータ検証タスクの詳細ページに移動し、必要に応じて手動で開始できます。詳細についてはデータ検証タスクの詳細を見るを参照してください。