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

背景

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

   情報項目	説明
   タスク基本情報	実行状態、タスク番号、所属データベース、タスクタイプ、リスクレベル、実行方法、作成者、作成日時 などの情報が表示されます。
   インポートファイル情報	インポートタスク作成時に選択した インポートファイル形式、インポートファイル、ファイルエンコーディング、データ形式、タスクエラー処理 などの情報が表示されます。
   インポートオブジェクト情報	このタスクで選択したオブジェクトのデータインポート完了状況が表示されます。オブジェクト名、オブジェクトタイプ、実際の処理数、データ処理状況 などの情報が含まれます。

タスクの流れ

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

タスクログ

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

関連ドキュメント

• データのエクスポート