Muestra los pasos para exportar datos de la base de datos a Object Storage con Oracle Data Pump.

1. Conéctese a la base de datos.
2. Store 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 Procedimiento CREATE_CREDENTIAL para obtener más información.

3. Ejecute la exportación de Data Pump con el parámetro dumpfile definido en la dirección URL de un cubo existente en la base de datos de Object Storage en la nube, terminando en un nombre de archivo o un nombre de archivo con una variable de sustitución, como exp%U.dmp, y con el parámetro credential definido en el nombre de la credencial creada en el paso anterior. Por ejemplo:

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

   Nota
   
   Si durante la exportación con expdp utiliza el parámetro encryption_pwd_prompt=yes, utilice encryption_pwd_prompt=yes con la importación e introducir la misma contraseña en el indicador impdp para descifrar los archivos de volcado (recuerde la contraseña que proporciona con la exportación). La longitud máxima de la contraseña de cifrado es de 128 bytes.

   En este ejemplo, namespace-string es el espacio de nombres de almacenamiento de objetos de Oracle Cloud Infrastructure, y bucketname es el nombre del cubo. Consulte 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 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 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 conectará para ejecutar la exportación de Data Pump, consulte Nombres de servicios de base de datos para Autonomous Data Warehouse.

   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, observe 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.

   Nota
   
   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:

   exp01.dmp
   exp01.dmp_aaaaaa
   exp02.dmp
   exp02.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.

   curl -O -v -X GET -u 'user1@example.com:auth_token' \
      https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/namespace-string/bucketname/exp01.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 admiten el tipo de formato 'datapump' detectan y descartan 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.

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