機械翻訳について

Oracle Data Pumpを使用したCREDENTIALパラメータ(バージョン19.9以上)によるオブジェクト・ストアへのデータのエクスポート

credentialパラメータを使用してOracle Data Pumpエクスポートを使用して、Autonomous Databaseからクラウド・オブジェクト・ストレージにデータをエクスポートするステップを示します。

Oracleでは、Autonomous Databaseから他のOracleデータベースへのデータのエクスポートに最新のOracle Data Pumpバージョンを使用することをお薦めします。これには、操作性を向上させるための拡張機能と修正が含まれています。 最新バージョンのOracle Instant Clientをダウンロードし、Oracle Data Pumpを含むツール・パッケージを「Oracle Instant Clientダウンロード」からダウンロードします。 Oracle Instant Clientおよびツール・パッケージをダウンロードした後に必要なインストール・ステップは、プラットフォームのインストール・ダウンロード・ページのインストールの手順を参照してください。

ノート:

データベース・アクションでは、Oracle Instant Clientのリンクが提供されます。 データベース・アクションからこのリンクにアクセスするには、「ダウンロード」で「Oracle Instant Clientのダウンロード」をクリックします。

Oracle Data Pumpバージョン19.9以降を使用している場合は、次のステップに示すようにcredentialパラメータを使用できます。 Oracle Data Pumpバージョン19.8以前の使用手順は、「Oracle Data Pumpを使用したオブジェクト・ストアへのデータのエクスポートDEFAULT_CREDENTIALプロパティの設定」を参照してください。

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

  3. dumpfileパラメータをクラウド・オブジェクト・ストレージ上の既存のバケットのURLに設定して、exp%L.dmpなどの置換変数でファイル名またはファイル名で終了し、credentialパラメータを前のステップで作成した資格証明の名前に設定して、Data Pump Exportを実行します。 たとえば: 
    expdp admin/password@db2022adb_high \
     filesize=5GB \
     credential=def_cred_name \
     dumpfile=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

    Oracle 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ワイルドカードを使用します。 このワイルドカードは、ダンプ・ファイル・ファイル名を、100から2147483646で終わる10桁の可変幅増分整数に拡張します。

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

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

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

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

    実行データ・ポンプ・エクスポートに接続するためのデータベース・サービス名の詳細は、「Autonomous Databaseのデータベース・サービス名」を参照してください。

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

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

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

    • 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を使用すると、プロシージャがプライマリ・ファイルを削除するときにチャンクが自動的に検出および削除されます。

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

ノート:

全体エクスポートを実行する場合や、他のユーザーが所有するオブジェクトをエクスポートする場合は、DATAPUMP_CLOUD_EXPのロールが必要です。

Oracle Data Pumpのエクスポート・パラメータの詳細は、「Oracle Databaseユーティリティ」を参照してください。

親トピック: Data Pump Exportを使用してデータをオブジェクト・ストアに移動