DBMS_CLOUD.EXPORT_DATAを使用したディレクトリへのデータのエクスポート

DBMS_CLOUD.EXPORT_DATAを使用して、ファイルをディレクトリにエクスポートします。

ファイルをエクスポートするディレクトリは、Autonomous AI Databaseファイル・システムまたはアタッチされた外部ファイル・システムにあります。詳細については、次のページを参照してください。

• ディレクトリの作成および管理

• Autonomous AI Databaseへのネットワーク・ファイル・ストレージのアタッチ

• Autonomous AI Databaseへの外部ファイル・ストレージのアタッチ

ディレクトリへのCSVとしてのデータのエクスポート

問合せを指定して、Autonomous AIデータベースからCSVデータとしてディレクトリに表データをエクスポートするステップを示します。

1. Autonomous AI Databaseインスタンスに接続します。

   詳細は、Autonomous AI Databaseへの接続を参照してください。

2. ディレクトリの作成

   たとえば:

    CREATE DIRECTORY export_dir AS 'export_dir';
   

   詳細は、「ディレクトリの作成」を参照してください。

3. DBMS_CLOUD.EXPORT_DATAを実行し、formatパラメータtypeを値jsonとともに指定して、結果をCSVファイルとしてディレクトリにエクスポートします。出力をディレクトリに送信する場合は、credentialパラメータを含めないでください。

    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => 'export_dir:sales.csv',
        format => JSON_OBJECT('type' value 'csv'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
   

   レコード・デリミタに\r\nや\tなどのエスケープ文字が含まれている場合は、レコードのデリミタを二重引用符で囲みます。たとえば、レコード・デリミタ\r\nを使用するには、値を二重引用符で囲みます:"\r\n"。

    BEGIN
      DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => 'export_dir:sales.csv',
        query => 'SELECT * FROM sales',
        format => JSON_OBJECT('type' value 'json', 'recorddelimiter' value '"\r\n"' format json));
    END;
    /
   

   ディレクトリ名を二重引用符で囲むと、ディレクトリ名は大/小文字が区別されます。たとえば:

    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => '"export_dir":sales.csv',
        format => JSON_OBJECT('type' value 'csv'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
   

   パラメータの詳細は、「EXPORT_DATAプロシージャ」を参照してください。

   DBMS_CLOUD.EXPORT_DATAで使用できるformatパラメータの詳細は、EXPORT_DATAのDBMS_CLOUDパッケージのフォーマット・オプションを参照してください。

   パラメータは次のとおりです:

   • file_uri_list: エクスポート・ファイルのカンマ区切りリストです。file_uri_listでは、ワイルドカードおよび置換文字の使用はサポートされていません。

   • format: 必要なtypeパラメータを指定します。有効値は、json、xmlおよびcsvです。

   • query: 必要なデータのみがエクスポートされるようにSELECT文を指定します。問合せによってダンプ・ファイルの内容が決定されます。

   ノート: DBMS_CLOUD.EXPORT_DATAプロシージャは、file_uri_listで指定するダンプ・ファイルを作成します。ファイルは上書きしません。file_uri_listにダンプ・ファイルが存在する場合、DBMS_CLOUD.EXPORT_DATAは一意の名前を持つ別のファイルを生成します。DBMS_CLOUD.EXPORT_DATAはディレクトリを作成しません。

   パラメータの詳細は、「EXPORT_DATAプロシージャ」を参照してください。

DBMS_CLOUD.EXPORT_DATAを使用したエクスポートに関するノート:

• 指定するqueryパラメータには、必要に応じて、結合や副問合せを含む問合せなどの拡張問合せを指定できます。

• 出力ファイルを圧縮するには、formatパラメータをcompressionオプションとともに指定します。

ディレクトリへのJSONとしてのデータのエクスポート

問合せを指定してAutonomous AI DatabaseからJSONデータとしてディレクトリに表データをエクスポートするステップを示します。

1. Autonomous AI Databaseインスタンスに接続します。

   詳細は、Autonomous AI Databaseへの接続を参照してください。

2. ディレクトリの作成

   たとえば:

    CREATE DIRECTORY export_dir AS 'export_dir';
   

   詳細については、Create a Directoryを参照してください。

3. DBMS_CLOUD.EXPORT_DATAを実行し、formatパラメータtypeに値jsonを指定して、結果をJSONファイルとしてディレクトリにエクスポートします。出力をディレクトリに送信する場合は、credentialパラメータを含めないでください。

    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => 'export_dir:sales.dmp',
        format => json_object('type' value 'json'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
   

   レコード・デリミタに\r\nや\tなどのエスケープ文字が含まれている場合は、レコードのデリミタを二重引用符で囲みます。たとえば、レコード・デリミタ\r\nを使用するには、値を二重引用符で囲みます:"\r\n"。

    BEGIN
      DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => 'export_dir:sales.dmp',
        query => 'SELECT * FROM sales',
        format => JSON_OBJECT('type' value 'json', 'recorddelimiter' value '"\r\n"' format json));
    END;
    /
   

   ディレクトリ名を二重引用符で囲むと、ディレクトリ名は大/小文字が区別されます。たとえば:

    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => '"export_dir":sales.dmp',
        format => json_object('type' value 'json'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
   

   パラメータの詳細は、「EXPORT_DATAプロシージャ」を参照してください。

   DBMS_CLOUD.EXPORT_DATAで使用できるformatパラメータの詳細は、EXPORT_DATAのDBMS_CLOUDパッケージのフォーマット・オプションを参照してください。

   パラメータは次のとおりです:

   • file_uri_list: エクスポート・ファイルのカンマ区切りリストです。file_uri_listでは、ワイルドカードおよび置換文字の使用はサポートされていません。

   • format: 必要なtypeパラメータを指定します。有効値は、json、xmlおよびcsvです。

   • query: 必要なデータのみがエクスポートされるようにSELECT文を指定します。問合せによってダンプ・ファイルの内容が決定されます。

   ノート: DBMS_CLOUD.EXPORT_DATAプロシージャは、file_uri_listで指定するダンプ・ファイルを作成します。ファイルは上書きしません。file_uri_listにダンプ・ファイルが存在する場合、DBMS_CLOUD.EXPORT_DATAは一意の名前を持つ別のファイルを生成します。DBMS_CLOUD.EXPORT_DATAはディレクトリを作成しません。

   パラメータの詳細は、「EXPORT_DATAプロシージャ」を参照してください。

DBMS_CLOUD.EXPORT_DATAを使用したエクスポートに関するノート:

• 指定するqueryパラメータには、必要に応じて、結合や副問合せを含む問合せなどの拡張問合せを指定できます。

• 出力ファイルを圧縮するには、formatパラメータをcompressionオプションとともに指定します。

ディレクトリへのParquetとしてのデータのエクスポート

問合せを指定してAutonomous AIデータベースからParquetデータとしてディレクトリに表データをエクスポートするステップを示します。

1. Autonomous AI Databaseインスタンスに接続します。

   詳細は、Autonomous AI Databaseへの接続を参照してください。

2. ディレクトリの作成

   たとえば:

    CREATE DIRECTORY export_dir AS 'export_dir';
   

   詳細については、Create a Directoryを参照してください。

3. DBMS_CLOUD.EXPORT_DATAを実行し、formatパラメータtypeを値jsonとともに指定して、結果をParquetファイルとしてディレクトリにエクスポートします。出力をディレクトリに送信する場合は、credentialパラメータを含めないでください。

    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => 'export_dir:sales.parquet',
        format => JSON_OBJECT('type' value 'parquet'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
   

   ディレクトリ名を二重引用符で囲むと、ディレクトリ名は大/小文字が区別されます。たとえば:

    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => '"export_dir":sales.parquet',
        format => JSON_OBJECT('type' value 'parquet'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
   

   パラメータの詳細は、「EXPORT_DATAプロシージャ」を参照してください。

   DBMS_CLOUD.EXPORT_DATAで使用できるformatパラメータの詳細は、EXPORT_DATAのDBMS_CLOUDパッケージのフォーマット・オプションを参照してください。

   パラメータは次のとおりです:

   • file_uri_list: エクスポート・ファイルのカンマ区切りリストです。file_uri_listでは、ワイルドカードおよび置換文字の使用はサポートされていません。

   • format: 必要なtypeパラメータを指定します。有効な値は、datapump、json、xml、csvおよびparquetで、ORACLE_DATAPUMPアクセス・ドライバを使用してエクスポートに指定できるオプションもオプションで定義します。

   • query: 必要なデータのみがエクスポートされるようにSELECT文を指定します。問合せによってダンプ・ファイルの内容が決定されます。

   パラメータの詳細は、「EXPORT_DATAプロシージャ」を参照してください。

DBMS_CLOUD.EXPORT_DATAを使用したエクスポートに関するノート:

• 指定するqueryパラメータには、必要に応じて、結合や副問合せを含む問合せなどの拡張問合せを指定できます。

• 出力ファイルを圧縮するには、formatパラメータをcompressionオプションとともに指定します。

• Oracle型からParquet型へのマッピングの詳細は、「DBMS_CLOUDパッケージのOracleデータ型からParquetへのマッピング」を参照してください。

  次の型はサポートされていないか、DBMS_CLOUD.EXPORT_DATAでParquetをエクスポートするためのサポートに制限があります。

  Oracleタイプ	ノート
  BFILE	サポート対象外
  BLOB	サポート対象外
  DATE	次の制限でサポートされます: DATE形式では、日付、月および年のみがサポートされます。時間、分および秒はサポートされていません。 DATEをParquetにエクスポートする場合のNLS形式制限の詳細は、「DBMS_CLOUDパッケージのOracleデータ型からParquetへのマッピング」を参照してください。
  INTERVAL DAY TO SECOND	サポートされ、内部的に文字列として扱われます
  INTERVAL YEAR TO MONTH	サポートされ、内部的に文字列として扱われます
  LONG	サポート対象外
  LONG RAW	サポート対象外
  NUMBER	次の制限付きでサポートされます。 - 最大精度は38で、スケールが精度より小さい場合があります。 - 列のNUMBER型に精度およびスケールが指定されていない場合、デフォルトでは精度は38、スケールは20が使用されます。 - 負のスケールはNUMBER型ではサポートされていません。
  Object Types	サポート対象外
  TIMESTAMP	次の制限でサポートされます。 - 精度が異なる列が複数ある場合、最高精度が取得されます。 - TIMESTAMP WITH TIME ZONE Oracleデータ型ではタイムスタンプのみが使用されます。 TIMESTAMPをParquetにエクスポートする際のNLS形式制限の詳細は、DBMS_CLOUDパッケージのOracleデータ型からParquetへのマッピングを参照してください。

ディレクトリへのXMLとしてのデータのエクスポート

問合せを指定してAutonomous AI DatabaseからDirectoryに表データをXMLデータとしてエクスポートするステップを示します。

1. Autonomous AI Databaseインスタンスに接続します。

   詳細は、Autonomous AI Databaseへの接続を参照してください。

2. ディレクトリの作成

   たとえば:

    CREATE DIRECTORY export_dir AS 'export_dir';
   

   詳細については、Create a Directoryを参照してください。

3. DBMS_CLOUD.EXPORT_DATAを実行し、formatパラメータtypeに値jsonを指定して、結果をXMLファイルとしてディレクトリにエクスポートします。出力をディレクトリに送信する場合は、credentialパラメータを含めないでください。

    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => 'export_dir:sales.csv',
        format => JSON_OBJECT('type' value 'csv'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
   

   ディレクトリ名を二重引用符で囲むと、ディレクトリ名は大/小文字が区別されます。たとえば:

    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => '"export_dir":sales.xml',
        format => JSON_OBJECT('type' value 'xml'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
   

   パラメータの詳細は、「EXPORT_DATAプロシージャ」を参照してください。

   DBMS_CLOUD.EXPORT_DATAで使用できるformatパラメータの詳細は、EXPORT_DATAのDBMS_CLOUDパッケージのフォーマット・オプションを参照してください。

   パラメータは次のとおりです:

   • file_uri_list: エクスポート・ファイルのカンマ区切りリストです。file_uri_listでは、ワイルドカードおよび置換文字の使用はサポートされていません。

   • format: 必要なtypeパラメータを指定します。有効値は、json、xmlおよびcsvです。

   • query: 必要なデータのみがエクスポートされるようにSELECT文を指定します。問合せによってダンプ・ファイルの内容が決定されます。

   ノート: DBMS_CLOUD.EXPORT_DATAプロシージャは、file_uri_listで指定するダンプ・ファイルを作成します。ファイルは上書きしません。file_uri_listにダンプ・ファイルが存在する場合、DBMS_CLOUD.EXPORT_DATAは一意の名前を持つ別のファイルを生成します。DBMS_CLOUD.EXPORT_DATAはディレクトリを作成しません。

   パラメータの詳細は、「EXPORT_DATAプロシージャ」を参照してください。

DBMS_CLOUD.EXPORT_DATAを使用したエクスポートに関するノート:

• 指定するqueryパラメータには、必要に応じて、結合や副問合せを含む問合せなどの拡張問合せを指定できます。

• 出力ファイルを圧縮するには、formatパラメータをcompressionオプションとともに指定します。

関連コンテンツ

• EXPORT_DATAプロシージャ

• EXPORT_DATAのDBMS_CLOUDパッケージ形式オプション