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 la 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 del token de autenticación de Oracle Cloud Infrastructure, consulte 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.

   • Data Pump 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, se necesita 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 la versión 18.3 o posterior de Oracle Data Pump con OCI Resource Principal para obtener más información.

2. Ejecute la importación de Data Pump 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 sobre los parámetros de pump de datos:

   • Si durante la exportación con expdp ha utilizado el parámetro encryption_pwd_prompt=yes, utilice encryption_pwd_prompt=yes e introduzca la misma contraseña en el indicador 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 en un entero que aumenta el ancho de variable de 3 dígitos a 10 dígitos, comenzando en 100 y terminando en 2147483646.

     Utilice el comodín %U o %u heredado 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 archivos 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 una entidad de servicio de Azure, un nombre de recurso de Amazon (ARN) o una cuenta de servicio de Google. Consulte Configure Policies and Roles to Access Resources para obtener más información sobre la autenticación basada en la 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 puntos finales dedicados de OCI para el dominio comercial (OC1). namespace-string es el espacio de nombres de almacenamiento 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 de URL de archivo de volcado para diferentes servicios de Cloud Object Storage, consulte DBMS_CLOUD Formatos 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 para utilizar la importación de Oracle Data Pump.

   Consulte Compresión de tablas e importación de Oracle Data Pump para obtener detalles 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 en Autonomous Database mediante una entidad de recurso de Oracle Cloud Infrastructure como objeto de credencial.

1. Configure las políticas y los grupos dinámicos y active la entidad de recurso de Oracle Cloud Infrastructure para acceder 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 entidad de recurso para acceder a los recursos de Oracle Cloud Infrastructure para obtener más información.

2. Ejecute la importación de Data Pump con el parámetro dumpfile definido en la lista de URL de archivo de Cloud Object Storage y el parámetro credential 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 sobre los parámetros de pump de datos:

   • Si durante la exportación con expdp ha utilizado el parámetro encryption_pwd_prompt=yes, utilice también encryption_pwd_prompt=yes e introduzca la misma contraseña en la petición de datos impdp especificada 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 en un entero que aumenta el ancho de variable de 3 dígitos a 10 dígitos, comenzando en 100 y terminando en 2147483646.

     Utilice el comodín %U o %u heredado 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 archivos 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 puntos finales dedicados de OCI para el dominio comercial (OC1). namespace-string es el espacio de nombres de almacenamiento 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 de URL de archivo de volcado para diferentes servicios de Cloud Object Storage, consulte DBMS_CLOUD Formatos 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 para utilizar 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 Autonomous Database mediante las versiones 12.2.0.1 y anteriores del cliente de pump de datos definiendo el parámetro default_credential.

1. Almacene la 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 del token de autenticación de Oracle Cloud Infrastructure, consulte 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.

   • Data Pump 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 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 Configure Policies and Roles to Access Resources para obtener más información sobre la autenticación basada en la entidad de recurso.

   Nota
   
   El valor DEFAULT_CREDENTIAL no puede ser una entidad 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 la importación de Data Pump 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 sobre los parámetros de pump de datos:

   • Si durante la exportación con expdp ha utilizado el parámetro encryption_pwd_prompt=yes, utilice encryption_pwd_prompt=yes e introduzca la misma contraseña en el indicador 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 en un entero que aumenta el ancho de variable de 3 dígitos a 10 dígitos, comenzando en 100 y terminando en 2147483646.

     Utilice el comodín %U o %u heredado 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 archivos 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, es necesario 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 puntos finales dedicados de OCI para el dominio comercial (OC1). namespace-string es el espacio de nombres de almacenamiento 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 de URL de archivo de volcado para diferentes servicios de Cloud Object Storage, consulte DBMS_CLOUD Formatos 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 SAP) 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.