Muestra los pasos para exportar datos de Autonomous Database a Cloud Object Storage con la exportación de Oracle Data Pump y definir la propiedad DEFAULT_CREDENTIAL.

1. Conexión a la instancia de Autonomous Database.
2. Almacene la credencial de Cloud Object Storage mediante DBMS_CLOUD.CREATE_CREDENTIAL. Por ejemplo:

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

   Los valores que proporcione para username y password dependen del servicio de Cloud Object Storage que utilice.

   Si está exportando a Oracle Cloud Infrastructure Object Storage, puede utilizar los URI nativos de Oracle Cloud Infrastructure o los URI de Swift, pero las credenciales deben ser tokens de autenticación. Consulte CREATE_CREDENTIAL Procedimiento para obtener más información.

3. Como usuario ADMIN, defina la credencial que ha definido en el paso 2 como la credencial por defecto para la base de datos. Por ejemplo:

   ALTER DATABASE PROPERTY SET DEFAULT_CREDENTIAL = 'ADMIN.DEF_CRED_NAME'

   El valor DEFAULT_CREDENTIAL no puede ser una entidad de recurso de OCI, una entidad 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.

4. Ejecute la exportación de Data Pump con el parámetro dumpfile definido en la URL de un cubo existente en Cloud Object Storage (que termina con un nombre de archivo o un nombre de archivo con una variable de sustitución, como exp%L.dmp). Por ejemplo:

   expdp admin/password@db2022adb_high \
        filesize=5GB \
        dumpfile=default_credential:https://namespace-string.objectstorage.us-ashburn-1.oci.customer-oci.com/n/namespace-string/b/bucketname/o/exp%L.dmp \
        parallel=16 \
        encryption_pwd_prompt=yes \
        logfile=export.log \
        directory=data_pump_dir
   

   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.

   • 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

   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.

   Se requiere la palabra clave default_credential en el parámetro dumpfile.

   Para obtener el mejor rendimiento de exportación, utilice el servicio de base de datos HIGH para la conexión de exportación y defina el parámetro parallel en una cuarta parte del número de ECPU (.25 x recuento de EPU). Si utiliza el modelo de cálculo de OCPU, defina el parámetro paralelo en el número de OCPU (1 x recuento de OCPU).

   Para obtener información sobre el nombre del servicio de base de datos que se conectará para ejecutar la exportación de Data Pump, consulte Gestión de la moneda y las prioridades en Autonomous Database.

   Para obtener el formato de URL de archivo de volcado para diferentes servicios de Cloud Object Storage, consulte DBMS_CLOUD URI Formats.

   En este ejemplo se muestran los parámetros recomendados para la exportación desde Autonomous Database. Para estos parámetros expdp, tenga en cuenta lo siguiente:

   • El valor máximo del parámetro filesize es de 10000 MB para las exportaciones de Oracle Cloud Infrastructure Object Storage.

   • El valor máximo del parámetro filesize es de 20 GB para las exportaciones de Oracle Cloud Infrastructure Object Storage Classic.

   • Si el valor de filesize especificado es demasiado grande, la exportación muestra el mensaje de error:

     ORA-17500: ODM err:ODM HTTP Request Entity Too Large

   • El parámetro directory especifica el directorio data_pump_dir para el archivo log especificado, export.log. Consulte Access Log Files for Data Pump Export para obtener más información.

   Oracle Data Pump divide cada parte del archivo de volcado en fragmentos más pequeños para cargas más rápidas. La consola de Oracle Cloud Infrastructure Object Storage muestra varios archivos para cada parte del archivo de volcado que exporte. El tamaño de los archivos de volcado reales se mostrará como cero (0) y sus fragmentos de archivo relacionados como 10 MB o menos. Por ejemplo:

   exp100.dmp
   exp100.dmp_aaaaaa
   exp101.dmp
   exp101.dmp_aaaaaa

   Al descargar el archivo de volcado de cero bytes desde la consola de Oracle Cloud Infrastructure o mediante la CLI de Oracle Cloud Infrastructure, no obtendrá todos los archivos de volcado. Para descargar todos los archivos de volcado del almacén de objetos, utilice una herramienta que soporte Swift, como curl, y proporcione su conexión de usuario y token de autenticación Swift. Por ejemplo:

   curl -O -v -X GET -u 'user1@example.com:auth_token' \
      https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/namespace-string/bucketname/exp100.dmp

   Si importa un archivo con los procedimientos DBMS_CLOUD que soporten el parámetro format type con el valor 'datapump', solo debe proporcionar el nombre de archivo principal. Los procedimientos que soportan el tipo de formato 'datapump' detectan y descargan automáticamente los fragmentos.

   Al utilizar DBMS_CLOUD.DELETE_OBJECT, el procedimiento detecta y suprime automáticamente los fragmentos cuando el procedimiento suprime el archivo principal.

5. Realice los pasos necesarios para utilizar la importación y limpieza de Oracle Data Pump.

   Consulte Descarga de archivos de volcado, ejecución de la importación de Data Pump y limpieza del almacén de objetos para obtener detalles.