Charger des données dans une base de données d'IA autonome à partir d'AWS S3

Cet exemple montre comment charger des données à partir du stockage d'objets Amazon S3 vers Autonomous AI Database.

Vous disposez de diverses options pour effectuer le chargement de données dans une base de données d'IA autonome, notamment :

  • Utilisation des options de l'interface utilisateur : Vous pouvez utiliser l'interface utilisateur de l'outil de chargement de Data Studio pour créer des données d'identification pour l'emplacement du magasin en nuage, sélectionner des fichiers contenant des données et exécuter des tâches de chargement de données.

    Voir Chargement de données à partir du stockage en nuage

  • Utilisation des API Rest Data Services : Vous pouvez utiliser les API de l'outil de chargement de Data Studio pour créer des liens vers l'emplacement du magasin en nuage et exécuter des tâches de chargement de données.

    Voir Utilisation des API de chargement de données Data Studio dans PL/SQL

  • Utiliser des commandes SQL comme expliqué dans cet exemple.

Toutes ces méthodes utilisent le même ensemble PL/SQL DBMS_CLOUD pour le chargement des données. Toutefois, Data Studio offre des avantages supplémentaires par rapport aux commandes SQL. Il permet non seulement d'analyser la source et de créer des définitions de table, mais effectue également des vérifications de validation.

Vous avez besoin des données d'identification d'accès AWS pour l'authentification de compte d'utilisateur et d'une URL d'objet pour accéder à l'objet dans le seau Amazon S3.

Pour charger des données à partir d'un seau Amazon S3 :
  1. Créez des données d'identification pour le compte d'utilisateur AWS dans la base de données Autonomous AI Database.

  2. Copiez les données du seau Amazon S3 dans la base de données.

Rubriques

Se préparer au chargement des données à partir d'AWS S3

Vérifiez les préalables et préparez le chargement des données à partir d'Amazon S3.

Conditions requises

Un fichier de données, par exemple, data.txt existe dans le seau Amazon S3 que vous pouvez importer. L'exemple de fichier contient les éléments suivants :
1,Direct Sales
2,Tele Sales
3,Catalog
4,Internet
5,Partners

Du côté AWS, connectez-vous à votre compte AWS et effectuez les opérations suivantes :

  1. Accordez des privilèges d'accès à l'utilisateur AWS IAM pour le seau Amazon S3.
  2. Créez une clé d'accès pour l'utilisateur.
  3. Obtenez une URL d'objet pour le fichier de données stocké dans le seau Amazon S3.
    Pour plus d'informations, voir Accès à un seau Amazon S3 et liste celui-ci.

Étapes de chargement des données à partir d'AWS S3

Exécutez ces étapes pour charger des données depuis Amazon S3 vers Autonomous AI Database.

  1. Stockez les données d'identification d'accès AWS dans votre base de données Autonomous AI Database et spécifiez un nom de données d'identification. Cela permet à la base de données de s'authentifier auprès de votre compte d'utilisateur AWS et d'accéder aux éléments du seau S3.
    SET DEFINE OFF
    BEGIN
      DBMS_CLOUD.CREATE_CREDENTIAL(
        credential_name => 'AWS_CRED_NAME',
        username => 'username',
        password => 'password'
      );
    END;
    /
    Note

    Ici, le nom d'utilisateur est votre ID clé d'accès AWS et le mot de passe est votre clé d'accès utilisateur.

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

    La création de données d'identification pour accéder aux ressources AWS n'est pas requise si vous activez les noms de ressource Amazon (ARN). Pour plus d'informations, voir Utiliser des noms de ressource Amazon (ARN) pour accéder aux ressources AWS.

    Facultativement, vous pouvez tester l'accès au seau S3 comme illustré dans cet exemple.

    SELECT * FROM DBMS_CLOUD.LIST_OBJECTS('AWS_CRED_NAME', ' https://aws-bucket-01.s3.amazonaws.com/');
    
  2. Créez une table dans la base de données où vous souhaitez charger les données.
    CREATE TABLE mytable (id NUMBER, name VARCHAR2(64));
    
  3. Importer des données du seau Amazon S3 dans votre base de données Autonomous AI Database.
    Spécifiez le nom de la table et le nom des données d'identification AWS suivis de l'URL de l'objet S3.
    BEGIN
          DBMS_CLOUD.COPY_DATA(
              table_name => 'mytable',
              credential_name => 'AWS_CRED_NAME',
              file_uri_list => https://aws-bucket-01.s3.amazonaws.com/data.txt',
              format => json_object('delimiter' value ',')
          );
    END;
    /

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

Vous avez importé avec succès des données d'Amazon S3 vers votre base de données Autonomous AI Database. Vous pouvez exécuter cette instruction et vérifier les données de votre table.
SELECT * FROM mytable;
ID  NAME
--  –-------------
 1  Direct Sales
 2  Tele Sales
 3  Catalog
 4  Internet
 5  Partners

Pour plus d'informations sur le chargement des données, voir Charger des données à partir de fichiers dans le nuage.