Exportación de datos al almacén de objetos como texto mediante DBMS_CLOUD.EXPORT_DATA

Utilice DBMS_CLOUD.EXPORT_DATA para exportar datos como texto de una base de datos de IA autónoma al almacén de objetos en la nube. Las opciones de exportación de formato de texto son CSV, JSON o XML.

Exportación de datos de JSON a Cloud Object Storage

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

Este método de exportación soporta todos los almacenes de objetos en la nube soportados por Autonomous Database, y puede utilizar una entidad de recurso de Oracle Cloud Infrastructure para acceder a Oracle Cloud Infrastructure Object Store, Amazon Resource Names (ARN) para acceder a AWS Simple Storage Service (S3), una entidad de servicio de Azure para acceder al almacenamiento BLOB de Azure o una cuenta de servicio de Google para acceder a los recursos de Google Cloud Platform (GCP).

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

  3. Ejecute DBMS_CLOUD.EXPORT_DATA y especifique el parámetro format type con el valor json para exportar los resultados como archivos JSON en Cloud Object Storage.

    Para generar los archivos de salida JSON, hay dos opciones para el parámetro file_uri_list:

    • Defina el valor file_uri_list en la URL de un cubo existente en Cloud Object Storage.

    • Defina el valor file_uri_list en la URL de un cubo existente en Cloud Object Storage e incluya un prefijo de nombre de archivo que se utilizará al generar los nombres de archivo para el JSON exportado.

    Si no incluye el prefijo de nombre de archivo en file_uri_list, DBMS_CLOUD.EXPORT_DATA proporciona un prefijo de nombre de archivo. Consulte Nombre de archivo para salida de texto (CSV, JSON, Parquet o XML) para obtener más información.

    Por ejemplo, a continuación se muestra DBMS_CLOUD.EXPORT_DATA con un prefijo de nombre de archivo especificado en file_uri_list:

     BEGIN
   DBMS_CLOUD.EXPORT_DATA(
     credential_name => 'DEF_CRED_NAME',
     file_uri_list   => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/dept_export',
     query           => 'SELECT * FROM DEPT',
     format          => JSON_OBJECT('type' value 'json'));
 END;
 /

    En este ejemplo, *namespace-string* es el espacio y bucketname es el nombre del cubo de Oracle Cloud Infrastructure. Consulte Descripción de los espacios de nombres de Object Storage para obtener más información.

    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(
     credential_name => 'DEF_CRED_NAME',
     file_uri_list   => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/dept_export',
     query => 'SELECT * FROM DEPT',
     format => JSON_OBJECT('type' value 'json', 'recorddelimiter' value '"\r\n"' format json));
 END;
 /

    En este ejemplo, *namespace-string* es el espacio y bucketname es el nombre del cubo de Oracle Cloud Infrastructure. Consulte Descripción de los espacios de nombres de Object Storage para obtener más información.

    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.

Notas para exportar con DBMS_CLOUD.EXPORT_DATA:

Exportación de datos como CSV a Cloud Object Storage

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

Este método de exportación soporta todos los almacenes de objetos en la nube soportados por la base de datos de IA autónoma. También puede utilizar Amazon Resource Names (ARNs) para acceder a AWS Simple Storage Service (S3), un principal de servicio de Azure para acceder al almacenamiento BLOB de Azure o una cuenta de servicio de Google para acceder a los recursos de Google Cloud Platform (GCP).

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

  3. Ejecute DBMS_CLOUD.EXPORT_DATA y especifique el parámetro format type con el valor csv para exportar los resultados como archivos CSV en Cloud Object Storage.

    Para generar los archivos de salida CSV, hay dos opciones para el parámetro file_uri_list:

    • Defina el valor file_uri_list en la URL de un cubo existente en Cloud Object Storage.

    • Defina el valor file_uri_list en la URL de un cubo existente en Cloud Object Storage e incluya un prefijo de nombre de archivo que se utilizará al generar los nombres de archivo para los archivos CSV exportados.

    Si no incluye el prefijo de nombre de archivo en file_uri_list, DBMS_CLOUD.EXPORT_DATA proporciona un prefijo de nombre de archivo. Consulte Nombre de archivo para salida de texto (CSV, JSON, Parquet o XML) para obtener más información.

    Por ejemplo, a continuación se muestra DBMS_CLOUD.EXPORT_DATA con un prefijo de nombre de archivo especificado en file_uri_list:

     BEGIN
   DBMS_CLOUD.EXPORT_DATA(
     credential_name => 'DEF_CRED_NAME',
     file_uri_list   => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/dept_export',
     query           => 'SELECT * FROM DEPT',
     format          => JSON_OBJECT('type' value 'csv', 'delimiter' value '|', 'compression' value 'gzip'));
 END;
 /

    En este ejemplo, *namespace-string* es el espacio en el que se almacenan objetos de Oracle Cloud Infrastructure y bucketname es el nombre del cubo. Consulte Descripción de los espacios de nombres de Object Storage para obtener más información.

    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.

Notas para exportar con DBMS_CLOUD.EXPORT_DATA:

Exportación de datos como Parquet al almacenamiento de objetos en la nube

Muestra los pasos para exportar datos de tabla de la base de datos de IA autónoma a Cloud Object Storage como datos de Parquet especificando una consulta.

Este método de exportación soporta todos los almacenes de objetos en la nube soportados por Autonomous Database, y puede utilizar una entidad de recurso de Oracle Cloud Infrastructure para acceder a Oracle Cloud Infrastructure Object Store, Amazon Resource Names (ARN) para acceder a AWS Simple Storage Service (S3), una entidad de servicio de Azure para acceder al almacenamiento BLOB de Azure o una cuenta de servicio de Google para acceder a los recursos de Google Cloud Platform (GCP).

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

  3. Ejecute DBMS_CLOUD.EXPORT_DATA y especifique el parámetro format type con el valor parquet para exportar los resultados como archivos de parquet en Cloud Object Storage.

    Para generar los archivos de salida de parquet, hay dos opciones para el parámetro file_uri_list:

    • Defina el valor file_uri_list en la URL de un cubo existente en Cloud Object Storage.

    • Defina el valor file_uri_list en la URL de un cubo existente en Cloud Object Storage e incluya un prefijo de nombre de archivo que se utilizará al generar los nombres de archivo para los archivos de parquet exportados.

    Si no incluye el prefijo de nombre de archivo en file_uri_list, DBMS_CLOUD.EXPORT_DATA proporciona un prefijo de nombre de archivo. Consulte Nombre de archivo para salida de texto (CSV, JSON, Parquet o XML) para obtener más información.

    Por ejemplo, a continuación se muestra DBMS_CLOUD.EXPORT_DATA con un prefijo de nombre de archivo especificado en file_uri_list:

     BEGIN
   DBMS_CLOUD.EXPORT_DATA(
     credential_name => 'DEF_CRED_NAME',
     file_uri_list   => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/dept_export',
     query           => 'SELECT * FROM DEPT',
     format          => JSON_OBJECT('type' value 'parquet', 'compression' value 'snappy'));
 END;
 /

    En este ejemplo, *namespace-string* es el espacio en el que se almacenan objetos de Oracle Cloud Infrastructure y bucketname es el nombre del cubo. Consulte Descripción de los espacios de nombres de Object Storage para obtener más información.

    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.

Notas para exportar con DBMS_CLOUD.EXPORT_DATA:

Exportación de datos como XML a Cloud Object Storage

Muestra los pasos para exportar datos de tabla de la base de datos de IA autónoma a Cloud Object Storage como datos XML especificando una consulta.

Este método de exportación soporta todos los almacenes de objetos en la nube soportados por la base de datos de IA autónoma. También puede utilizar Amazon Resource Names (ARNs) para acceder a AWS Simple Storage Service (S3), un principal de servicio de Azure para acceder al almacenamiento BLOB de Azure o una cuenta de servicio de Google para acceder a los recursos de Google Cloud Platform (GCP).

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

  3. Ejecute DBMS_CLOUD.EXPORT_DATA y especifique el parámetro format type con el valor xml para exportar los resultados como archivos XML en Cloud Object Storage.

    Para generar los archivos de salida XML, hay dos opciones para el parámetro file_uri_list:

    • Defina el valor file_uri_list en la URL de un cubo existente en Cloud Object Storage.

    • Defina el valor file_uri_list en la URL de un cubo existente en Cloud Object Storage e incluya un prefijo de nombre de archivo que se utilizará al generar los nombres de archivo para el JSON exportado.

    Si no incluye el prefijo de nombre de archivo en file_uri_list, DBMS_CLOUD.EXPORT_DATA proporciona un prefijo de nombre de archivo. Consulte Nombre de archivo para salida de texto (CSV, JSON, Parquet o XML) para obtener más información.

    Por ejemplo, a continuación se muestra DBMS_CLOUD.EXPORT_DATA con un prefijo de nombre de archivo especificado en file_uri_list:

     BEGIN
   DBMS_CLOUD.EXPORT_DATA(
     credential_name => 'DEF_CRED_NAME',
     file_uri_list   => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/dept_export',
     query           => 'SELECT * FROM DEPT',
     format          => JSON_OBJECT('type' value 'xml', 'compression' value 'gzip'));
 END;
 /

    En este ejemplo, *namespace-string* es el espacio en el que se almacenan objetos de Oracle Cloud Infrastructure y bucketname es el nombre del cubo. Consulte Descripción de los espacios de nombres de Object Storage para obtener más información.

    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.

Notas para exportar con DBMS_CLOUD.EXPORT_DATA:

Nomenclatura de archivos para salida de texto (CSV, JSON, Parquet o XML)

Describe la nomenclatura del archivo de salida mediante DBMS_CLOUD.EXPORT_DATA con la salida del archivo de texto CSV, JSON, Parquet o XML.

DBMS_CLOUD.EXPORT_DATA realiza la consulta especificada con el parámetro query y envía los resultados a archivos de texto en el cubo del almacén de objetos en la nube o a un directorio. El formato de salida depende del parámetro format type que especifique (uno de CSV, JSON, Parquet o XML).

Para acelerar el procedimiento y generar la salida lo más rápido posible, DBMS_CLOUD.EXPORT_DATA divide su trabajo. Esto significa que, según los recursos del sistema, al ejecutar DBMS_CLOUD.EXPORT_DATA, el procedimiento crea varios archivos de salida en el cubo del almacén de objetos en la nube o en el directorio.

El formato de cada archivo generado es el siguiente:

[FileNamePrefix | client_info_module_action]_sequenceNum_timestamp.format_extension.[extensión_compresión]

Por ejemplo, el prefijo de nombre de archivo en el siguiente procedimiento DBMS_CLOUD.EXPORT_DATA se especifica en el parámetro file_uri_list, como dept_export. En el ejemplo se genera la salida para el almacén de objetos proporcionado en el formato especificado.

BEGIN
  DBMS_CLOUD.EXPORT_DATA(
    credential_name => 'DEF_CRED_NAME',
    file_uri_list   => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/dept_export',
    query           => 'SELECT * FROM DEPT',
    format          => JSON_OBJECT('type' value 'json'));
END;
/

Al especificar un prefijo de nombre de archivo, los archivos de salida generados incluyen el prefijo de nombre de archivo, similar al siguiente:

dept_export_1_20210809T173033Z.json
dept_export_2_20210809T173034Z.json
dept_export_3_20210809T173041Z.json
dept_export_4_20210809T173035Z.json

El número de archivos de salida generados depende del tamaño de los resultados, el servicio de base de datos y el número de ECPU (OCPU si la base de datos utiliza OCPU) en la instancia de base de datos de IA autónoma.

En el siguiente ejemplo, el parámetro file_uri_list no incluye un prefijo de nombre de archivo y se proporciona el parámetro compression, con el valor gzip:

BEGIN
  DBMS_CLOUD.EXPORT_DATA(
    credential_name => 'DEF_CRED_NAME',
    file_uri_list   => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/',
    query           => 'SELECT * FROM DEPT',
    format          => json_object('type' value 'json', 'compression' value 'gzip'));
END;
/

Cuando un prefijo de nombre de archivo no está en el parámetro file_uri_list, DBMS_CLOUD.EXPORT_DATA utiliza un prefijo de nombre de archivo con el formato: client_info_module_action. Para este ejemplo, los archivos de salida generados incluyen el prefijo de nombre de archivo que DBMS_CLOUD.EXPORT_DATA proporciona y los archivos se comprimen con gzip y se agrega la extensión de archivo .gz, de la siguiente manera:

Client1_Module1_Action1_1_20210809T173033Z.json.gz
Client1_Module1_Action1_2_20210809T173034Z.json.gz
Client1_Module1_Action1_3_20210809T173041Z.json.gz
Client1_Module1_Action1_4_20210809T173035Z.json.gz

Si la información de la sesión client_info_module_action no está disponible al ejecutar DBMS_CLOUD.EXPORT_DATA, el prefijo del nombre de archivo se establece en data. Por ejemplo:

data_1_20210809T173033Z.json.gz
data_2_20210809T173034Z.json.gz
data_3_20210809T173041Z.json.gz
data_4_20210809T173035Z.json.gz

Por ejemplo, el prefijo de nombre de archivo en el siguiente procedimiento DBMS_CLOUD.EXPORT_DATA se especifica en el parámetro file_uri_list, como dept_export. El ejemplo genera la salida en el directorio proporcionado en el formato especificado.

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

Al especificar un prefijo de nombre de archivo, el archivo de salida generado incluye el prefijo de nombre de archivo, similar al siguiente:

sales_1_20230705T124523275915Z.csv

Notas para la nomenclatura de archivos con DBMS_CLOUD.EXPORT_DATA:

Contenido relacionado