Uso de Oracle Data Pump para exportar datos al almacén de objetos mediante el parámetro CREDENTIAL (versión 19.9 o posterior)

Muestra los pasos para exportar datos de su instancia de Autonomous Database a Cloud Object Storage con la exportación de Oracle Data Pump mediante el parámetro credential.

1. Conéctese a la base de datos.
2. Almacene su 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 va a exportar 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 Procedure para obtener más información.

3. Ejecute la exportación de Data Pump con el parámetro dumpfile definido para la URL de un cubo existente en Cloud Object Storage (que termina con un nombre del archivo o un nombre del archivo con una variable de sustitución, como exp%L.dmp, y con el parámetro credential definido para el nombre del credencial que ha creado en el paso anterior). Por ejemplo:

   expdp admin/password@db2022adb_high \
        filesize=5GB \
        credential=def_cred_name \
        dumpfile=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 para los parámetros de Oracle Data Pump:

   • 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.

   • 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 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.

   El parámetro 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 Acceso a recursos en la nube mediante la configuración de políticas y roles para obtener más información sobre la autenticación basada en entidad de recurso.

   Para obtener el mejor rendimiento a la exportación, utilice el servicio de base de datos HIGH para la conexión a la exportación y defina el parámetro parallel en un cuarto del número de ECPU (.25 x recuento de ECPU). Si utiliza el modelo de recursos informáticos 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 va a conectar para ejecutar la exportación de pump de datos, consulte Nombres de servicio de base de datos para Autonomous Database.

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

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

   • El valor máximo del parámetro filesize es 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 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 Acceso a Archivos Log para la Exportación de Data Pump 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 soportan el parámetro format type con el valor 'datapump', solo tiene que proporcionar el nombre de archivo principal. Los procedimientos que soportan el tipo del formato 'datapump' detectan y descargan automáticamente los fragmentos.

   Cuando se utiliza DBMS_CLOUD.DELETE_OBJECT, el procedimiento detecta y suprime automáticamente los fragmentos cuando el procedimiento suprime el archivo principal.

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

   Consulte Descarga, ejecución de Data Pump Import y limpieza del almacén de objetos para obtener más información.