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 la base de datos de IA autónoma o en un sistema de archivos externo asociado. Para obtener más información, consulte las siguientes páginas:

• Creación y gestión de directorios

• Asociar almacenamiento de archivos de red a base de datos de IA autónoma

• Asociar almacenamiento de archivos externo a base de datos de IA autónoma

Exportación de datos como CSV a un directorio

Muestra los pasos para exportar datos de tabla de la base de datos de IA autónoma a un directorio como datos CSV especificando una consulta.

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

   Consulte Conexión a una base de datos de IA autónoma para obtener más información.

2. Cree un directorio.

   Por ejemplo:

    CREATE DIRECTORY export_dir AS 'export_dir';
   

   Para obtener más información, consulte Create a Directory.

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, delimite 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 Package Format Options for 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.

   Nota: 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 para exportar 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 JSON en un directorio

Muestra los pasos para exportar datos de tabla de su base de datos de IA autónoma a un directorio como datos JSON especificando una consulta.

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

   Consulte Conexión a una base de datos de IA autónoma para obtener más información.

2. Cree un directorio.

   Por ejemplo:

    CREATE DIRECTORY export_dir AS 'export_dir';
   

   Para obtener más información, consulte Create a Directory.

3. Ejecute DBMS_CLOUD.EXPORT_DATA y especifique el parámetro format type con el valor json para exportar los resultados como archivos JSON 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.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, delimite 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 Package Format Options for 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.

   Nota: 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 para exportar 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 la base de datos de IA autónoma a un directorio como datos de Parquet especificando una consulta.

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

   Consulte Conexión a una base de datos de IA autónoma para obtener más información.

2. Cree un directorio.

   Por ejemplo:

    CREATE DIRECTORY export_dir AS 'export_dir';
   

   Para obtener más información, consulte Create a Directory.

3. Ejecute DBMS_CLOUD.EXPORT_DATA y especifique el parámetro format type con el valor json para exportar los resultados como archivos de Parquet 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.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 Package Format Options for 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 para exportar 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 Asignación de tipo de dato de Oracle a Parquet de paquete DBMS_CLOUD para obtener más información sobre la asignación de tipo de Oracle a tipo de parquet.

  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. La hora, el minuto y los segundos no están soportados. Consulte Asignación de tipo de datos de Oracle a Parquet del paquete DBMS_CLOUD para obtener más información sobre las limitaciones de formato NLS para exportar DATE a Parquet.
  INTERVAL DAY TO SECOND	Soportado y se trata como cadena internamente
  INTERVAL YEAR TO MONTH	Soportado 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 y escala para el tipo de columna NUMBER, se utiliza por defecto una precisión de 38 y una escala de 20. - No se admite la escala negativa para los tipos NUMBER.
  Object Types	No soportado
  TIMESTAMP	Soportado con las siguientes limitaciones: - Si hay varias columnas con diferente precisión, se realizará la mayor precisión. - TIMESTAMP WITH TIME ZONE El tipo de dato de Oracle solo utilizará el registro de hora. Consulte Asignación de tipo de datos de Oracle a Parquet del paquete DBMS_CLOUD para obtener detalles sobre las limitaciones de formato NLS para exportar TIMESTAMP a Parquet.

Exportación de datos como XML a un directorio

Muestra los pasos para exportar datos de tabla de la base de datos de IA autónoma al directorio como datos XML mediante la especificación de una consulta.

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

   Consulte Conexión a una base de datos de IA autónoma para obtener más información.

2. Cree un directorio.

   Por ejemplo:

    CREATE DIRECTORY export_dir AS 'export_dir';
   

   Para obtener más información, consulte Create a Directory.

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 Package Format Options for 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.

   Nota: 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 para exportar 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.

Contenido relacionado

• Procedimiento EXPORT_DATA

• Opciones del formato del paquete DBMS_CLOUD para EXPORT_DATA