機械翻訳について

Oracle Data Pump最新バージョンまたは旧バージョンを使用したデータのインポート

Oracle Data Pumpを使用してAutonomous Databaseにデータをインポートするステップは、Oracle Data Pumpのバージョンによって異なります。

Oracle Data Pump Version 18.3以降を使用したデータのインポート

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

プラットフォームの「Oracle Instant Clientダウンロード」からOracle Data Pumpを含む最新バージョンのOracle Instant Clientをダウンロードします。 Oracle Instant Clientをダウンロードした後に必要なインストール・ステップは、プラットフォームのインストール・ダウンロード・ページのインストール・ステップを参照してください。

Oracle Data Pumpバージョン18.3以降では、credential引数によって、ソース・ファイルで使用しているCloud Object Storageサービスに対してデータ・ポンプが認証されます。 dumpfile引数は、データ・ポンプ・ファイルのURLのカンマ区切りリストです。

Oracle Data Pumpで、ソース・ファイルがOracle Cloud Infrastructureオブジェクト・ストレージに存在する場合は、Oracle Cloud InfrastructureネイティブURIまたはSwift URIを使用できます。 これらのファイルURI形式の詳細は、「DBMS_CLOUD URIの書式」を参照してください。

クラウド・オブジェクト・ストレージからOracle Data Pumpダンプ・ファイルをロードするには、Oracle Data Pumpインポートを実行し、credentialパラメータを含めます:

1. DBMS_CLOUD.CREATE_CREDENTIALを使用してCloud Object Storage資格証明を保存します。

   たとえば、デフォルトのアイデンティティ・ドメインでOracle Cloud Infrastructure認証トークン資格証明を作成するには:

   BEGIN
     DBMS_CLOUD.CREATE_CREDENTIAL(
       credential_name => 'DEF_CRED_NAME',
       username => '[e-mail]',
       password => 'password'
     );
   END;
   /

   「OCIオブジェクト・ストレージ」の場合、usernameパラメータ値には、アイデンティティ・ドメインとプロファイルのユーザー名を含める必要があります。 ユーザーに関連付けられたアイデンティティ・ドメインは、Oracle Cloud Infrastructureコンソールにあります。 たとえば、oracleidentitycloudserviceアイデンティティ・ドメインの場合、次のようになります:

   BEGIN
     DBMS_CLOUD.CREATE_CREDENTIAL(
       credential_name => 'DEF_CRED_NAME',
       username => 'oracleidentitycloudservice/[e-mail]',
       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クラウド・オブジェクト・ストレージの資格証明タイプの詳細は、「CREATE_CREDENTIALプロシージャ」を参照してください。

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

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

2. dumpfileパラメータにCloud Object StorageのファイルURLのリストを設定し、credentialパラメータに前のステップで作成した資格証明の名前を設定して、データ・ポンプ・インポートを実行します。 たとえば:

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

     リリース12.2より前のOracle Databaseからのエクスポートには、レガシーの%Uまたは%uワイルドカードを使用します。 このオプションを使用し、99を超えるダンプ・ファイルが必要な場合は、複数のダンプ・ファイル名をそれぞれ%Uまたは%uパラメータで指定する必要があります。

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

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

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

   • dumpfile値を事前認証済URLとして指定する場合、credentialパラメータが必要であり、値はNULLです。

     事前認証済URLを使用するために必要なステップの詳細は、「事前認証済URLでのOracle Data Pumpインポートの使用」を参照してください。

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

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

   この例では、データ・ポンプ・インポート時に次のものが除外されます:

   • クラスタ

   • 索引タイプ

   • データベース・リンク

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

   Autonomous Databaseの許可されないオブジェクトの詳細は、「SQLコマンド」を参照してください。

   Oracle Data Pumpインポートの使用に関するその他のノートは、「Oracle Data Pumpを使用したインポートに関するノート」を参照してください。

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

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

OCIリソース・プリンシパルでのOracle Data Pumpバージョン18.3以降を使用したデータのインポート

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

Oracle Data Pump expdpを使用してオブジェクト・ストアに直接エクスポートする場合は、impdpを使用してインポートしたときのエクスポートに使用されたものと同じ資格証明を使用する必要があります。 この場合、Oracle Data Pumpインポートでは、Oracle Cloud Infrastructureリソース・プリンシパル資格証明はサポートされていません。 アップロードする他のメソッドは、リソース・プリンシパル資格証明を使用したimpdpの使用でサポートされています。 たとえば、DBMS_CLOUD.PUT_OBJECTを使用してオブジェクト・ストアにOracle Data Pumpファイルをアップロードする場合、リソース・プリンシパル資格証明を使用してOracle Data Pump impdpを使用してファイルをインポートできます。 同様に、Oracle Cloud Infrastructureコンソールを使用してデータ・ポンプ・ファイルをオブジェクト・ストアにアップロードする場合は、リソース・プリンシパル資格証明を使用して、Oracle Data Pump impdpを使用してAutonomous Databaseインスタンスにインポートできます。

Oracle Data Pumpで、ソース・ファイルがOracle Cloud Infrastructureオブジェクト・ストレージに存在する場合は、Oracle Cloud InfrastructureネイティブURIまたはSwift URIを使用できます。 これらのファイルURI形式の詳細は、「DBMS_CLOUD URIの書式」を参照してください。

1. 動的グループおよびポリシーを構成し、Oracle Cloud Infrastructureリソース・プリンシパルが、インポートするデータ・ポンプ・ファイルが存在するオブジェクト・ストアのロケーションにアクセスできるようにします。

   詳細については、「リソース・プリンシパルを使用したOracle Cloud Infrastructureリソースへのアクセス」を参照してください。

2. dumpfileパラメータをクラウド・オブジェクト・ストレージのファイルURLのリストに設定し、credentialパラメータをOCI$RESOURCE_PRINCIPALに設定して、Data Pump Importを実行します。

   たとえば:

   impdp admin/password@db2022adb_high \       
        directory=data_pump_dir \ 
        credential= 'OCI$RESOURCE_PRINCIPAL' \ 
        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ワイルドカードを使用します。 このワイルドカードは、ダンプ・ファイル・ファイル名を、100から2147483646で終わる10桁の可変幅増分整数に拡張します。

     リリース12.2より前のOracle Databaseからのエクスポートには、レガシーの%Uまたは%uワイルドカードを使用します。 このオプションを使用し、99を超えるダンプ・ファイルが必要な場合は、複数のダンプ・ファイル名をそれぞれ%Uまたは%uパラメータで指定する必要があります。

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

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

   • dumpfile値を事前認証済URLとして指定する場合、credentialパラメータが必要であり、値はNULLです。

     事前認証済URLを使用するために必要なステップの詳細は、「事前認証済URLでのOracle Data Pumpインポートの使用」を参照してください。

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

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

   この例では、データ・ポンプ・インポート時に次のものが除外されます:

   • クラスタ

   • 索引タイプ

   • データベース・リンク

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

   Autonomous Databaseの許可されないオブジェクトの詳細は、「SQLコマンド」を参照してください。

   Oracle Data Pumpインポートの使用に関するその他のノートは、「Oracle Data Pumpを使用したインポートに関するノート」を参照してください。

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

Oracle Data Pumpバージョン12.2以前を使用したデータのインポート

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

データ・ポンプ・インポートのバージョン(12.2.0.1)以前に「資格証明」パラメータがありません。 古いバージョンのData Pump Importを使用している場合は、Autonomous Databaseのデフォルトの資格証明プロパティを定義し、dumpfileパラメータのdefault_credentialキーワードを使用する必要があります。

Oracle Data Pumpでは、ソース・ファイルがOracle Cloud Infrastructureオブジェクト・ストレージに存在する場合は、Oracle Cloud InfrastructureネイティブURIまたはSwift URIを使用できます。 これらのファイルURI形式の詳細は、「DBMS_CLOUD URIの書式」を参照してください。

旧バージョンのOracle Data Pumpを使用したインポートとdefault_credentialの設定

1. DBMS_CLOUD.CREATE_CREDENTIALを使用してCloud Object Storage資格証明を保存します。

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

   BEGIN
     DBMS_CLOUD.CREATE_CREDENTIAL(
       credential_name => 'DEF_CRED_NAME',
       username => '[e-mail]',
       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クラウド・オブジェクト・ストレージの資格証明タイプの詳細は、「CREATE_CREDENTIALプロシージャ」を参照してください。

   • Data Pumpでは、dumpfileに対するOracle Cloud Infrastructure Object Storage事前認証済URLの使用がサポートされています。 事前認証済URLを使用する場合、DEFAULT_CREDENTIALの設定が必要で、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パラメータをCloud Object StorageのファイルURLのリストに設定し、default_credentialキーワードを設定して、データ・ポンプ・インポートを実行します。 たとえば:

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

     リリース12.2より前のOracle Databaseからのエクスポートには、レガシーの%Uまたは%uワイルドカードを使用します。 このオプションを使用し、99を超えるダンプ・ファイルが必要な場合は、複数のダンプ・ファイル名をそれぞれ%Uまたは%uパラメータで指定する必要があります。

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

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

   • dumpfile値を事前認証済URLとして指定する場合、default_credentialパラメータの設定が必要であり、値はNULLです。

     事前認証済URLを使用するために必要なステップの詳細は、「事前認証済URLでのOracle Data Pumpインポートの使用」を参照してください。

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

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

   この例では、データ・ポンプ・インポート時に次のものが除外されます:

   • クラスタ

   • 索引タイプ

   • データベース・リンク

ノート:

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

Autonomous Databaseの許可されないオブジェクトの詳細は、「SQLコマンド」を参照してください。

Oracle Data Pumpインポートの使用に関するその他のノートは、「Oracle Data Pumpを使用したインポートに関するノート」を参照してください。

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

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

事前認証済URLでのOracle Data Pumpインポートの使用

Oracle Data Pumpインポートで事前認証済URL (PAR URL)を使用するステップを示します。

1. Oracle Data Pump expdpを使用して、ローカル・ストレージにエクスポートします。

   詳細については、「既存のOracle Databaseのローカル・データベース・ファイルへのエクスポート(資格証明パラメータなしでエクスポート)」を参照してください。

2. ダンプ・ファイルをOracle Cloud Infrastructure Object Storageにアップロードします。

   たとえば、DBMS_CLOUD.PUT_OBJECTを使用してダンプ・ファイルをアップロードします。

3. 複数のダンプ・ファイルがある場合はオブジェクト・ストア・バケットに、1つのファイルしかない場合はダンプ・ファイル上に、Oracle Cloud Infrastructure Object Storageに事前認証済URLを作成します。

   詳細については、「オブジェクト・ストレージの事前認証済リクエスト」を参照してください。

4. dumpfileパラメータ値が事前認証済URLに設定されたダンプ・ファイルをインポートします。

   詳細については、「Oracle Data Pumpバージョン18.3以降を使用したデータのインポート」を参照してください。