Oracle Data Pump Importを使用して既存のOracle DatabaseをAutonomous Databaseに移行するには、Oracle Data Pump Exportを使用してそのデータベースをエクスポートします。

exclude=cluster,indextype,db_link
parallel=n
schemas=schema_name
dumpfile=export%l.dmp

expdp sh/sh@orcl \
exclude=cluster,indextype,db_link \
parallel=16 \
schemas=sh \
dumpfile=export%l.dmp \
encryption_pwd_prompt=yes

Data PumpファイルのデータをAutonomous Database,にインポートする場合は、最新のOracle Data Pumpバージョンを使用することをお薦めします。これには操作性向上のための拡張機能と修正が含まれています。

1. DBMS_CLOUD.CREATE_CREDENTIALを使用してクラウド・オブジェクト・ストレージ資格証明を格納します。

   たとえば、Oracle Cloud Infrastructure認証トークン資格証明を作成するには:

   BEGIN
     DBMS_CLOUD.CREATE_CREDENTIAL(
       credential_name => 'DEF_CRED_NAME',
       username => 'adb_user@example.com',
       password => 'password'
     );
   END;
   /

   Oracle Cloud Infrastructure認証トークン認証の詳細は、CREATE_CREDENTIALプロシージャを参照してください。

   たとえば、Oracle Cloud Infrastructure署名キー・ベースの資格証明を作成するには:

   BEGIN
      DBMS_CLOUD.CREATE_CREDENTIAL (
          credential_name => 'DEF_CRED_NAME',
          user_ocid       => ‘ocid1.user.oc1..aaaaaaaauq54mi7zdyfhw33ozkwuontjceel7fok5nq3bf2vwetkpqsoa’,
          tenancy_ocid    => ‘ocid1.tenancy.oc1..aabbbbbbaafcue47pqmrf4vigneebgbcmmoy5r7xvoypicjqqge32ewnrcyx2a’,
          private_key     => ‘MIIEogIBAAKCAQEAtUnxbmrekwgVac6FdWeRzoXvIpA9+0r1.....wtnNpESQQQ0QLGPD8NM//JEBg=’,
          fingerprint     => ‘f2:db:f9:18:a4:aa:fc:94:f4:f6:6c:39:96:16:aa:27’);
   END;
   /

   Oracle Cloud Infrastructure署名キー・ベースの資格証明の詳細は、CREATE_CREDENTIALプロシージャを参照してください。

   サポートされている資格証明タイプ:

   • Data Pump Importは、Oracle Cloud Infrastructure認証トークン・ベースの資格証明およびOracle Cloud Infrastructure署名キー・ベースの資格証明をサポートしています。

     Oracle Cloud Infrastructure Cloud Object Storageの資格証明タイプの詳細は、CREATE_CREDENTIALプロシージャを参照してください。

   • Data Pumpでは、dumpfileパラメータに対するOracle Cloud Infrastructure Object Storageの事前認証済URLの使用がサポートされています。事前認証済URLを使用する場合、credentialパラメータを指定する必要があり、impdpではcredentialパラメータは無視されます。dumpfileに事前認証済URLを使用する場合は、次のステップでcredentialにNULL値を使用できます。詳細は、事前認証済リクエストの使用を参照してください。

   • Data Pumpでは、impdpでのリソース・プリンシパル資格証明の使用がサポートされています。詳細は、OCIリソース・プリンシパル資格証明でのOracle Data Pumpを使用したデータのインポートに関する項を参照してください。

2. dumpfileパラメータにクラウドのオブジェクト・ストレージのファイルURLのリストを設定し、credentialパラメータに前述のステップで作成した資格証明の名前を設定して、Data Pump Importを実行します。たとえば:

   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 \
        parallel=16 \
        encryption_pwd_prompt=yes \
        exclude=cluster,indextype,db_link

   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パラメータで指定する必要があります。

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

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

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

   dumpfileに事前認証済URLを使用する場合は、credentialにNULL値を使用できます。

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

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

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

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

   この例では、Data Pump Import中に次のものが除外されています:

   • クラスタ

   • 索引タイプ

   • データベース・リンク

   全体インポートを実行するか、他のユーザーが所有するオブジェクトをインポートするには、DATAPUMP_CLOUD_IMPロールが必要です。

   Data Pump Importを使用して、Autonomous DatabaseにSODAコレクションをインポートすることもできます。詳細は、Oracle Data Pumpバージョン19.6以上を使用したSODAコレクション・データのインポートを参照してください。

   Autonomous Databaseで使用できないオブジェクトの詳細は、SQLコマンドを参照してください。

   Autonomous DatabaseでのOracle Data Pumpインポートを使用した表圧縮の詳細は、Oracle Data Pumpインポートおよび表圧縮を参照してください。

   Oracle Data Pump Importパラメータの詳細は、『Oracle Databaseユーティリティ』を参照してください。

• OCIリソース・プリンシパル資格証明によるOracle Data Pumpを使用したデータのインポート
  Oracle Data Pumpでは、Oracle Cloud Infrastructureリソース・プリンシパルを資格証明オブジェクトとして使用して、データ・ポンプ・ファイルをAutonomous Databaseにインポートできます。

Data Pumpクライアント・バージョン12.2.0.1以前を使用して、default_credentialパラメータを設定することで、Data PumpファイルからAutonomous Databaseにデータをインポートできます。

1. DBMS_CLOUD.CREATE_CREDENTIALを使用してクラウド・オブジェクト・ストレージ資格証明を格納します。

   たとえば、Oracle Cloud Infrastructure認証トークン資格証明を作成するには:

   BEGIN
     DBMS_CLOUD.CREATE_CREDENTIAL(
       credential_name => 'DEF_CRED_NAME',
       username => 'adb_user@example.com',
       password => 'password'
     );
   END;
   /

   Oracle Cloud Infrastructure認証トークン認証の詳細は、CREATE_CREDENTIALプロシージャを参照してください。

   たとえば、Oracle Cloud Infrastructure署名キー・ベースの資格証明を作成するには:

   BEGIN
      DBMS_CLOUD.CREATE_CREDENTIAL (
          credential_name => 'DEF_CRED_NAME',
          user_ocid       => ‘ocid1.user.oc1..aaaaaaaauq54mi7zdyfhw33ozkwuontjceel7fok5nq3bf2vwetkpqsoa’,
          tenancy_ocid    => ‘ocid1.tenancy.oc1..aabbbbbbaafcue47pqmrf4vigneebgbcmmoy5r7xvoypicjqqge32ewnrcyx2a’,
          private_key     => ‘MIIEogIBAAKCAQEAtUnxbmrekwgVac6FdWeRzoXvIpA9+0r1.....wtnNpESQQQ0QLGPD8NM//JEBg=’,
          fingerprint     => ‘f2:db:f9:18:a4:aa:fc:94:f4:f6:6c:39:96:16:aa:27’);
   END;
   /

   Oracle Cloud Infrastructure署名キー・ベースの資格証明の詳細は、CREATE_CREDENTIALプロシージャを参照してください。

   サポートされている資格証明タイプ:

   • Data Pumpインポートは、Oracle Cloud Infrastructure認証トークン・ベースの資格証明およびOracle Cloud Infrastructure署名キー・ベースの資格証明をサポートしています。

     Oracle Cloud Infrastructure Cloud Object Storageの資格証明タイプの詳細は、CREATE_CREDENTIALプロシージャを参照してください。

   • Data Pumpでは、dumpfileに対するOracle Cloud Infrastructure Object Storageの事前認証済URLの使用がサポートされています。事前認証済URLを使用する場合、DEFAULT_CREDENTIALの設定が必要であり、impdpはDEFAULT_CREDENTIALを無視します。dumpfileに事前認証済URLを使用する場合は、次のステップで設定したDEFAULT_CREDENTIALにNULL値を使用できます。詳細は、事前認証済リクエストの使用を参照してください。

   • Data Pumpでは、impdpでのリソース・プリンシパル資格証明の使用がサポートされています。

2. ADMINユーザーとして、この資格証明をAutonomous Databaseのデフォルトの資格証明に設定します。例:

   ALTER DATABASE PROPERTY SET DEFAULT_CREDENTIAL = 'ADMIN.DEF_CRED_NAME'

   DEFAULT_CREDENTIALは、OCIリソース・プリンシパルにできます。たとえば:

   ALTER DATABASE PROPERTY SET DEFAULT_CREDENTIAL = 'OCI$RESOURCE_PRINCIPAL'

   リソース・プリンシパル・ベースの認証の詳細は、リソースにアクセスするためのポリシーおよびロールの構成を参照してください。

   ノート
   
   DEFAULT_CREDENTIAL値は、Azureサービス・プリンシパル、Amazonリソース名(ARN)またはGoogleサービス・アカウントにはできません。

   事前認証済URLを使用している場合は、DEFAULT_CREDENTIAL値をNULLに設定できます。

3. dumpfileパラメータにクラウドのオブジェクト・ストレージのファイルURLのリストを設定し、default_credentialキーワードを設定して、Data Pump Importを実行します。例:

   impdp admin/password@db2022adb_high \      
        directory=data_pump_dir \
        dumpfile=default_credential:https://namespace-string.objectstorage.us-ashburn-1.oci.customer-oci.com/n/namespace-string/b/bucketname/o/export%l.dmp \
        parallel=16 \
        encryption_pwd_prompt=yes \
        exclude=cluster,indextype,db_link
   

   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パラメータで指定する必要があります。

   • バケットとデータが商用(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はバケット名です。詳細は、オブジェクト・ストレージ専用エンドポイント、リージョンおよび可用性ドメインおよびオブジェクト・ストレージ・ネームスペースの理解を参照してください。

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

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

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

   この例では、Data Pump Import中に次のものが除外されています:

   • クラスタ

   • 索引タイプ

   • データベース・リンク

Data Pump Import操作のログ・ファイルは、データ・ポンプのimpdp directoryパラメータで指定したディレクトリに格納されます。

BEGIN
  DBMS_CLOUD.PUT_OBJECT(
    credential_name => 'DEF_CRED_NAME',
    object_uri => 'https://objectstorage.us-ashburn-1.oraclecloud.com/n/namespace-string/b/bucketname/o/import.log',
    directory_name  => 'DATA_PUMP_DIR',
    file_name => 'import.log');
END;
/

Autonomous DatabaseでのOracle Data Pumpインポートの使用に関するノートを提供します。

デフォルトでは、Oracle Data Pump Importユーティリティは、ソース・データベース(データのエクスポート元のデータベース)の表に対して指定された圧縮タイプと同じ圧縮タイプのデータをインポートします。圧縮をAutonomous Databaseに残す場合は、データのインポート時に次のパラメータを指定します:

TRANSFORM=TABLE_COMPRESSION_CLAUSE:NONE

このオプションを指定したTRANSFORMパラメータは、Oracle Data Pump Importでソース表の圧縮タイプを無視するように指定します。このオプションを使用すると、Oracle Data Pumpはデフォルトの圧縮タイプを使用して表をAutonomous Databaseにインポートします。デフォルトの圧縮タイプはAutonomous Databaseワークロード・タイプによって異なります:

• データ・ウェアハウス: デフォルトの表圧縮はハイブリッド列圧縮です。

  Oracleでは、ロードによってデータが圧縮されるため、アプリケーションが主に表に対してバルク・ロード操作を使用する場合、このデフォルトを使用することをお薦めします。問合せでIOを少なくする必要があるため、これらの表の問合せパフォーマンスは圧縮によるメリットがあります。

  Oracle GoldenGateまたはその他のレプリケーション・ツールを使用して他のシステムからレプリケートされたステージング表がある場合、またはアプリケーションが主に表に対して行ごとのDML操作を使用する場合、Oracleでは、表を非圧縮のままにするか、拡張行圧縮を使用することをお薦めします。

• トランザクション処理: デフォルトの表圧縮は圧縮されません。

• JSONデータベース: デフォルトの表圧縮は圧縮されません。

• APEX: デフォルトの表圧縮は圧縮ではありません。

Oracle Data Pump ImportのTRANSFORMパラメータの詳細は、TRANSFORMを参照してください。

詳細は、「表圧縮について」を参照してください。