Exportación de datos a un directorio mediante DBMS_CLOUD.EXPORT_DATA

Utilice DBMS_CLOUD.EXPORT_DATA para exportar archivos a un directorio.
El directorio al que se exportan los archivos puede estar en el sistema de archivos de Autonomous Database o en un sistema de archivos externo asociado. Para obtener más información, consulte las páginas siguientes:

Exportación de datos como CSV a un directorio

Muestra los pasos para exportar datos de tabla de Autonomous Database a un directorio como datos CSV especificando una consulta.

  1. Conéctese a la instancia de Autonomous Database.

    Consulte Conexión a Autonomous Database para obtener más información.

  2. Cree un directorio.

    Por ejemplo:

    CREATE DIRECTORY export_dir AS 'export_dir';
    Consulte Create a Directory para obtener más información.
  3. Ejecute DBMS_CLOUD.EXPORT_DATA y especifique el parámetro format type con el valor json para exportar los resultados como archivos CSV a un directorio. No incluya el parámetro credential al enviar la salida a un directorio.
    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => 'export_dir:sales.csv',
        format => JSON_OBJECT('type' value 'csv'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
    

    Cuando los delimitadores de registro incluyen caracteres de escape, como \r\n o \t, encierre los delimitadores de registro entre comillas dobles. Por ejemplo, para utilizar el delimitador de registro \r\n, escriba el valor entre comillas dobles:"\r\n".

    BEGIN
      DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => 'export_dir:sales.csv',
        query => 'SELECT * FROM sales',
        format => JSON_OBJECT('type' value 'json', 'recorddelimiter' value '"\r\n"' format json));
    END;
    /

    El nombre del directorio distingue entre mayúsculas y minúsculas cuando el nombre del directorio está entre comillas dobles. Por ejemplo:

    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => '"export_dir":sales.csv',
        format => JSON_OBJECT('type' value 'csv'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
    

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

    Para obtener información detallada sobre los parámetros format disponibles que puede utilizar con DBMS_CLOUD.EXPORT_DATA, consulte DBMS_CLOUD Opciones de formato del paquete para EXPORT_DATA.

    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 json, xml y csv.

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

    Note:

    El procedimiento DBMS_CLOUD.EXPORT_DATA crea los archivos de volcado que especifique en file_uri_list. El procedimiento no sobrescribe los archivos. Si existe un archivo de volcado en file_uri_list, DBMS_CLOUD.EXPORT_DATA genera otro archivo con un nombre único. DBMS_CLOUD.EXPORT_DATA no crea directorios.

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

Notas sobre la exportación con DBMS_CLOUD.EXPORT_DATA:

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

  • Especifique el parámetro format con la opción compression para comprimir los archivos de salida.

Exportar datos como directorio JSON

Muestra los pasos para exportar datos de tabla de Autonomous Database a un directorio como datos JSON especificando una consulta.

  1. Conéctese a la instancia de Autonomous Database.

    Consulte Conexión a Autonomous Database para obtener más información.

  2. Cree un directorio.

    Por ejemplo:

    CREATE DIRECTORY export_dir AS 'export_dir';
    Consulte Create a Directory para obtener más información.
  3. Run DBMS_CLOUD.EXPORT_DATA and specify the format parameter type with the value json to export the results as JSON files to a directory. Do not include the credential parameter when sending output to a directory.
    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => 'export_dir:sales.dmp',
        format => json_object('type' value 'json'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
    

    Cuando los delimitadores de registro incluyen caracteres de escape, como \r\n o \t, encierre los delimitadores de registro entre comillas dobles. Por ejemplo, para utilizar el delimitador de registro \r\n, escriba el valor entre comillas dobles:"\r\n".

    BEGIN
      DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => 'export_dir:sales.dmp',
        query => 'SELECT * FROM sales',
        format => JSON_OBJECT('type' value 'json', 'recorddelimiter' value '"\r\n"' format json));
    END;
    /

    El nombre del directorio distingue entre mayúsculas y minúsculas cuando el nombre del directorio está entre comillas dobles. Por ejemplo:

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

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

    Para obtener información detallada sobre los parámetros format disponibles que puede utilizar con DBMS_CLOUD.EXPORT_DATA, consulte DBMS_CLOUD Opciones de formato del paquete para EXPORT_DATA.

    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 json, xml y csv.

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

    Note:

    El procedimiento DBMS_CLOUD.EXPORT_DATA crea los archivos de volcado que especifique en file_uri_list. El procedimiento no sobrescribe los archivos. Si existe un archivo de volcado en file_uri_list, DBMS_CLOUD.EXPORT_DATA genera otro archivo con un nombre único. DBMS_CLOUD.EXPORT_DATA no crea directorios.

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

Notas sobre la exportación con DBMS_CLOUD.EXPORT_DATA:

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

  • Especifique el parámetro format con la opción compression para comprimir los archivos de salida.

Exportación de datos como Parquet a un directorio

Muestra los pasos para exportar datos de tabla de Autonomous Database a un directorio como datos de Parquet especificando una consulta.

  1. Conéctese a la instancia de Autonomous Database.

    Consulte Conexión a Autonomous Database para obtener más información.

  2. Cree un directorio.

    Por ejemplo:

    CREATE DIRECTORY export_dir AS 'export_dir';
    Consulte Create a Directory para obtener más información.
  3. Run DBMS_CLOUD.EXPORT_DATA and specify the format parameter type with the value json to export the results as Parquet files to a directory. Do not include the credential parameter when sending output to a directory.
    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => 'export_dir:sales.parquet',
        format => JSON_OBJECT('type' value 'parquet'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
    

    El nombre del directorio distingue entre mayúsculas y minúsculas cuando el nombre del directorio está entre comillas dobles. Por ejemplo:

    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => '"export_dir":sales.parquet',
        format => JSON_OBJECT('type' value 'parquet'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
    

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

    Para obtener información detallada sobre los parámetros format disponibles que puede utilizar con DBMS_CLOUD.EXPORT_DATA, consulte DBMS_CLOUD Opciones de formato del paquete para EXPORT_DATA.

    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.

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

Notas sobre la exportación con DBMS_CLOUD.EXPORT_DATA:

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

  • Especifique el parámetro format con la opción compression para comprimir los archivos de salida.

  • Consulte DBMS_CLOUD Asignación de tipo de datos de Oracle a Parquet para obtener más información sobre la asignación de tipo a Parquet de Oracle.

    Los siguientes tipos no están soportados o tienen limitaciones en su soporte para exportar Parquet con DBMS_CLOUD.EXPORT_DATA:

    Type Oracle Notas:

    BFILE

    No soportado

    BLOB

    No soportado

    DATE

    Soportado con la siguiente limitación: el formato DATE solo admite fecha, mes y año. Las horas, los minutos y los segundos no están soportados.

    Consulte DBMS_CLOUD Asignación de tipo de datos de Oracle a Parquet para obtener más información sobre las limitaciones de formato NLS para exportar DATE a Parquet.

    INTERVAL DAY TO SECOND

    Se admite y se trata como cadena internamente

    INTERVAL YEAR TO MONTH

    Se admite y se trata como cadena internamente

    LONG

    No soportado

    LONG RAW

    No soportado

    NUMBER

    Se admite con las siguientes limitaciones:

    • Puede tener una precisión máxima de 38 y una escala igual a menor que la precisión.
    • Si no se proporciona precisión ni escala para el tipo de columna NUMBER, se utiliza la precisión por defecto de 38 y la escala de 20.
    • La escala negativa no está soportada para los tipos NUMBER.

    Object Types

    No soportado

    TIMESTAMP

    Se admite con las siguientes limitaciones:

    • Si hay varias columnas con diferente precisión, se tomará la mayor precisión.
    • TIMESTAMP WITH TIME ZONE El tipo de dato de Oracle solo utilizará el registro de hora.

    Consulte DBMS_CLOUD Asignación de tipo de datos de Oracle a Parquet para obtener más información sobre las limitaciones de formato NLS para exportar TIMESTAMP a Parquet.

Exportar datos como XML a un directorio

Muestra los pasos para exportar datos de tabla de Autonomous Database al directorio como datos XML especificando una consulta.

  1. Conéctese a la instancia de Autonomous Database.

    Consulte Conexión a Autonomous Database para obtener más información.

  2. Cree un directorio.

    Por ejemplo:

    CREATE DIRECTORY export_dir AS 'export_dir';
    Consulte Create a Directory para obtener más información.
  3. Ejecute DBMS_CLOUD.EXPORT_DATA y especifique el parámetro format type con el valor json para exportar los resultados como archivos XML a un directorio. No incluya el parámetro credential al enviar la salida a un directorio.
    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => 'export_dir:sales.csv',
        format => JSON_OBJECT('type' value 'csv'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
    

    El nombre del directorio distingue entre mayúsculas y minúsculas cuando el nombre del directorio está entre comillas dobles. Por ejemplo:

    BEGIN
     DBMS_CLOUD.EXPORT_DATA(
        file_uri_list => '"export_dir":sales.xml',
        format => JSON_OBJECT('type' value 'xml'),
        query => 'SELECT * FROM sales'
     );
    END;
    /
    

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

    Para obtener información detallada sobre los parámetros format disponibles que puede utilizar con DBMS_CLOUD.EXPORT_DATA, consulte DBMS_CLOUD Opciones de formato del paquete para EXPORT_DATA.

    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 json, xml y csv.

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

    Note:

    El procedimiento DBMS_CLOUD.EXPORT_DATA crea los archivos de volcado que especifique en file_uri_list. El procedimiento no sobrescribe los archivos. Si existe un archivo de volcado en file_uri_list, DBMS_CLOUD.EXPORT_DATA genera otro archivo con un nombre único. DBMS_CLOUD.EXPORT_DATA no crea directorios.

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

Notas sobre la exportación con DBMS_CLOUD.EXPORT_DATA:

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

  • Especifique el parámetro format con la opción compression para comprimir los archivos de salida.