ローカル・ファイルからのデータのロード

ローカル・ファイルからOracle Autonomous Databaseにデータをロードするには、「データ・ロード」ページで「LOAD DATA」および「LOCAL FILE」を選択します。

ローカル・ファイル・システム・ナビゲータから1つ以上のファイルをドラッグし、「データ・ロード・カート」にドロップします。「ファイルの選択」または「ファイルの選択」アイコンをクリックし、ファイル・システム・ナビゲータから1つ以上のファイルを選択して、「開く」をクリックすることもできます。

AVRO、CSV、JSON、GeoJSON、TSV、デリミタ付きTXT、XLS、XLSX、XML、PNG、JPEGおよびPDFのファイル形式のファイルを追加できます。サポートされているファイル形式の詳細は、JSON、AVROおよびXMLファイルの形式の仕様を参照してください。

各ファイルのアイテムがカートに表示されます。XLSまたはXLSXスプレッドシートの場合、スプレッドシートのワークシートは個別のアイテムとして表示されます。アイテムには、ソース・ファイルまたはワークシートの名前とそのサイズ、およびデータ・ロードのターゲットである表の名前が表示されます。データ・ロード・ツールでは、ファイルがオブジェクト・ストアにある場合、複数ワークシートXLSXファイルの最初のワークシートのみからの表のロードがサポートされます。

「ファイルの選択」アイコンをクリックして、カートに追加できます。1つのデータ・ロード・ジョブで、任意の数のファイルをカートに追加し、すべてのファイルからデータをロードできます。

データ・ロード・カートからソース・ファイルを削除するには、ソース・アイテムの「削除」(ごみ箱)アイコンをクリックします。カートからすべてのソース・ファイルを削除するには、「データ・ロード・カート」メニュー・バーの「すべて削除」(ごみ箱)アイコンをクリックします。

「Data Load」ページに戻るには、「Data Load Cart」メニュー・バーの上にある「Data Load」をクリックします。

処理オプションの指定

データ・ロード・ジョブの設定を指定するか、ソースまたはターゲットのデータをプレビューするには、「データ・ロード・カート」でアイテムの「設定」(鉛筆)アイコンを選択します。

設定ペインの「設定」タブで、「データのロード」ダイアログ・ボックスのタイトルにファイルの名前とサイズを表示できます。

「名前」フィールドでは、ターゲット表の名前を指定します。フィールドの値は、「オプション」フィールドの選択によって異なります。オプションが「表の作成」の場合、デフォルトのターゲット値はソース・ファイルまたはワークシートの名前です。

ターゲット表に別名を指定するには、「名前」フィールドに入力します。「オプション」フィールドの他のターゲット表の選択肢の場合、デフォルト値は<None>です。ドロップダウン・リストを開き、ターゲットとして既存の表を選択します。

「オプション」フィールドで、「表の作成および作成」「表への挿入」「データの置換」「表を削除して新規表を作成」または「表にマージ」を選択します。質問マーク・アイコンをポイントすると、選択したオプションの簡単な説明が表示されます。

「スキーマ」ドロップダウンから別のスキーマを選択して、別のスキーマにターゲット表を作成します。
ノート

「スキーマ」ドロップダウンは、PDB_DBAロールが付与されている場合にのみ使用できます。

PDB_DBAロールを付与するには、データベース・アクション・インスタンスにログインし、起動パッドにある「SQL」タブの「開発」ツールの下に表示される「SQL」ワークシート領域に次のコマンドを入力する必要があります。

Grant PDB_DBA to Username;

このドロップダウンは、「表の作成」および「表の削除および新規表の作成」オプションで使用できます。

「ソース列名」オプションでは、ソースとターゲットの列名をファイルから取得するか、列名を手動で指定するかを指定します。デフォルトでは、ソース・ファイルのヘッダーから列名を取得します。「列ヘッダー」オプションを選択すると、ファイルの最初の行が列名として処理されます。このオプションの選択を解除すると、最初の行はデータとして処理されます。手動で列名を指定するには、「マッピング」セクションに各ターゲット列の名前を入力します。列のデータ型を選択することもできます。

「行でデータの処理を開始」フィールドでは、ターゲットにソース・データをロードするときにスキップする行数を指定します。「列ヘッダー」オプションを選択し、「行でデータの処理を開始」フィールドに0より大きい数値を入力した場合、最初の行より後のその行数がターゲットにロードされません。「列ヘッダー」オプションの選択を解除しており、「行でデータの処理を開始」フィールドに0より大きい数値を入力した場合、最初の行を含むその行数がターゲットにロードされません。

ファイルの内容の文字セット・エンコーディングを変更するには、「エンコーディング」ドロップダウン・リストから値を選択します。

テキストを囲む文字を指定するには、「テキスト・エンクロージャ」ドロップダウン・リストからダブルクォート、シングルクォートまたはNoneを選択します。

ソースの列を区切るデリミタ文字を変更するには、「フィールド区切り文字」ドロップダウン・リストを開き、文字を選択します。たとえば、ファイルにセミコロンで区切られた列がある場合、デリミタをデフォルトのカンマ・デリミタからセミコロンに変更します。

数値ソース列の無効な値をターゲット列のNULL値に変換するには、数値列の「無効なデータをNULLに変換」オプションを選択します。

設定テンプレート

設定の保存機能は、カート設定の構成セットをJSONファイルの形式で保存します。「設定」テンプレートを開く際には、次のオプションがあります。
  1. 設定テンプレートのロード: ローカル・システムから設定テンプレートをロードします。
  2. 設定テンプレートの保存: 現在の既存の設定テンプレートを保存します。
settings-template.pngの説明が続きます
ローカルに存在する既存のカスタマイズ済テンプレートを使用する場合は、「設定テンプレートのロード」を使用できます。
  1. 「データのロード」ページの「設定」タブの「設定テンプレート」から、「設定テンプレートのロード」を選択します。
  2. 設定テンプレートのロード・ウィザードが表示され、「設定テンプレートJSON」をクリックしてシステムからJSONファイルをロードします。
  3. 設定テンプレートJSONをクリックすると、ローカル・システムが開きます。「OK」をクリックして、JSONファイルをロードします。
  4. JSONファイルをロードすると、ローカルからロードしたJSON設定テンプレートと一致する設定タブに自動的に適用された更新を表示できます。
「設定テンプレートの保存」を使用して、既存の現在の設定テンプレートを保存できます。
  1. 「データのロード」ページの「設定」タブの「設定テンプレート」から、「設定テンプレートの保存」を選択します。
  2. テンプレート・ページが表示されます。「テンプレート・ファイル名」をクリックし、新しいテンプレートの名前を入力します。
  3. 「OK」をクリックして、既存のテンプレートの新しい名前の保存を終了します。
  4. 新しいテンプレートの構成をテストできます。

一括編集の設定

一括編集の設定を使用して、マッピング表からすべての列を一括して更新できます。これを使用して、結果ペインで現在表示されている選択に変更を適用します。検索フィールドで編集する列の値を検索し、拡大鏡アイコンをクリックします。マッピング表には、検索の結果が表示されます。「一括編集」の設定を選択して列を更新します。「一括編集」の設定では、次のことが可能です。
  • グループ内のすべてのフィールドの値を更新します。
  • ターゲットの列名を検索および置換し、接頭辞を追加、および接頭辞を追加します。
  • ターゲット表にデータをロードする列を含めます。
  • ターゲット表にデータをロードする列を除外します。

列の検索

「一括編集」の設定では、検索フィールドに返される列が更新されます。「一括編集」設定アイコンの横の検索ボックスで、一括で更新する列のリストがフィルタされます。検索フィールドに入力するとすぐに、入力した文字を含むフィールド値が返されます。検索ボックスからすべてのコンテンツを削除し、検索ボックスの横に表示される拡大鏡アイコンをクリックします。

「一括編集」の設定では、検索フィールドから返されたすべての検索について、次の列の値を更新できます。
  • データ型
  • ターゲット列名
  • ロードに列を含める
  • ロード用の列の除外
マッピング表で、最初の行から5番目の行のデータ型をVARCHARからNUMBERに変更することを検討してください。bulk-edit1.pngの説明が続きます
  • 検索フィールドにVARCHARを入力し、検索フィールドの横にある拡大鏡アイコンをクリックします。bulk-edit2.pngの説明が続きます

  • 検索では、データ型がVARCHARの行が返されます。拡大鏡アイコンの横にある「一括編集」アイコンを選択します。bulk-edit3.pngの説明が続きます

  • 「一括編集」アイコンを選択すると、「マッピングの一括編集」ダイアログ・ボックスが開きます。bulk-edit4.pngの説明が続きます

  • 「Data Type」をクリックし、「Data Type」ドロップダウンからNUMBERを選択します。「OK」をクリックします。bulk-edit5.pngの説明が続きます

  • 選択した行のデータ型がVARCHARからNUMBERに変わります。bulk-edit6.pngの説明が続きます

  • 「マッピング」表に一括編集の更新を表示するには、検索フィールドからコンテンツをクリアし、拡大鏡アイコンをクリックします。bulk-edit7.pngの説明が続きます

マッピングを指定します

「列」または「式」をフィルタで除外できるクイック・フィルタ・フィールドを使用して、マッピング表の結果をフィルタできます。

「式の追加」を選択して、ソース・データで「センチメント分析」または「キー・フレーズ抽出」を実行します。詳細は、Data StudioでのOCI言語サービス機能の使用を参照してください。

「表の作成」または「表を削除して新規表を作成」オプションを選択し、ファイル・ヘッダーからソース列名を取得している場合、「マッピング」セクションでターゲット列とデータ型のデフォルト値を受け入れるか、別の値を指定します。別の値を指定するには、ターゲット列に列の名前を入力します。「データ型」列で、ドロップダウン・リストからデータ型を選択します。ファイル・ヘッダーからソースカラム名を取得していない場合、ソースカラムごとにターゲットカラム名を指定し、[データ型]ドロップダウンリストからデータ型を選択します。「日付」データ型について、「フォーマット」ドロップダウン・リストから日付フォーマットを選択します。
ノート

セルの編集を完了すると、エラー・メッセージの正確な理由を示すツールチップ・エラー・メッセージが表示されます。マッピング・グリッド・セルは、修正する必要がある無効な値を示すために赤でハイライトされます。無効な値を修正すると、強調表示は削除されます。たとえば、ターゲット列名が入力されていない場合、次のツールチップ・エラー・メッセージを表示できます。 tooltip-error.pngの説明が続きます

「表にマージ」オプションでは、ソース列ごとに、ドロップダウン・リストからターゲット列を選択します。少なくとも1つの列をキー列として指定する必要があります。列をキー列として指定するには、列の「マージ・キー」チェック・ボックスを選択します。マージ・キーは、表内の各行を一意に識別する1つ以上の列です。マージ・キーにnull値を含めることはできません。主キーを含む表をロードする場合、このオプションにより、マージ・キーとしての主キー列の選択が自動的に有効化されます。

「表への挿入」または「データの置換」オプションでは、各ソース列について、既存の列のドロップダウン・リストからターゲット列を選択します。

ソース・データのプレビュー

ソース・ファイルで選択したデータを表示するには、「プレビュー」タブを選択します。「プレビュー」タブには「ファイル」メニューが表示され、その値とともにデータが表形式で表示されます。表をコピーできます。「ロード・プレビュー」タブには、ソース・データが表示されます。

ソース・プレビューで行った変更は、ファイルからのデータのロードには影響しません。

ターゲット・データのプレビュー

「表の作成」以外のすべてのオプションの場合、ターゲット表の既存のデータを表示するには、「プレビューのロード」タブを選択します。データ・ロード・ジョブを実行する前に、ロード・プレビューにターゲット表のデータが表示されます。

設定ペインを閉じるには、「閉じる」をクリックします。

データ・ロード・ジョブの実行

ジョブのすべてのソースを追加し、各ソースの設定を指定した場合、ジョブを実行するには、「データ・ロード・カート」メニュー・バーの「開始」アイコンをクリックします。「データ・ロード・ジョブの実行」ダイアログ・ボックスで、「開始」をクリックします。データ・ロード・ジョブを停止するには、「停止」アイコンをクリックします。

データ・ロード・ジョブが開始されると、「データ・ロード」ダッシュボードでジョブの進行状況を表示できます。詳細は、「「データ・ロード」ページ」を参照してください。

データ・ロード・ジョブが完了すると、「データ・ロード」ダッシュボード・ページにジョブの結果が表示されます。表ロードのヘッダーの上部に、表の名前と表に存在する合計列を表示できます。

「レポート」をクリックして、正常に処理された行の合計数および拒否された行の数を表示します。開始時間を表示することもできます。レポートの「SQL」ペインには、ジョブの同等のSQLコードが表示されます。

ジョブ内のアイテムに関する情報を表示するには、表ロードの「アクション」アイコンをクリックします。

ロード操作のログを表示するには、「ロギング」アイコンをクリックします。ログを保存、クリアまたはリフレッシュできます。「OK」をクリックしてログを閉じます。

「データ・ロード」ページの表のリストには、作成された新しい表が含まれています。「表への挿入」「データの置換」「表を削除して新規表を作成」および「表にマージ」オプションのターゲット表には、ロードされたデータが含まれます。

データ・ロード・ジョブの修正

データ・ロード・ジョブの後、修正が必要なエラーが表示される場合や、検査時に、列の名前を変更する必要があることに気づく場合があります。このような場合は、表ロードの警告記号が表示されます。「再ロード」アイコンをクリックして、修正が推奨されるソースを再ロードします。表のロードで「アクション」アイコンをクリックし、「編集」を選択して、データ・ロード・ジョブに変更を加えます(列名を変更するなど)。

「適用」をクリックして変更を適用します。「閉じる」をクリックして、「データベース・アクション」ページに戻ります。