Exporter les données vers la banque d'objets sous forme de texte à l'aide de DBMS_CLOUD.EXPORT_DATA

Utilisez DBMS_CLOUD.EXPORT_DATA pour exporter des données sous forme de texte d'une base de données Autonomous AI vers une banque d'objets cloud. Les options d'exportation de format de texte sont CSV, JSON ou XML.

Exporter des données JSON vers le stockage d'objet cloud

Affiche les étapes d'export de données de table de votre base de données Autonomous AI vers Cloud Object Storage en tant que données JSON en indiquant une requête.

Cette méthode d'export prend en charge toutes les banques d'objets cloud prises en charge par Autonomous Database. Vous pouvez utiliser un principal de ressource Oracle Cloud Infrastructure pour accéder à votre banque d'objets Oracle Cloud Infrastructure, à des noms de ressource Amazon (ARN) pour accéder à AWS Simple Storage Service (S3), à un principal de service Azure pour accéder au stockage BLOB Azure ou à un compte de service Google pour accéder aux ressources Google Cloud Platform (GCP).

  1. Connectez-vous à votre instance Autonomous AI Database.

    Pour plus d'informations, reportez-vous à Connexion à Autonomous AI Database.

  2. Stockez vos informations d'identification de stockage d'objet cloud à l'aide de la procédure DBMS_CLOUD.CREATE_CREDENTIAL,

    Exemple :

     BEGIN
   DBMS_CLOUD.CREATE_CREDENTIAL(
     credential_name => 'DEF_CRED_NAME',
     username => 'user1@example.com',
     password => 'password'
   );
 END;
 /

    Les valeurs fournies pour username et password dépendent du service Cloud Object Storage que vous utilisez .

  3. Exécutez DBMS_CLOUD.EXPORT_DATA et indiquez le paramètre format type avec la valeur json pour exporter les résultats en tant que fichiers JSON sur Cloud Object Storage.

    Pour générer les fichiers de sortie JSON, deux options sont disponibles pour le paramètre file_uri_list :

    • Définissez la valeur file_uri_list sur l'URL d'un bucket existant sur le stockage d'objet cloud.

    • Définissez la valeur file_uri_list sur l'URL d'un bucket existant sur le stockage d'objet cloud et incluez un préfixe de nom de fichier à utiliser lors de la génération des noms de fichier pour le JSON exporté.

    Si vous n'incluez pas le préfixe de nom de fichier dans file_uri_list, DBMS_CLOUD.EXPORT_DATA fournit un préfixe de nom de fichier. Pour plus de détails, reportez-vous à Dénomination de fichier pour la sortie texte (CSV, JSON, Parquet ou XML).

    Par exemple, l'exemple suivant montre DBMS_CLOUD.EXPORT_DATA avec un préfixe de nom de fichier spécifié dans 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;
 /

    Dans cet exemple, *namespace-string* est l'espace de noms Oracle Cloud Infrastructure Object Storage et bucketname est le nom du bucket. Pour plus d'informations, reportez-vous à Présentation des espaces de noms Object Storage.

    Lorsque les délimiteurs d'enregistrement incluent des caractères d'échappement, tels que \r\n ou \t, placez les délimiteurs d'enregistrement entre guillemets. Par exemple, pour utiliser le délimiteur d'enregistrement \r\n, mettez la valeur entre guillemets doubles :"\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;
 /

    Dans cet exemple, *namespace-string* est l'espace de noms Oracle Cloud Infrastructure Object Storage et bucketname est le nom du bucket. Pour plus d'informations, reportez-vous à Présentation des espaces de noms Object Storage.

    Pour obtenir des informations détaillées sur les paramètres, reportez-vous à la procédure EXPORT_DATA.

    Pour plus d'informations sur les paramètres format disponibles que vous pouvez utiliser avec DBMS_CLOUD.EXPORT_DATA, reportez-vous à Options de format de package DBMS_CLOUD pour EXPORT_DATA.

Notes pour l'exportation avec DBMS_CLOUD.EXPORT_DATA :

Export de données au format CSV vers le stockage d'objet cloud

Affiche les étapes d'export de données de table de votre base de données Autonomous AI vers Cloud Object Storage en tant que données CSV en spécifiant une requête.

Cette méthode d'export prend en charge tous les magasins d'objets cloud pris en charge par la base de données Autonomous AI. Vous pouvez également utiliser les noms de ressource Amazon (ARN) pour accéder à AWS Simple Storage Service (S3), un principal de service Azure pour accéder au stockage BLOB Azure ou un compte de service Google pour accéder aux ressources Google Cloud Platform (GCP).

  1. Connectez-vous à votre instance Autonomous AI Database.

    Pour plus d'informations, reportez-vous à Connexion à Autonomous AI Database.

  2. Stockez vos informations d'identification de stockage d'objet cloud à l'aide de la procédure DBMS_CLOUD.CREATE_CREDENTIAL,

    Exemple :

     BEGIN
   DBMS_CLOUD.CREATE_CREDENTIAL(
     credential_name => 'DEF_CRED_NAME',
     username => 'user1@example.com',
     password => 'password'
   );
 END;
 /

    Les valeurs fournies pour username et password dépendent du service Cloud Object Storage que vous utilisez .

  3. Exécutez DBMS_CLOUD.EXPORT_DATA et indiquez le paramètre format type avec la valeur csv pour exporter les résultats en tant que fichiers CSV dans Cloud Object Storage.

    Pour générer les fichiers de sortie CSV, deux options sont disponibles pour le paramètre file_uri_list :

    • Définissez la valeur file_uri_list sur l'URL d'un bucket existant sur le stockage d'objet cloud.

    • Définissez la valeur file_uri_list sur l'URL d'un bucket existant sur le stockage d'objet cloud et incluez un préfixe de nom de fichier à utiliser lors de la génération des noms de fichier pour les fichiers CSV exportés.

    Si vous n'incluez pas le préfixe de nom de fichier dans file_uri_list, DBMS_CLOUD.EXPORT_DATA fournit un préfixe de nom de fichier. Pour plus de détails, reportez-vous à Dénomination de fichier pour la sortie texte (CSV, JSON, Parquet ou XML).

    Par exemple, l'exemple suivant montre DBMS_CLOUD.EXPORT_DATA avec un préfixe de nom de fichier spécifié dans 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;
 /

    Dans cet exemple, *namespace-string* est l'espace de noms Oracle Cloud Infrastructure Object Storage et bucketname est le nom du bucket. Pour plus d'informations, reportez-vous à Présentation des espaces de noms Object Storage.

    Pour obtenir des informations détaillées sur les paramètres, reportez-vous à la procédure EXPORT_DATA.

    Pour plus d'informations sur les paramètres format disponibles que vous pouvez utiliser avec DBMS_CLOUD.EXPORT_DATA, reportez-vous à Options de format de package DBMS_CLOUD pour EXPORT_DATA.

Notes pour l'exportation avec DBMS_CLOUD.EXPORT_DATA :

Export de données au format Parquet vers le stockage d'objet cloud

Présente les étapes d'export de données de table de votre base de données Autonomous AI vers Cloud Object Storage en tant que données Parquet en indiquant une requête.

Cette méthode d'export prend en charge toutes les banques d'objets cloud prises en charge par Autonomous Database. Vous pouvez utiliser un principal de ressource Oracle Cloud Infrastructure pour accéder à votre banque d'objets Oracle Cloud Infrastructure, à des noms de ressource Amazon (ARN) pour accéder à AWS Simple Storage Service (S3), à un principal de service Azure pour accéder au stockage BLOB Azure ou à un compte de service Google pour accéder aux ressources Google Cloud Platform (GCP).

  1. Connectez-vous à votre instance Autonomous AI Database.

    Pour plus d'informations, reportez-vous à Connexion à Autonomous AI Database.

  2. Stockez vos informations d'identification de stockage d'objet cloud à l'aide de la procédure DBMS_CLOUD.CREATE_CREDENTIAL,

    Exemple :

     BEGIN
   DBMS_CLOUD.CREATE_CREDENTIAL(
     credential_name => 'DEF_CRED_NAME',
     username => 'user1@example.com',
     password => 'password'
   );
 END;
 /

    Les valeurs fournies pour username et password dépendent du service Cloud Object Storage que vous utilisez .

  3. Exécutez DBMS_CLOUD.EXPORT_DATA et indiquez le paramètre format type avec la valeur parquet pour exporter les résultats en tant que fichiers parquet sur Cloud Object Storage.

    Pour générer les fichiers de sortie du parquet, deux options sont disponibles pour le paramètre file_uri_list :

    • Définissez la valeur file_uri_list sur l'URL d'un bucket existant sur le stockage d'objet cloud.

    • Définissez la valeur file_uri_list sur l'URL d'un bucket existant sur le stockage d'objet cloud et incluez un préfixe de nom de fichier à utiliser lors de la génération des noms de fichier pour les fichiers de parquet exportés.

    Si vous n'incluez pas le préfixe de nom de fichier dans file_uri_list, DBMS_CLOUD.EXPORT_DATA fournit un préfixe de nom de fichier. Pour plus de détails, reportez-vous à Dénomination de fichier pour la sortie texte (CSV, JSON, Parquet ou XML).

    Par exemple, l'exemple suivant montre DBMS_CLOUD.EXPORT_DATA avec un préfixe de nom de fichier spécifié dans 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;
 /

    Dans cet exemple, *namespace-string* est l'espace de noms Oracle Cloud Infrastructure Object Storage et bucketname est le nom du bucket. Pour plus d'informations, reportez-vous à Présentation des espaces de noms Object Storage.

    Pour obtenir des informations détaillées sur les paramètres, reportez-vous à la procédure EXPORT_DATA.

    Pour plus d'informations sur les paramètres format disponibles que vous pouvez utiliser avec DBMS_CLOUD.EXPORT_DATA, reportez-vous à Options de format de package DBMS_CLOUD pour EXPORT_DATA.

Notes pour l'exportation avec DBMS_CLOUD.EXPORT_DATA :

Export de données au format XML vers le stockage d'objet cloud

Affiche les étapes d'export de données de table de votre base de données Autonomous AI vers Cloud Object Storage en tant que données XML en indiquant une requête.

Cette méthode d'export prend en charge tous les magasins d'objets cloud pris en charge par la base de données Autonomous AI. Vous pouvez également utiliser les noms de ressource Amazon (ARN) pour accéder à AWS Simple Storage Service (S3), un principal de service Azure pour accéder au stockage BLOB Azure ou un compte de service Google pour accéder aux ressources Google Cloud Platform (GCP).

  1. Connectez-vous à votre instance Autonomous AI Database.

    Pour plus d'informations, reportez-vous à Connexion à Autonomous AI Database.

  2. Stockez vos informations d'identification au stockage d'objet cloud à l'aide de la procédure DBMS_CLOUD.CREATE_CREDENTIAL

    Exemple :

     BEGIN
   DBMS_CLOUD.CREATE_CREDENTIAL(
     credential_name => 'DEF_CRED_NAME',
     username => 'user1@example.com',
     password => 'password'
   );
 END;
 /

    Les valeurs fournies pour username et password dépendent du service Cloud Object Storage que vous utilisez .

  3. Exécutez DBMS_CLOUD.EXPORT_DATA et indiquez le paramètre format type avec la valeur xml pour exporter les résultats en tant que fichiers XML sur Cloud Object Storage.

    Pour générer les fichiers de sortie XML, deux options sont disponibles pour le paramètre file_uri_list :

    • Définissez la valeur file_uri_list sur l'URL d'un bucket existant sur le stockage d'objet cloud.

    • Définissez la valeur file_uri_list sur l'URL d'un bucket existant sur le stockage d'objet cloud et incluez un préfixe de nom de fichier à utiliser lors de la génération des noms de fichier pour le JSON exporté.

    Si vous n'incluez pas le préfixe de nom de fichier dans file_uri_list, DBMS_CLOUD.EXPORT_DATA fournit un préfixe de nom de fichier. Pour plus de détails, reportez-vous à Dénomination de fichier pour la sortie texte (CSV, JSON, Parquet ou XML).

    Par exemple, l'exemple suivant montre DBMS_CLOUD.EXPORT_DATA avec un préfixe de nom de fichier spécifié dans 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;
 /

    Dans cet exemple, *namespace-string* est l'espace de noms Oracle Cloud Infrastructure Object Storage et bucketname est le nom du bucket. Pour plus d'informations, reportez-vous à Présentation des espaces de noms Object Storage.

    Pour obtenir des informations détaillées sur les paramètres, reportez-vous à la procédure EXPORT_DATA.

    Pour plus d'informations sur les paramètres format disponibles que vous pouvez utiliser avec DBMS_CLOUD.EXPORT_DATA, reportez-vous à Options de format de package DBMS_CLOUD pour EXPORT_DATA.

Notes pour l'exportation avec DBMS_CLOUD.EXPORT_DATA :

Dénomination de fichier pour la sortie texte (CSV, JSON, Parquet ou XML)

Décrit l'affectation de noms aux fichiers de sortie à l'aide de DBMS_CLOUD.EXPORT_DATA avec une sortie de fichier texte CSV, JSON, Parquet ou XML.

DBMS_CLOUD.EXPORT_DATA effectue la requête indiquée avec le paramètre query et envoie les résultats vers des fichiers texte dans le bucket de la banque d'objets cloud ou vers un répertoire. Le format de sortie dépend du paramètre format type que vous indiquez (un format CSV, JSON, Parquet ou XML).

Pour accélérer la procédure et générer la sortie le plus rapidement possible, DBMS_CLOUD.EXPORT_DATA divise son travail. Cela signifie que, en fonction des ressources système, lorsque vous exécutez DBMS_CLOUD.EXPORT_DATA, la procédure crée plusieurs fichiers de sortie dans le bucket de la banque d'objets cloud ou dans le répertoire.

Le format de chaque fichier généré est le suivant :

[FileNamePrefix | client_info_module_action]_sequenceNum_timestamp.format_extension.[compression_extension]

Par exemple, le préfixe de nom de fichier dans la procédure DBMS_CLOUD.EXPORT_DATA suivante est indiqué dans le paramètre file_uri_list, en tant que dept_export. L'exemple génère la sortie vers la banque d'objets fournie dans le format spécifié.

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;
/

Lorsque vous indiquez un préfixe de nom de fichier, les fichiers de sortie générés incluent le préfixe de nom de fichier, comme suit :

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

Le nombre de fichiers de sortie générés dépend de la taille des résultats, du service de base de données et du nombre d'ECPU (OCPU si votre base de données utilise des OCPU) dans l'instance de base de données Autonomous AI.

Dans l'exemple suivant, le paramètre file_uri_list n'inclut pas de préfixe de nom de fichier et le paramètre compression est fourni, avec la valeur 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;
/

Lorsqu'un préfixe de nom de fichier ne figure pas dans le paramètre file_uri_list, DBMS_CLOUD.EXPORT_DATA utilise un préfixe de nom de fichier au format client_info_module_action. Dans cet exemple, les fichiers de sortie générés incluent le préfixe de nom de fichier fourni par DBMS_CLOUD.EXPORT_DATA et les fichiers sont compressés avec gzip et l'extension de fichier .gz est ajoutée, comme suit :

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 les informations de session client_info_module_action ne sont pas disponibles lorsque vous exécutez DBMS_CLOUD.EXPORT_DATA, le préfixe de nom de fichier est défini sur data. Exemple :

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

Par exemple, le préfixe de nom de fichier dans la procédure DBMS_CLOUD.EXPORT_DATA suivante est indiqué dans le paramètre file_uri_list, en tant que dept_export. L'exemple génère la sortie vers le répertoire fourni dans le format spécifié.

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

Lorsque vous indiquez un préfixe de nom de fichier, le fichier de sortie généré inclut le préfixe de nom de fichier, comme suit :

sales_1_20230705T124523275915Z.csv

Remarques concernant la dénomination des fichiers avec DBMS_CLOUD.EXPORT_DATA :

Contenu connexe