Exporter les données vers le magasin d'objets en tant que 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 d'intelligence artificielle autonome vers le magasin d'objets en nuage. Les options d'exportation au format texte sont CSV, JSON ou XML.

Exporter des données JSON vers le stockage d'objets en nuage

Affiche les étapes pour exporter des données de table de votre base de données d'intelligence artificielle autonome vers le stockage d'objets en nuage en tant que données JSON en spécifiant une interrogation.

Cette méthode d'exportation prend en charge tous les magasins d'objets en nuage pris en charge par Autonomous Database. Vous pouvez utiliser un principal de ressource Oracle Cloud Infrastructure pour accéder à votre magasin d'objets Oracle Cloud Infrastructure, à vos noms de ressource Amazon (ARN) pour accéder à AWS Simple Storage Service (S3), à un principal de service Azure pour accéder au stockage Azure BLOB ou à un compte de service Google pour accéder aux ressources Google Cloud Platform (GCP).

  1. Connectez-vous à votre instance de base de données Autonomous AI Database.

    Pour plus d'informations, voir Se connecter à Autonomous AI Database.

  2. Stockez vos données d'identification du service de stockage d'objets en nuage à l'aide de DBMS_CLOUD.CREATE_CREDENTIAL.

    Par exemple :

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

    Les valeurs que vous indiquez pour username et password dépendent du service de stockage d'objets en nuage que vous utilisez .

  3. Exécutez DBMS_CLOUD.EXPORT_DATA et spécifiez le paramètre format type avec la valeur json pour exporter les résultats en tant que fichiers JSON dans le stockage d'objets en nuage.

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

    • Réglez la valeur file_uri_list à l'URL d'un seau existant dans votre stockage d'objets en nuage.

    • Réglez la valeur file_uri_list à l'URL d'un seau existant dans votre stockage d'objets en nuage 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. Voir Attribution de nom à un fichier pour une sortie de texte (CSV, JSON, Parquet ou XML) pour plus de détails.

    Par exemple, l'illustration suivante présente 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 du stockage d'objets pour Oracle Cloud Infrastructure et bucketname est le nom du seau. Pour plus d'informations, voir Présentation des espaces de noms du stockage d'objets.

    Lorsque les délimiteurs d'enregistrement incluent des caractères d'échappement, tels que \r\n ou \t, encadrez les délimiteurs d'enregistrement par des guillemets doubles. Par exemple, pour utiliser le délimiteur d'enregistrement \r\n, placez la valeur entre guillemets :"\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 du stockage d'objets pour Oracle Cloud Infrastructure et bucketname est le nom du seau. Pour plus d'informations, voir Présentation des espaces de noms du stockage d'objets.

    Pour des informations détaillées sur les paramètres, voir Procédure EXPORT_DATA.

    Pour des informations détaillées sur les paramètres format disponibles que vous pouvez utiliser avec DBMS_CLOUD.EXPORT_DATA, voir Options de format d'ensemble DBMS_CLOUD pour EXPORT_DATA.

Notes pour l'exportation avec DBMS_CLOUD.EXPORT_DATA :

Exporter des données au format CSV vers le stockage d'objets en nuage

Affiche les étapes pour exporter des données de table de votre base de données d'intelligence artificielle autonome vers le stockage d'objets en nuage sous forme de données CSV en spécifiant une interrogation.

Cette méthode d'exportation prend en charge tous les magasins d'objets en nuage pris en charge par Autonomous AI Database. 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 Azure BLOB, ou un compte de service Google pour accéder aux ressources Google Cloud Platform (GCP).

  1. Connectez-vous à votre instance de base de données Autonomous AI Database.

    Pour plus d'informations, voir Se connecter à Autonomous AI Database.

  2. Stockez vos données d'identification du service de stockage d'objets en nuage à l'aide de DBMS_CLOUD.CREATE_CREDENTIAL.

    Par exemple :

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

    Les valeurs que vous indiquez pour username et password dépendent du service de stockage d'objets en nuage que vous utilisez .

  3. Exécutez DBMS_CLOUD.EXPORT_DATA et spécifiez le paramètre format type avec la valeur csv pour exporter les résultats sous forme de fichiers CSV dans le stockage d'objets en nuage.

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

    • Réglez la valeur file_uri_list à l'URL d'un seau existant dans votre stockage d'objets en nuage.

    • Réglez la valeur file_uri_list à l'URL d'un seau existant dans votre stockage d'objets en nuage 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. Voir Attribution de nom à un fichier pour une sortie de texte (CSV, JSON, Parquet ou XML) pour plus de détails.

    Par exemple, l'illustration suivante présente 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 du stockage d'objets pour Oracle Cloud Infrastructure et bucketname est le nom du seau. Pour plus d'informations, voir Présentation des espaces de noms du stockage d'objets.

    Pour des informations détaillées sur les paramètres, voir Procédure EXPORT_DATA.

    Pour des informations détaillées sur les paramètres format disponibles que vous pouvez utiliser avec DBMS_CLOUD.EXPORT_DATA, voir Options de format d'ensemble DBMS_CLOUD pour EXPORT_DATA.

Notes pour l'exportation avec DBMS_CLOUD.EXPORT_DATA :

Exporter des données au format Parquet vers le stockage d'objets en nuage

Affiche les étapes pour exporter des données de table de votre base de données d'IA autonome vers le stockage d'objets en nuage en tant que données Parquet en spécifiant une interrogation.

Cette méthode d'exportation prend en charge tous les magasins d'objets en nuage pris en charge par Autonomous Database. Vous pouvez utiliser un principal de ressource Oracle Cloud Infrastructure pour accéder à votre magasin d'objets Oracle Cloud Infrastructure, à vos noms de ressource Amazon (ARN) pour accéder à AWS Simple Storage Service (S3), à un principal de service Azure pour accéder au stockage Azure BLOB ou à un compte de service Google pour accéder aux ressources Google Cloud Platform (GCP).

  1. Connectez-vous à votre instance de base de données Autonomous AI Database.

    Pour plus d'informations, voir Se connecter à Autonomous AI Database.

  2. Stockez vos données d'identification du service de stockage d'objets en nuage à l'aide de DBMS_CLOUD.CREATE_CREDENTIAL.

    Par exemple :

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

    Les valeurs que vous indiquez pour username et password dépendent du service de stockage d'objets en nuage que vous utilisez .

  3. Exécutez DBMS_CLOUD.EXPORT_DATA et spécifiez le paramètre format type avec la valeur parquet pour exporter les résultats en tant que fichiers parquet dans le stockage d'objets en nuage.

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

    • Réglez la valeur file_uri_list à l'URL d'un seau existant dans votre stockage d'objets en nuage.

    • Réglez la valeur file_uri_list à l'URL d'un seau existant dans votre stockage d'objets en nuage et incluez un préfixe de nom de fichier à utiliser lors de la génération des noms de fichier pour les fichiers 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. Voir Attribution de nom à un fichier pour une sortie de texte (CSV, JSON, Parquet ou XML) pour plus de détails.

    Par exemple, l'illustration suivante présente 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 du stockage d'objets pour Oracle Cloud Infrastructure et bucketname est le nom du seau. Pour plus d'informations, voir Présentation des espaces de noms du stockage d'objets.

    Pour des informations détaillées sur les paramètres, voir Procédure EXPORT_DATA.

    Pour des informations détaillées sur les paramètres format disponibles que vous pouvez utiliser avec DBMS_CLOUD.EXPORT_DATA, voir Options de format d'ensemble DBMS_CLOUD pour EXPORT_DATA.

Notes pour l'exportation avec DBMS_CLOUD.EXPORT_DATA :

Exporter des données au format XML vers le stockage d'objets en nuage

Affiche les étapes d'exportation des données de table de votre base de données d'intelligence artificielle autonome vers le stockage d'objets en nuage en tant que données XML en spécifiant une interrogation.

Cette méthode d'exportation prend en charge tous les magasins d'objets en nuage pris en charge par Autonomous AI Database. 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 Azure BLOB, ou un compte de service Google pour accéder aux ressources Google Cloud Platform (GCP).

  1. Connectez-vous à votre instance de base de données Autonomous AI Database.

    Pour plus d'informations, voir Se connecter à Autonomous AI Database.

  2. Stockez vos données d'identification du service de stockage d'objets en nuage à l'aide de DBMS_CLOUD.CREATE_CREDENTIAL.

    Par exemple :

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

    Les valeurs que vous indiquez pour username et password dépendent du service de stockage d'objets en nuage que vous utilisez .

  3. Exécutez DBMS_CLOUD.EXPORT_DATA et spécifiez le paramètre format type avec la valeur xml pour exporter les résultats en tant que fichiers XML dans le stockage d'objets en nuage.

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

    • Réglez la valeur file_uri_list à l'URL d'un seau existant dans votre stockage d'objets en nuage.

    • Réglez la valeur file_uri_list à l'URL d'un seau existant dans votre stockage d'objets en nuage 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. Voir Attribution de nom à un fichier pour une sortie de texte (CSV, JSON, Parquet ou XML) pour plus de détails.

    Par exemple, l'illustration suivante présente 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 du stockage d'objets pour Oracle Cloud Infrastructure et bucketname est le nom du seau. Pour plus d'informations, voir Présentation des espaces de noms du stockage d'objets.

    Pour des informations détaillées sur les paramètres, voir Procédure EXPORT_DATA.

    Pour des informations détaillées sur les paramètres format disponibles que vous pouvez utiliser avec DBMS_CLOUD.EXPORT_DATA, voir Options de format d'ensemble DBMS_CLOUD pour EXPORT_DATA.

Notes pour l'exportation avec DBMS_CLOUD.EXPORT_DATA :

Nom de fichier pour la sortie de texte ( CSV, JSON, Parquet ou XML)

Décrit l'attribution d'un nom au fichier 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 l'interrogation spécifiée avec le paramètre query et envoie les résultats aux fichiers texte dans le seau du magasin d'objets en nuage ou dans un répertoire. Le format de sortie dépend du paramètre format type que vous spécifiez (un fichier 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, selon les ressources du système, lorsque vous exécutez DBMS_CLOUD.EXPORT_DATA, la procédure crée plusieurs fichiers de sortie dans le seau du magasin d'objets en nuage 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 spécifié dans le paramètre file_uri_list, en tant que dept_export. L'exemple génère la sortie vers le magasin d'objets fourni 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 spécifiez 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 de l'IA autonome.

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 du formulaire : client_info_module_action. Pour 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 réglé à data. Par 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 spécifié 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 spécifiez 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

Notes pour l'attribution d'un nom de fichier avec DBMS_CLOUD.EXPORT_DATA :

Contenu connexe