ノート:
オプションCONTENT=DATA_ONLYを使用して、収集データをインポートします。
INCLUDEパラメータを使用して、インポートするコレクションを指定します。 これは、データ・ファイル・セットにスキーマ全体が含まれ、インポートする必要があるSODAコレクションがダンプ・ファイル・セットの一部として含まれている場合に便利です。
REMAP_DATAを使用して、インポート中に列を変更します。 この例では、REMAP_DATAを使用してバージョン列メソッドをSHA256からUUIDに変更する方法を示します。
impdp admin/password@db2022adb_high \
directory=data_pump_dir \
credential=def_cred_name \
dumpfile= https://namespace-string.objectstorage.us-ashburn-1.oci.customer-oci.com/n/namespace-string/b/bucketname/o/export%l.dmp \
encryption_pwd_prompt=yes \
SCHEMA=my_schema \
INCLUDE=TABLE:\"= \'MyCollectionName\'\" \
CONTENT=DATA_ONLY \
REMAP_DATA=my_schema.'\"MyCollectionName\"'.VERSION:SYS.DBMS_SODA.TO_UUID
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桁の可変幅増分整数に拡張します。
リリース12.2より前のOracle Databaseからのエクスポートには、レガシーの%Uまたは%uワイルドカードを使用します。 このオプションを使用し、99を超えるダンプ・ファイルが必要な場合は、複数のダンプ・ファイル名をそれぞれ%Uまたは%uパラメータで指定する必要があります。
dumpfileの場合、この例では、商用レルム(OC1)にOCI専用エンドポイントを使用して推奨されるURI形式を使用します。 namespace-stringはOracle Cloud Infrastructureオブジェクト・ストレージ・ネームスペースで、bucketnameはバケット名です。 詳細は、「オブジェクト・ストレージ専用エンドポイント」、「リージョンおよび可用性ドメイン、」および「オブジェクト・ストレージ・ネームスペースの理解」を参照してください。
Oracle Data Pumpバージョン19.6以降では、credential引数は、ソース・ファイルに使用しているCloud Object Storageサービスに対するOracle Data Pumpを認証します。 credentialパラメータは、Azureサービス・プリンシパル、Amazonリソース名(ARN)またはGoogleサービス・アカウントにはできません。 リソース・プリンシパル・ベースの認証の詳細は、「ポリシーおよびロールの構成によるクラウド・リソースへのアクセス」を参照してください。
dumpfile引数は、データ・ポンプ・ファイルのURLのカンマ区切りリストです。
最適なインポート・パフォーマンスを得るには、インポート接続にHIGHデータベース・サービスを使用し、ECPUの数(.25 x 「ECPU数」)を4分の1にparallelパラメータをECPUの数の1/4 (.25 x 「ECPU数」)に設定します。 OCPUコンピュート・モデルを使用している場合は、パラレル・パラメータをOCPUの数(1 x 「OCPUカウント」)に設定します。
Data Pump Importを実行するために接続するデータベース・サービス名の詳細は、「Autonomous Databaseでの同時実行性および優先度の管理」を参照してください。
様々なCloud Object Storageサービスのダンプ・ファイルのURL形式については、「DBMS_CLOUDパッケージ・ファイルのURI形式」を参照してください。
ノート:
全インポートを実行したり、他のユーザーが所有するオブジェクトをインポートするには、DATAPUMP_CLOUD_IMPのロールが必要です。
Autonomous Databaseの許可されないオブジェクトの詳細は、「SQLコマンド」を参照してください。
このインポート例では、REMAP_DATAパラメータの指定で関数DBMS_SODA.TO_UUIDを使用してUUID値を生成します。 デフォルトでは、オンプレミス・データベースの場合、SODAコレクションのバージョン列はドキュメント・コンテンツのSHA-256ハッシュを使用してコンピュートされます。 Autonomous Databaseでは、バージョン列でUUID生成値が使用されます。これは、ドキュメント・コンテンツから独立しています。
この例では、REMAP_DATAパラメータはDBMS_SODA.TO_UUID関数を使用して、ソース・コレクションのバージョン・タイプをUUIDバージョニングに置き換えます。 エクスポート・ダンプ・ファイル・セットで、versionColumn.methodをインポートする場合、このフィールドのREMAP_DATAは必須ではありません。
Oracle Data Pump Importパラメータの詳細は、『Oracle Databaseユーティリティ』を参照してください。