Importar datos con la última versión de Oracle Data Pump o una versión anterior

Oracle recomienda utilizar la versión de Oracle Data Pump más reciente para importar datos de archivos de Data Pump en Autonomous Database,, ya que contiene mejoras y correcciones para una mejor experiencia.

1. Almacene su credencial de Cloud Object Storage mediante DBMS_CLOUD.CREATE_CREDENTIAL.

   Por ejemplo, para crear credenciales de token de autenticación de Oracle Cloud Infrastructure con el dominio de identidad por defecto:

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

   Para OCI Object Storage, el valor del parámetro username debe incluir el dominio de identidad y el nombre de usuario del perfil. Puede encontrar el dominio de identidad asociado a un usuario en la consola de Oracle Cloud Infrastructure. Por ejemplo, con el dominio de identidad oracleidentitycloudservice, sería:

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

   Para obtener más información sobre la autenticación de token de autenticación de Oracle Cloud Infrastructure, consulte el procedimiento CREATE_CREDENTIAL.

   Por ejemplo, para crear credenciales basadas en la clave de firma de 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;
   /

   Para obtener más información sobre las credenciales basadas en claves de firma de Oracle Cloud Infrastructure, consulte el procedimiento CREATE_CREDENTIAL.

   Tipos de credenciales soportados:

   • La importación de pump de datos soporta credenciales basadas en token de autenticación de Oracle Cloud Infrastructure y credenciales basadas en clave de firma de Oracle Cloud Infrastructure.

     Para obtener más información sobre los tipos de credenciales para Oracle Cloud Infrastructure Cloud Object Storage, consulte el procedimiento CREATE_CREDENTIAL.

   • El pump de datos soporta el uso de una URL autenticada previamente de Oracle Cloud Infrastructure Object Storage para el parámetro dumpfile. Al utilizar una URL autenticada previamente, es necesario proporcionar el parámetro credential y el valor credential puede ser NULL. Consulte Uso de solicitudes autenticadas previamente para obtener más información.

   • Data Pump soporta el uso de una credencial de entidad de recurso con impdp. Consulte Importación de datos mediante Oracle Data Pump versión 18.3 o posterior con la entidad de recurso de OCI para obtener más información.

2. Ejecute Data Pump Import con el parámetro dumpfile definido en la lista de URL de archivo de Cloud Object Storage y el parámetro credential definido en el nombre de la credencial que ha creado en el paso anterior. Por ejemplo:

   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

   Notas para los parámetros de pump de datos:

   • Si durante la exportación con expdp utiliza el parámetro encryption_pwd_prompt=yes, utilice encryption_pwd_prompt=yes e introduzca la misma contraseña en la petición de datos impdp que ha especificado durante la exportación.

   • El parámetro dumpfile soporta los comodines %L y %l, además de los comodines %U y %u heredados. Por ejemplo, dumpfile=export%L.dmp. Utilice el comodín %L o %l para las exportaciones de Oracle Database versión 12.2 y posteriores. Este comodín amplía el nombre del archivo de volcado a un entero de incremento de ancho variable de 3 dígitos a 10 dígitos, comenzando en 100 y terminando en 2147483646.

     Utilice el comodín heredado %U o %u para las exportaciones de Oracle Database anteriores a la versión 12.2. Si utiliza esta opción y se necesitan más de 99 archivos de volcado, debe especificar varios nombres de archivo de volcado, cada uno con el parámetro %U o %u.

   • Si el cubo y los datos no residen en un dominio comercial (OC1), donde no están soportados los puntos finales dedicados de OCI, utilice el siguiente formato de URI para dumpfile:

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

   • El parámetro credential no puede ser un principal de servicio de Azure, un nombre de recurso de Amazon (ARN) o una cuenta de servicio de Google. Consulte Configuración de políticas y roles para acceder a recursos para obtener más información sobre la autenticación basada en entidad de recurso.

   • Al especificar el valor dumpfile como una URL autenticada previamente, se necesita el parámetro credential y el valor puede ser NULL.

     Consulte Uso de la importación de Oracle Data Pump con una URL autenticada previamente para obtener más información sobre los pasos necesarios para utilizar una URL autenticada previamente.

   Para dumpfile, en este ejemplo se utiliza el formato de URI recomendado mediante los puntos finales dedicados de OCI para el dominio comercial (OC1). namespace-string es el espacio del nombre de almacenaje de objetos de Oracle Cloud Infrastructure, y bucketname es el nombre del cubo. Consulte Puntos finales dedicados de Object Storage, Regiones y dominios de disponibilidad y Descripción de los espacios de nombres de Object Storage para obtener más información.

   Para obtener el formato para diferentes servicios de Cloud Object Storage, consulte Formatos DBMS_CLOUD de URI.

   En este ejemplo, se excluyen los siguientes elementos durante la importación de pump de datos:

   • Clusters

   • Tipos de índice

   • Enlaces de base de datos

   Para realizar una importación completa o importar objetos que sean propiedad de otros usuarios, necesita el rol DATAPUMP_CLOUD_IMP.

   Para obtener información sobre los objetos no permitidos en Autonomous Database, consulte Comandos SQL.

   Consulte Notas para la Importación con Oracle Data Pump para obtener notas adicionales sobre el uso de la importación de Oracle Data Pump.

   Consulte Compresión de tablas e importación de Oracle Data Pump para obtener más información sobre la compresión de tablas mediante la importación de Oracle Data Pump en Autonomous Database.

   Para obtener información detallada sobre los parámetros de Oracle Data Pump Import, consulte Oracle Database Utilities.

Oracle Data Pump soporta la importación de archivos de pump de datos a su instancia de Autonomous Database mediante una entidad de recurso de Oracle Cloud Infrastructure como objeto de credencial.

1. Configure los grupos dinámicos y las políticas y permita que la entidad de recurso de Oracle Cloud Infrastructure acceda a la ubicación del almacén de objetos en la que residen los archivos de pump de datos que desea importar.

   Consulte Uso de la entidad de recurso para acceder a recursos de Oracle Cloud Infrastructure para obtener más información.

2. Ejecute Data Pump Import con el parámetro dumpfile definido en la lista de URL de archivo de Cloud Object Storage y el parámetro credencial definido en OCI$RESOURCE_PRINCIPAL.

   Por ejemplo:

   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

   Notas para los parámetros de pump de datos:

   • Si durante la exportación con expdp ha utilizado el parámetro encryption_pwd_prompt=yes, también utilice encryption_pwd_prompt=yes e introduzca la misma contraseña en la petición de datos impdp que haya especificado durante la exportación.

   • El parámetro dumpfile soporta los comodines %L y %l, además de los comodines %U y %u heredados. Por ejemplo, dumpfile=export%L.dmp. Utilice el comodín %L o %l para las exportaciones de Oracle Database versión 12.2 y posteriores. Este comodín amplía el nombre del archivo de volcado a un entero de incremento de ancho variable de 3 dígitos a 10 dígitos, comenzando en 100 y terminando en 2147483646.

     Utilice el comodín heredado %U o %u para las exportaciones de Oracle Database anteriores a la versión 12.2. Si utiliza esta opción y se necesitan más de 99 archivos de volcado, debe especificar varios nombres de archivo de volcado, cada uno con el parámetro %U o %u.

   • Si el cubo y los datos no residen en un dominio comercial (OC1), donde no están soportados los puntos finales dedicados de OCI, utilice el siguiente formato de URI para dumpfile:

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

   • Al especificar el valor dumpfile como una URL autenticada previamente, se necesita el parámetro credential y el valor puede ser NULL.

     Consulte Uso de la importación de Oracle Data Pump con una URL autenticada previamente para obtener más información sobre los pasos necesarios para utilizar una URL autenticada previamente.

   Para dumpfile, en este ejemplo se utiliza el formato de URI recomendado mediante los puntos finales dedicados de OCI para el dominio comercial (OC1). namespace-string es el espacio del nombre de almacenaje de objetos de Oracle Cloud Infrastructure, y bucketname es el nombre del cubo. Consulte Puntos finales dedicados de Object Storage, Regiones y dominios de disponibilidad y Descripción de los espacios de nombres de Object Storage para obtener más información.

   Para obtener el formato para diferentes servicios de Cloud Object Storage, consulte Formatos DBMS_CLOUD de URI.

   En este ejemplo, se excluyen los siguientes elementos durante la importación de pump de datos:

   • Clusters

   • Tipos de índice

   • Enlaces de base de datos

   Para realizar una importación completa o importar objetos que sean propiedad de otros usuarios, necesita el rol DATAPUMP_CLOUD_IMP.

   Para obtener información sobre los objetos no permitidos en Autonomous Database, consulte Comandos SQL.

   Consulte Notas para la Importación con Oracle Data Pump para obtener notas adicionales sobre el uso de la importación de Oracle Data Pump.

   Para obtener información detallada sobre los parámetros de Oracle Data Pump Import, consulte Oracle Database Utilities.

Puede importar datos de archivos de pump de datos a su instancia de Autonomous Database mediante las versiones de cliente de pump de datos 12.2.0.1 y anteriores definiendo el parámetro default_credential.

1. Almacene su credencial de Cloud Object Storage mediante DBMS_CLOUD.CREATE_CREDENTIAL.

   Por ejemplo, para crear credenciales de token de autenticación de Oracle Cloud Infrastructure:

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

   Para obtener más información sobre la autenticación de token de autenticación de Oracle Cloud Infrastructure, consulte el procedimiento CREATE_CREDENTIAL.

   Por ejemplo, para crear credenciales basadas en la clave de firma de 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;
   /

   Para obtener más información sobre las credenciales basadas en claves de firma de Oracle Cloud Infrastructure, consulte el procedimiento CREATE_CREDENTIAL.

   Tipos de credenciales soportados:

   • La importación de pump de datos soporta credenciales basadas en token de autenticación de Oracle Cloud Infrastructure y credenciales basadas en clave de firma de Oracle Cloud Infrastructure.

     Para obtener más información sobre los tipos de credenciales para Oracle Cloud Infrastructure Cloud Object Storage, consulte el procedimiento CREATE_CREDENTIAL.

   • El pump de datos soporta el uso de una URL autenticada previamente de Oracle Cloud Infrastructure Object Storage para dumpfile. Al utilizar una URL autenticada previamente, es necesario definir DEFAULT_CREDENTIAL y el valor DEFAULT_CREDENTIAL puede ser NULL. Consulte Uso de solicitudes autenticadas previamente para obtener más información.

   • Data Pump soporta el uso de una credencial de entidad de recurso con impdp.

2. Defina la credencial como la credencial por defecto para su instancia de Autonomous Database, como usuario ADMIN. Por ejemplo:

   ALTER DATABASE PROPERTY SET DEFAULT_CREDENTIAL = 'ADMIN.DEF_CRED_NAME'

   DEFAULT_CREDENTIAL puede ser una entidad de recurso de OCI. Por ejemplo:

   ALTER DATABASE PROPERTY SET DEFAULT_CREDENTIAL = 'OCI$RESOURCE_PRINCIPAL'

   Consulte Configuración de políticas y roles para acceder a recursos para obtener más información sobre la autenticación basada en entidad de recurso.

   Nota
   
   El valor DEFAULT_CREDENTIAL no puede ser un principal de servicio de Azure, un nombre de recurso de Amazon (ARN) o una cuenta de servicio de Google.

   El valor DEFAULT_CREDENTIAL se puede definir en NULL si utiliza una URL autenticada previamente.

3. Ejecute Data Pump Import con el parámetro dumpfile definido en la lista de URL de archivo de Cloud Object Storage y defina la palabra clave default_credential. Por ejemplo:

   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
   

   Notas para los parámetros de pump de datos:

   • Si durante la exportación con expdp utiliza el parámetro encryption_pwd_prompt=yes, utilice encryption_pwd_prompt=yes e introduzca la misma contraseña en la petición de datos impdp que ha especificado durante la exportación.

   • El parámetro dumpfile soporta los comodines %L y %l, además de los comodines %U y %u heredados. Por ejemplo, dumpfile=export%L.dmp. Utilice el comodín %L o %l para las exportaciones de Oracle Database versión 12.2 y posteriores. Este comodín amplía el nombre del archivo de volcado a un entero de incremento de ancho variable de 3 dígitos a 10 dígitos, comenzando en 100 y terminando en 2147483646.

     Utilice el comodín heredado %U o %u para las exportaciones de Oracle Database anteriores a la versión 12.2. Si utiliza esta opción y se necesitan más de 99 archivos de volcado, debe especificar varios nombres de archivo de volcado, cada uno con el parámetro %U o %u.

   • Si el cubo y los datos no residen en un dominio comercial (OC1), donde no están soportados los puntos finales dedicados de OCI, utilice el siguiente formato de URI para dumpfile:

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

   • Al especificar el valor dumpfile como una URL autenticada previamente, se necesita definir el parámetro default_credential y el valor puede ser NULL.

     Consulte Uso de la importación de Oracle Data Pump con una URL autenticada previamente para obtener más información sobre los pasos necesarios para utilizar una URL autenticada previamente.

   Para dumpfile, en este ejemplo se utiliza el formato de URI recomendado mediante los puntos finales dedicados de OCI para el dominio comercial (OC1). namespace-string es el espacio Oracle Cloud Infrastructure, y bucketname es el nombre del cubo. Consulte Puntos finales dedicados de Object Storage, Regiones y dominios de disponibilidad y Descripción de los espacios de nombres de Object Storage para obtener más información.

   Para obtener el formato para diferentes servicios de Cloud Object Storage, consulte Formatos DBMS_CLOUD de URI.

   En este ejemplo, se excluyen los siguientes elementos durante la importación de pump de datos:

   • Clusters

   • Tipos de índice

   • Enlaces de base de datos

Proporciona los pasos para utilizar una URL autenticada previamente (URL de PAR) con la importación de Oracle Data Pump.

1. Utilice Oracle Data Pump expdp y exporte al almacenamiento local.

   Consulte Exportación de Oracle Database Existente a un Archivo de Base de Datos Local (Exportación sin Parámetro de Credencial) para obtener más información.

2. Cargue los archivos de volcado en Oracle Cloud Infrastructure Object Storage.

   Por ejemplo, utilice DBMS_CLOUD.PUT_OBJECT para cargar los archivos de volcado.

3. Cree una URL autenticada previamente en Oracle Cloud Infrastructure Object Storage, ya sea en el cubo del almacén de objetos si hay varios archivos de volcado o en el archivo de volcado, si solo hay un archivo.

   Consulte Solicitudes autenticadas previamente de Object Storage para obtener más información.

4. Importe los archivos de volcado con el valor del parámetro dumpfile definido en la URL autenticada previamente.

   Consulte Importación de datos mediante Oracle Data Pump versión 18.3 o posterior para obtener más información.