Oracle Data Pumpを使用してデータベースからオブジェクト・ストレージにデータをエクスポートするステップを示します。

1. 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 Object Storageにエクスポートする場合、Oracle Cloud InfrastructureのネイティブURIまたはSwift URIを使用できますが、資格証明は認証トークンである必要があります。詳細は、CREATE_CREDENTIALプロシージャを参照してください。

3. ADMINユーザーとして、ステップ2で定義した資格証明をデータベースのデフォルト資格証明として設定します。例:

   ALTER DATABASE PROPERTY SET DEFAULT_CREDENTIAL = 'ADMIN.DEF_CRED_NAME'

   DEFAULT_CREDENTIAL値は、OCIリソース・プリンシパル、Azureサービス・プリンシパル、Amazonリソース名(ARN)またはGoogleサービス・アカウントにはできません。リソース・プリンシパル・ベースの認証の詳細は、リソースにアクセスするためのポリシーおよびロールの構成を参照してください。

4. dumpfileパラメータをクラウド・オブジェクト・ストレージ上の既存のバケットのURLに設定して(ファイル名またはexp%L.dmpなどの置換変数を含むファイル名で終了)、Data Pump Exportを実行します。たとえば:

   expdp admin/password@db2022adb_high \
        filesize=5GB \
        dumpfile=default_credential:https://namespace-string.objectstorage.us-ashburn-1.oci.customer-oci.com/n/namespace-string/b/bucketname/o/exp%L.dmp \
        parallel=16 \
        encryption_pwd_prompt=yes \
        logfile=export.log \
        directory=data_pump_dir
   

   Data Pumpパラメータに関するノート:

   • expdpによるエクスポートでencryption_pwd_prompt=yesパラメータを使用した場合は、encryption_pwd_prompt=yesを使用して、エクスポート時に指定したimpdpプロンプトで同じパスワードを入力します。

   • dumpfileパラメータでは、レガシーの%Uおよび%uワイルドカードに加えて、%Lおよび%lワイルドカードがサポートされています。たとえば、dumpfile=export%L.dmpです。Oracle Databaseリリース12.2以降からのエクスポートには、%Lまたは%lワイルドカードを使用します。このワイルドカードは、ダンプファイルファイル名を3桁から10桁の可変幅増分整数に拡張し、100から2147483646で終わります。

   • バケットとデータが商用(OC1)レルム(OCI専用エンドポイントがサポートされていない)に存在しない場合は、dumpfileに次のURI形式を使用します:

     https://objectstorage.region.oraclecloud.com/n/namespace-string/b/bucketname/o/filename

   dumpfileの場合、この例では、商用レルム(OC1)のOCI専用エンドポイントを使用して推奨されるURI形式を使用します。namespace-stringは、Oracle Cloud Infrastructureオブジェクト・ストレージ・ネームスペースで、bucketnameはバケット名です。詳細は、オブジェクト・ストレージ専用エンドポイント、リージョンおよび可用性ドメインおよびオブジェクト・ストレージ・ネームスペースの理解を参照してください。

   dumpfileパラメータのdefault_credentialキーワードは必須です。

   最適なエクスポート・パフォーマンスを得るには、エクスポート接続にHIGHデータベース・サービスを使用し、parallelパラメータをECPU数(.25 x ECPU数)の4分の1に設定します。OCPUコンピュート・モデルを使用している場合は、パラレル・パラメータをOCPUの数(1 x OCPU数)に設定します。

   Data Pump Exportを実行するために接続するデータベース・サービス名の詳細は、Autonomous Databaseでの同時実行性および優先度の管理を参照してください。

   様々なクラウド・オブジェクト・ストレージ・サービスのダンプ・ファイルのURL形式については、DBMS_CLOUDのURI形式を参照してください。

   この例では、Autonomous Databaseからエクスポートするための推奨パラメータを示します。これらのexpdpパラメータについては、次に注意してください:

   • Oracle Cloud Infrastructure Object Storageエクスポートの場合、filesizeパラメータの最大値は10000MBです。

   • Oracle Cloud Infrastructure Object Storage Classicエクスポートの場合、最大filesizeパラメータ値は20GBです。

   • 指定したfilesizeが大きすぎる場合、エクスポートでは次のエラー・メッセージが表示されます:

     ORA-17500: ODM err:ODM HTTP Request Entity Too Large

   • directoryパラメータは、指定したログ・ファイルexport.logのディレクトリdata_pump_dirを指定します。詳細は、Data Pump Exportのログ・ファイルへのアクセスを参照してください。

   Oracle Data Pumpでは、各ダンプ・ファイルの部分を小さなチャンクに分割してアップロードを高速化します。Oracle Cloud Infrastructure Object Storageコンソールには、エクスポートするダンプ・ファイル・パートごとに複数のファイルが表示されます。実際のダンプファイルのサイズはゼロ(0)、関連するファイル・チャンクは10mb以下と表示されます。たとえば:

   exp100.dmp
   exp100.dmp_aaaaaa
   exp101.dmp
   exp101.dmp_aaaaaa

   Oracle Cloud InfrastructureコンソールまたはOracle Cloud Infrastructure CLIを使用してゼロ・バイト・ダンプ・ファイルをダウンロードしても、完全なダンプ・ファイルは得られません。オブジェクト・ストアから完全なダンプ・ファイルをダウンロードするには、curlなどのSwiftをサポートするツールを使用して、ユーザー・ログインおよびSwift認証トークンを指定します。たとえば:

   curl -O -v -X GET -u 'user1@example.com:auth_token' \
      https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/namespace-string/bucketname/exp100.dmp

   値datapumpを持つformatパラメータtypeをサポートするDBMS_CLOUDプロシージャを使用してファイルをインポートする場合は、プライマリ・ファイル名のみを指定する必要があります。'datapump'形式タイプをサポートするプロシージャは、チャンクを自動的に検出およびダウンロードします。

   DBMS_CLOUD.DELETE_OBJECTを使用すると、プライマリ・ファイルが削除されたときにチャンクが自動的に検出および削除されます。

5. Oracle Data Pumpインポートおよびクリーン・アップの使用に必要なステップを実行します。

   詳細は、ダンプ・ファイルのダウンロード、Data Pump Importの実行、およびオブジェクト・ストアのクリーン・アップを参照してください。