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

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

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

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

詳細は、Autonomous Databaseへの接続を参照してください。
ディレクトリの作成
たとえば次のようにします。
```
CREATE DIRECTORY export_dir AS 'export_dir';
```
詳細は、ディレクトリの作成を参照してください。
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パラメータの詳細は、DBMS_CLOUD EXPORT_DATAのパッケージ・フォーマット・オプションを参照してください。
パラメータは次のとおりです:
- 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 DatabaseからJSONデータとしてディレクトリに表データをエクスポートするステップを示します。

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

詳細は、Autonomous Databaseへの接続を参照してください。
ディレクトリの作成
たとえば次のようにします。
```
CREATE DIRECTORY export_dir AS 'export_dir';
```
詳細は、ディレクトリの作成を参照してください。
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パラメータの詳細は、DBMS_CLOUD EXPORT_DATAのパッケージ・フォーマット・オプションを参照してください。
パラメータは次のとおりです:
- 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 DatabaseからParquetデータとしてディレクトリに表データをエクスポートするステップを示します。

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

詳細は、Autonomous Databaseへの接続を参照してください。
ディレクトリの作成
たとえば次のようにします。
```
CREATE DIRECTORY export_dir AS 'export_dir';
```
詳細は、ディレクトリの作成を参照してください。
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パラメータの詳細は、DBMS_CLOUD EXPORT_DATAのパッケージ・フォーマット・オプションを参照してください。
パラメータは次のとおりです:
- 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 DatabaseからディレクトリにXMLデータとして表データをエクスポートするステップを示します。

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

詳細は、Autonomous Databaseへの接続を参照してください。
ディレクトリの作成
たとえば次のようにします。
```
CREATE DIRECTORY export_dir AS 'export_dir';
```
詳細は、ディレクトリの作成を参照してください。
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パラメータの詳細は、DBMS_CLOUD EXPORT_DATAのパッケージ・フォーマット・オプションを参照してください。
パラメータは次のとおりです:
- 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オプションを指定します。