クラウド・オブジェクト・ストレージへのParquetとしてのデータのエクスポート

問合せを指定して、Autonomous Databaseからクラウド・オブジェクト・ストレージにParquetデータとして表データをエクスポートするステップを示します。

このエクスポート方法は、Autonomous Databaseでサポートされるすべてのクラウド・オブジェクト・ストアをサポートしており、Oracle Cloud Infrastructureリソース・プリンシパルを使用してOracle Cloud Infrastructure Object Storeにアクセスしたり、Amazonリソース名(ARN)を使用してAWS Simple Storage Service (S3)、Azureサービス・プリンシパルを使用してAzure BLOBストレージにアクセスしたり、Googleサービス・アカウントを使用してGoogle Cloud Platform (GCP)リソースにアクセスできます。

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

詳細は、Autonomous Databaseへの接続を参照してください。
DBMS_CLOUD.CREATE_CREDENTIALを使用してクラウド・オブジェクト・ストレージ資格証明を格納します。
たとえば、次のとおりです。
```
BEGIN
  DBMS_CLOUD.CREATE_CREDENTIAL(
    credential_name => 'DEF_CRED_NAME',
    username => 'user1@example.com',
    password => 'password'
  );
END;
/
```
usernameおよびpasswordに指定する値は、使用しているクラウド・オブジェクト・ストレージ・サービスによって異なります
リソース・プリンシパル資格証明を有効にする場合、Oracle Cloud Infrastructure Object Storeにアクセスするための資格証明を作成する必要はありません。詳細は、リソース・プリンシパルを使用したOracle Cloud Infrastructureリソースへのアクセスを参照してください。
DBMS_CLOUD.EXPORT_DATAを実行し、formatパラメータのtypeに値parquetを指定して、結果をparquetファイルとしてクラウド・オブジェクト・ストレージにエクスポートします。
parquet出力ファイルを生成するために、file_uri_listパラメータには2つのオプションがあります:
- file_uri_list値を、クラウド・オブジェクト・ストレージの既存のバケットのURLに設定します。
- file_uri_list値を、クラウド・オブジェクト・ストレージの既存のバケットのURLに設定し、エクスポートされたparquetファイルのファイル名の生成時に使用するファイル名接頭辞を含めます。
file_uri_listにファイル名接頭辞を含めない場合、DBMS_CLOUD.EXPORT_DATAによってファイル名接頭辞が指定されます。詳細は、テキスト出力(CSV、JSON、ParquetまたはXML)のファイル・ネーミングを参照してください。

たとえば、file_uri_listに指定されたファイル名接頭辞を持つDBMS_CLOUD.EXPORT_DATAを次に示します:
```
BEGIN
  DBMS_CLOUD.EXPORT_DATA(
    credential_name => 'DEF_CRED_NAME',
    file_uri_list   => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/dept_export',
    query           => 'SELECT * FROM DEPT',
    format          => JSON_OBJECT('type' value 'parquet', 'compression' value 'snappy'));
END;
/
```
この例では、namespace-stringはOracle Cloud Infrastructureオブジェクト・ストレージ・ネームスペースで、bucketnameはバケット名です。詳細は、オブジェクト・ストレージ・ネームスペースの理解を参照してください。
パラメータの詳細は、EXPORT_DATAプロシージャを参照してください。

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

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

指定するqueryパラメータは、必要に応じて、結合や副問合せを含む問合せなどの拡張問合せにすることができます。
出力ファイルを圧縮するには、formatパラメータにcompressionオプションを指定します。type parquetのデフォルトのcompressionはsnappyです。
エクスポートしたファイルが不要なった場合は、プロシージャDBMS_CLOUD.DELETE_OBJECTを使用するか、ネイティブのクラウド・オブジェクト・ストレージ・コマンドを使用してファイルを削除します。

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へのマッピングのパッケージ」を参照してください。

親トピック: テキストとしてのオブジェクト・ストアへのデータのエクスポート

Oracle Cloud Infrastructureドキュメント