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, utilice el procedimiento DBMS_CLOUD.EXPORT_DATA para especificar una consulta para seleccionar los datos que se van a exportar como un archivo de volcado a un directorio.

  1. Conéctese a la instancia de Autonomous Database.
  2. Create a directory.

    Por ejemplo:

    CREATE DIRECTORY export_dir AS 'export_dir';
    Consulte Creación de directorios en Autonomous Database para obtener más información.
  3. Export data from Autonomous Database to your directory as Oracle Data Pump dump file(s) with DBMS_CLOUD.EXPORT_DATA and specify the format parameter type as 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. file_uri_list no soporta el uso de caracteres comodín y de sustitución.

    • format: especifica el parámetro type necesario. Los valores válidos son datapump, json, xml, csv y parquet y, opcionalmente, también define 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 Procedimiento EXPORT_DATA.

Notas sobre la exportación de 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 notifica 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 es sensible a mayúsculas/minúsculas cuando está 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 Autonomous Database 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 Autonomous Database de CPU de 8 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 impdp de Oracle Data Pump. Según la base de datos, puede utilizar estos archivos de la siguiente forma:

    • En una instancia de Autonomous Database, puede utilizar los archivos de volcado con los procedimientos DBMS_CLOUD que admiten 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.