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

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

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

  1. Autonomous Databaseインスタンスに接続してください。

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

  2. 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オブジェクト・ストアにアクセスするための資格証明の作成は必要ありません。詳細は、リソース・プリンシパルを使用したOracle Cloud Infrastructureリソースへのアクセスを参照してください。

  3. DBMS_CLOUD.EXPORT_DATAを実行し、formatパラメータtypeに値csvを指定して、結果をCSVファイルとしてクラウド・オブジェクト・ストレージにエクスポートします。
    CSV出力ファイルを生成するには、file_uri_listパラメータに次の2つのオプションがあります。
    • file_uri_list値をクラウド・オブジェクト・ストレージ上の既存のバケットのURLに設定します。

    • file_uri_list値をクラウド・オブジェクト・ストレージ上の既存のバケットのURLに設定し、エクスポートされたCSVファイルのファイル名を生成する際に使用するファイル名接頭辞を含めます。

    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 'csv', 'delimiter' value '|', 'compression' value 'gzip'));
    END;
    /

    この例では、namespace-stringはOracle Cloud Infrastructureオブジェクト・ストレージ・ネームスペースで、bucketnameはバケット名です。詳細は、オブジェクト・ストレージ・ネームスペースの理解を参照してください。

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

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

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

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

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

  • エクスポート時にデータを暗号化するには、encryptionオプションを指定してformatパラメータを指定します。詳細は、オブジェクト・ストレージへのエクスポート中のデータの暗号化を参照してください。

  • エクスポートするファイルが不要になった場合は、DBMS_CLOUD.DELETE_OBJECTプロシージャを使用するか、ネイティブのクラウド・オブジェクト・ストレージ・コマンドを使用してファイルを削除します。