ノート
オプション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
ワイルドカードを使用します。このワイルドカードは、ダンプファイルファイル名を3桁から10桁の可変幅増分整数に拡張し、100から2147483646で終わります。
リリース12.2より前のOracle Databaseからのエクスポートには、レガシーの%U
または%u
ワイルドカードを使用します。このオプションを使用し、99を超えるダンプ・ファイルが必要な場合は、複数のダンプ・ファイル名をそれぞれ%U
または%u
パラメータで指定する必要があります。
dumpfile
の場合、この例では、商用レルム(OC1)のOCI専用エンドポイントを使用して推奨されるURI形式を使用します。namespace-string
は、Oracle Cloud Infrastructureオブジェクト・ストレージ・ネームスペースで、bucketname
はバケット名です。詳細は、オブジェクト・ストレージ専用エンドポイント、リージョンおよび可用性ドメインおよびオブジェクト・ストレージ・ネームスペースの理解を参照してください。
Oracle Data Pumpバージョン19.6以降では、資格引数により、ソース・ファイルに使用しているクラウド・オブジェクト・ストレージ・サービスに対してOracle Data Pumpが認証されます。credential
パラメータは、Azureサービス・プリンシパル、Amazonリソース名(ARN)またはGoogleサービス・アカウントにはできません。リソース・プリンシパル・ベースの認証の詳細は、ポリシーおよびロールの構成によるクラウド・リソースへのアクセスを参照してください。
dumpfile引数は、Data PumpファイルのURLをカンマで区切ったリストです。
最適なインポート・パフォーマンスを得るには、インポート接続にHIGH
データベース・サービスを使用して、parallel
パラメータをECPU数(.25 x ECPU数)の4分の1に設定します。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
がすでにUUIDに設定されている場合、このフィールドにREMAP_DATA
は必要ありません。
Oracle Data Pump Importパラメータの詳細は、『Oracle Databaseユーティリティ』を参照してください。