uso de Oracle Data Pump para exportar datos al almacén del objeto mediante los parámetros CREDENTIAL

Muestra los pasos para exportar datos de la base de datos de IA autónoma a Cloud Object Storage con la exportación de Oracle Data Pump mediante el parámetro credential.

Oracle recomienda utilizar la última versión de la aplicación Oracle Data Pump para exportar datos de Autonomous AI Database a otras bases de datos de la aplicación Oracle, ya que contiene mejoras y correcciones para una mejor experiencia. Descargue la versión más reciente de Oracle Instant Client y el paquete de herramientas, que incluye Oracle Data Pump, para su plataforma desde Oracle Instant Client Downloads. Consulte las instrucciones de instalación en la página de descarga de instalación de la plataforma para conocer los pasos de instalación necesarios después de descargar Oracle Instant Client y el paquete de herramientas.

Si utiliza Oracle Data Pump versión 19.9 o posterior, puede utilizar el parámetro credential como se muestra en estos pasos. Para obtener instrucciones sobre cómo utilizar las versiones 19.8 y anteriores de Oracle Data Pump, consulte Uso de Oracle Data Pump para Exportar Datos a la Propiedad DEFAULT_CREDENTIAL del valor del almacén .

1. Conéctese a la base de datos.

2. Almacene las credenciales 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 exporta a Oracle Cloud Infrastructure Object Storage, los métodos de autenticación disponibles dependen de la versión de la base de datos:

   • En Oracle AI Database 26ai, puede utilizar URI nativos de Oracle Cloud Infrastructure con autenticación nativa de OCI, incluidas las credenciales de entidad de recurso.

   • En Oracle AI Database 19c, puede utilizar URI nativos de Oracle Cloud Infrastructure o URI de Swift, pero las credenciales deben ser tokens de autenticación.

   Para obtener más información, consulte Procedimiento CREATE_CREDENTIAL.

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. Este comodín amplía el nombre del archivo de volcado a un entero que aumenta el 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, 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. 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 mejor rendimiento a la exportación, utilice el servicio de base de datos HIGH para la conexión a 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 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 con el que conectarse para ejecutar la exportación de pump de datos, consulte Nombres de servicio de base de datos para base de datos de IA autónoma.

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

   En este ejemplo se muestran los parámetros recomendados para exportar desde la base de datos de IA autónoma. 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 y limpieza del almacén de objetos para obtener más información.

Nota

Nota: para realizar una exportación completa o exportar objetos propiedad de otros usuarios, necesita el rol DATAPUMP_CLOUD_EXP.

Para obtener información detallada sobre los parámetros Oracle Data Pump Export, consulte Utilidades de Oracle AI Database.