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

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

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

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

詳細については、「Autonomous Databaseに接続」を参照してください。
DBMS_CLOUD.CREATE_CREDENTIALを使用してCloud Object Storage資格証明を保存します。
たとえば:
```
BEGIN
  DBMS_CLOUD.CREATE_CREDENTIAL(
    credential_name => 'DEF_CRED_NAME',
    username => 'user1@example.com',
    password => 'password'
  );
END;
/
```
usernameおよびpasswordに指定する値は、使用するクラウド・オブジェクト・ストレージ・サービスによって異なります。
リソース・プリンシパル資格証明を有効にした場合、Oracle Cloud Infrastructureオブジェクト・ストアにアクセスするための資格証明の作成は必要ありません。詳細については、「リソース・プリンシパルを使用した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パラメータの詳細は、「EXPORT_DATAのDBMS_CLOUDパッケージ形式オプション」を参照してください。

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

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

Oracle Typeから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へのマッピング」を参照してください。

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