Documentación de Oracle Cloud Infrastructure

Uso de Oracle Data Pump para exportar datos a la propiedad DEFAULT_CREDENTIAL del valor del almacén de objetos

Muestra cómo exportar datos de la base de datos de IA autónoma al almacenamiento de objetos en la nube con la exportación de Oracle Data Pump y la propiedad DEFAULT_CREDENTIAL.

Autonomous AI Database 26ai admite la exportación de Data Pump a Oracle Cloud Infrastructure Object Storage, Amazon S3, Azure Blob Storage y Google Cloud Storage. Autonomous AI Database 19c soporta la exportación directa de Data Pump a Oracle Cloud Infrastructure Object Storage. Consulte Export with Credential Parameter.

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.

Nota

Nota: Database Actions proporciona un enlace para Oracle Instant Client. Para acceder a este enlace desde Database Actions, en Downloads, haga clic en Download Oracle Instant Client.

  1. Conéctese a su base de datos de IA autónoma.

  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 Procedimiento CREATE_CREDENTIAL para obtener más información.

  3. Como usuario ADMIN, defina la credencial que ha definido en los pasos 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 pump de datos 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). 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 para los parámetros de pump de datos:

    • 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 AI Database versión 12.2 y posteriores. 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 (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.

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

      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 al que conectarse para ejecutar la exportación de pump de datos, consulte Gestión de simultaneidad y prioridades en la 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.

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