ノート
オプション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までの3桁から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引数により、ソース・ファイルに使用されているクラウド・オブジェクト・ストレージ・サービスに対して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数)に設定します。
データ・ポンプ・インポートを実行するために接続するデータベース・サービス名の詳細は、「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がすでにUUIDに設定されている場合、このフィールドのREMAP_DATA
は必要はありません。
Oracle Data Pump Importパラメータの詳細は、『Oracle Databaseユーティリティ』を参照してください。