Documentación de Oracle Cloud Infrastructure

Exportación de Datos a un Directorio como Archivos de Oracle Data Pump

Puede exportar datos a un directorio como archivos de volcado de Oracle Data Pump especificando una consulta.

Con este método de exportación, se utiliza el procedimiento DBMS_CLOUD.EXPORT_DATA para especificar una consulta para seleccionar los datos que se van a exportar como archivo de volcado a un directorio.

  1. Conéctese a su instancia de base de datos de IA autónoma.
  2. Cree un directorio.

    Por ejemplo:

    CREATE DIRECTORY export_dir AS 'export_dir';
    Consulte Creación de directorio en base de datos de IA autónoma para obtener más información.
  3. Exporte datos de la base de datos de IA autónoma al directorio como archivos de volcado de Oracle Data Pump con DBMS_CLOUD.EXPORT_DATA y especifique el parámetro format type como datapump. Por ejemplo:
    BEGIN
 DBMS_CLOUD.EXPORT_DATA(
    file_uri_list => 'export_dir:sales.dmp',
    format => json_object('type' value 'datapump'),
    query => 'SELECT * FROM sales'
 );
END;
/

    Ejemplo para exportar datos como varios archivos de pump de datos a un directorio:

    BEGIN
 DBMS_CLOUD.EXPORT_DATA(
    file_uri_list => 'export_dir:sales1.dmp, export_dir:sales2.dmp',
    format => json_object('type' value 'datapump'),
    query => 'SELECT * FROM sales'
 );
END;
/

    Los parámetros son:

    • file_uri_list: es una lista delimitada por comas de los archivos de exportación. El uso de caracteres comodín y de sustitución no está soportado en file_uri_list.

    • format: especifica el parámetro type necesario. Los valores válidos son datapump, json, xml, csv y parquet, y también define opcionalmente las opciones que puede especificar para la exportación con el controlador de acceso ORACLE_DATAPUMP.

    • query: especifica una sentencia SELECT para que solo se exporten los datos necesarios. La consulta determina el contenido de los archivos de volcado.

    Nota

    El procedimiento DBMS_CLOUD.EXPORT_DATA crea los archivos de volcado que especifique en file_uri_list.

    Para obtener información detallada sobre los parámetros, consulte el Procedimiento EXPORT_DATA.

Notas para exportar datos con DBMS_CLOUD.EXPORT_DATA:

  • El directorio proporcionado debe existir y debe estar conectado como usuario ADMIN o tener acceso WRITE al directorio.

  • El procedimiento no sobrescribe los archivos. Si existe un archivo de volcado en file_uri_list, DBMS_CLOUD.EXPORT_DATA informa un error como: 

    ORA-31641: unable to create dump file  "/u02/exports/123.dmp"
ORA-27038: created file already exists

  • DBMS_CLOUD.EXPORT_DATA no crea directorios.

  • El nombre del directorio distingue entre mayúsculas y minúsculas cuando se incluye entre comillas dobles.

  • El número de archivos de volcado que genera DBMS_CLOUD.EXPORT_DATA se determina cuando se ejecuta el procedimiento. El número de archivos de volcado que se generan depende del número de nombres de archivo que proporcione en el parámetro file_uri_list, así como del número de ECPU disponibles para la instancia, el nivel de servicio y el tamaño de los datos.

    Por ejemplo, si utiliza una instancia de base de datos de IA autónoma de 2 ECPU o el servicio low, se exporta un único archivo de volcado sin paralelismo, incluso si proporciona varios nombres de archivo. Si utiliza una instancia de base de datos de IA autónoma de 8 ECPU con el servicio medium o high, los trabajos se pueden ejecutar en paralelo y se exportan varios archivos de volcado si proporciona varios nombres de archivo.

  • El valor del parámetro query que proporcione puede ser una consulta avanzada, si es necesario, como una consulta que incluya uniones o subconsultas.

  • Los archivos de volcado que cree con DBMS_CLOUD.EXPORT_DATA no se pueden importar mediante Oracle Data Pump impdp. Según la base de datos, puede utilizar estos archivos de la siguiente forma:

    • En una base de datos de AI autónoma, puede utilizar los archivos de volcado con los procedimientos DBMS_CLOUD que soportan el parámetro format type con el valor 'datapump'. Puede importar los archivos de volcado mediante DBMS_CLOUD.COPY_DATA o puede llamar a DBMS_CLOUD.CREATE_EXTERNAL_TABLE para crear una tabla externa.

    • En cualquier otra instancia de Oracle Database, como Oracle Database 19c local, puede importar los archivos de volcado creados con el procedimiento DBMS_CLOUD.EXPORT_DATA mediante el controlador de acceso ORACLE_DATAPUMP. Consulte Descarga y carga de datos con el controlador de acceso ORACLE_DATAPUMP para obtener más información.