スキーマとデータのインポート

背景

ODCは、データベースオブジェクトの構造とデータを一括インポートすることをサポートしています。

ODCのインポートタスクでは、データベースオブジェクトの構造とデータを別々にインポートしたり、データのみをインポートしたり、構造のみをインポートしたりできます。

• 構造とデータのインポート：データベースオブジェクトの定義ステートメントとそのデータを同時にインポートします。

• データのみのインポート：テーブル/ビューのデータのみをインポートします。

• 構造のみのインポート：データベースオブジェクトの定義ステートメントのみをインポートします。

このドキュメントでは、ZIP圧縮ファイルをインポートする例を用いて、ローカルディスク上のemployeeテーブルとsalaryテーブルの構造とデータをデータベースodc_testに一括インポートする方法を説明します。

インポートファイル形式

ODCインポートツールは、ZIP圧縮ファイル（一括インポートおよび単一テーブルインポート）、SQLファイル（一括インポート）、およびCSVファイル（単一テーブルインポート）のインポートをサポートしています。

ここで、ZIP圧縮ファイルとは、.zipで終わる圧縮パッケージのことです。インポートタスクを作成する際、パネル内の**インポート内容項目でZIP圧縮ファイルを選択した後、データ形式項目で、圧縮パッケージ内のデータ形式をCSV形式またはSQL形式**から選択する必要があります。

一括インポートでは、SQLファイルのインポートをサポートしています。SQLファイルは、.sqlで終わるファイルで、データベースで直接実行可能なSELECT、INSERT、UPDATE、DELETE、CREATE、DROPステートメントを含んでいます。

単一テーブルインポートでは、CSVファイルのインポートをサポートしています。CSVファイルは、.csvまたは.txtで終わる、カスタム区切り文字をサポートするデータファイルです。

注意事項

• Web版ODCは、インポートするアップロードファイルのサイズに制限があり、最大で2GB（圧縮後）のファイルのインポートをサポートしています。これを超える部分はアップロードできません。大量のデータをインポートする場合は、データロードツールOBLOADERを使用してください。

• 最大で5つのインポートタスクの並列実行をサポートしており、後続のタスクはキューで待機します。

• インポートタスクに関連するファイルは、デフォルトで14日間保持されます。

• OceanBase V4.0.0およびそれ以前のバージョンのデータソースでsysテナントのアカウントとパスワードを設定すると、インポート速度が向上します。ODCはパーティションの位置から最適なデータロードの並列戦略を計算できますが、OceanBase V4.0.0およびそれ以前のバージョンでは、sysテナントを通じてクエリを実行し、パーティションの位置を特定する必要があります。

• OceanBase V4.0.0以降のバージョンのデータソースでは、sysテナントのアカウントとパスワードを設定する必要はありません。ODCは、ビジネステナントのビューを通じてクエリを実行し、パーティションの位置を特定することをサポートしています。

インポートタスクの新規作成

OceanBaseデータベースの構造とデータのインポート

1. チケットタブで、インポート > **新規インポート**をクリックします。

   

2. ポップアップ表示されたタスクパネルで、インポートファイル形式を選択します。

   

   説明

   • ODCは現在、CSVファイル、SQLファイル、およびZIP圧縮ファイルの一括インポートをサポートしています。
   • インポートファイル形式がCSVファイルの場合、最初の行のフィールドヘッダーをスキップできます。
   • インポートファイル形式がZIP圧縮ファイルの場合、単一テーブルまたは複数テーブルのインポートと既存構造のスキップをサポートしています。

3. インポートファイルをアップロードします。

   ファイルプールをクリックしてファイルエクスプローラーに移動し、インポートするファイルを選択するか、ファイルを直接ファイルプールにドラッグしてアップロードを完了します。アップロードするファイルの形式は、選択したインポートファイルの形式と同じである必要があります。ZIP圧縮ファイルには.zip拡張子のファイルを、SQLファイルには.sqlファイルを、CSVファイルには.csvファイルをアップロードできます。

4. ファイルのエンコーディングを選択します。

   ODCは現在、ASCII、ISO-8859-1、GB2312、GBK、GB18030、Unicode (UTF-8)、Unicode (UTF-16)、Unicode (UTF-32)、およびBIG5などのエンコーディング形式をサポートしています。

5. インポート設定パネルに進みます。

   次へ：インポート設定をクリックして、インポートするファイルを設定します。

6. インポート内容を選択します。

   

   説明

   • インポート形式がZIP圧縮ファイルの場合、この項目を指定する必要があります。
   • ODCは現在、データのみをインポート、構造のみをインポート、およびデータと構造をインポートの3つのモードをサポートしています。ここでの構造のインポートとは、オブジェクトの定義ステートメントをインポートするかどうかを指します。

7. 所属データベースを選択します。

   インポート対象オブジェクトが存在するデータベースを選択します。この項目の下には、ターゲットオブジェクトが存在するデータベースのデータソース名も表示されます。

8. インポートデータを設定します。

   インポート形式がZIP圧縮ファイルで、かつ**インポート内容**が構造のみをインポートではない場合、インポートデータを設定する必要があります。この項目には以下の設定項目が含まれます：

   • インポート前にデータを削除：この項目を選択すると、データをインポートする際に、ターゲットオブジェクトの元のデータが最初に削除されます。

   • バッチ送信数：**データインポート設定タブの後ろの詳細**ボタンをクリックし、ポップアップリストでこの項目を指定できます。バッチ送信数を指定することで、インポートファイルから指定された量のデータをインポートする際に、1つのCOMMITコマンドを追加できます。

   • インポートしないデータ型（オプション）：この項目を使用して、データをインポートする際にスキップするデータ型を指定できます。OceanBase MySQLとOceanBase Oracleではスキップ可能な型が異なり、複数選択が可能です。

9. インポート構造を設定します。

   インポート内容 がデータのみのインポートの場合、この項目は指定できません。この項目では、オブジェクト構造が既に存在する場合の操作を選択します。スキップ を選択すると、インポート時にインポートファイル内の構造定義ステートメントをスキップしてデータのみを直接インポートし、オブジェクト内の元のデータは保持されます。置換 を選択すると、インポートファイル内の構造定義ステートメントを実行して元のオブジェクトを再作成・置き換えるため、オブジェクト内の元のデータは削除されます。

10. タスクのエラー処理と実行方法を設定します。

    • ODCは タスクの停止 と エラーを無視してタスクを続行 の2種類のエラー処理方法を提供します。タスクのエラー処理 ラベルで必要な処理方法を選択する必要があります。

    • 即時実行 と スケジュール実行 を選択できます。

11. 現在の設定を保持します。

    すべての情報を指定した後、パネルの左下にある 現在の設定を保持 を選択して、現在のデータファイルと構造ファイルの設定を保持します。

12. インポートタスクを生成します。

    すべての情報を指定した後、パネルの右下にある 送信 ボタンをクリックしてインポートタスクを生成します。

13. インポートタスクを確認します。

    タスクが生成されると、自動的に タスクセンター パネルが表示されます。タスクセンターでタスク情報を確認できます。

インポートタスクの表示

タスクリスト

インポート タスクリストには、以下の情報が含まれます：

| 項目 | 説明 |

タスク情報

1. 上図のように、インポート タスクリストで 表示 ボタンをクリックします。

2. 対象タスクのタスク詳細パネルがポップアップ表示されたら、タスク情報 タブをクリックして、タスクの基本情報、インポートファイル情報、インポートオブジェクト情報を確認します。

| 項目 | 説明 |

タスクの流れ

対象タスクのタスク詳細パネルで、タスクの流れ タブをクリックすると、タスクの開始、承認、実行 の各ステータスなどの情報を確認できます。

タスクログ

タスクの詳細パネルで、**タスクログ**タブをクリックすると、タスクのすべてのログとアラートログを表示できます。

| 情報項目 | 説明 |

また、ツールバーには以下の機能ボタンが用意されています：

| 機能 | 説明 |

関連ドキュメント

• データのエクスポート

• 导出数据