Didacticiel : Premiers pas avec S3 Tables

Pour créer un espace de noms de tables et une table

1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/s3/.

2. Dans le volet de navigation de gauche, choisissez Compartiments de tables.

3. Sur la page Compartiments de table, choisissez le compartiment de table dans lequel vous souhaitez créer une table.

4. Sur la page des détails du compartiment de table, choisissez Créer une table avec Athena.

5. Dans la boîte de dialogue Créer une table avec Athena, choisissez Créer un espace de noms, puis saisissez un nom dans le champ Nom de l’espace de noms. Les noms des espaces de noms doivent comporter de 1 à 255 caractères et être uniques dans le compartiment de table. Les caractères valides sont : a-z, A-Z, 0-9 et le trait d’union (_). Les traits de soulignement ne sont pas autorisés au début des noms d’espaces de noms.

6. Choisissez Create namespace (Créer un espace de noms).

7. Choisissez Créer une table avec Athena.

8. La console Amazon Athena s’ouvre et l’éditeur de requêtes Athena apparaît. L’éditeur de requêtes contient un exemple de requête que vous pouvez utiliser pour créer une table. Modifiez la requête pour spécifier le nom de la table et les colonnes que vous souhaitez attribuer à la table.

9. Lorsque vous avez terminé de modifier la requête, choisissez Exécuter pour créer votre table.

1. Créez un nouvel espace de noms dans votre compartiment de table en exécutant la commande suivante :

   aws s3tables create-namespace \
   --table-bucket-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket \
   --namespace my_namespace         

   1. Vérifiez que votre espace de noms a été créé avec succès en exécutant la commande suivante :

      aws s3tables list-namespaces \
      --table-bucket-arn arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket

2. Créez une nouvelle table avec un schéma de table en exécutant la commande suivante :

   aws s3tables create-table --cli-input-json file://mytabledefinition.json

   Pour le fichier mytabledefinition.json, utilisez l’exemple de définition de table suivant :

   {
       "tableBucketARN": "arn:aws:s3tables:us-east-1:111122223333:bucket/amzn-s3-demo-table-bucket",
       "namespace": "my_namespace",
       "name": "my_table",
       "format": "ICEBERG",
       "metadata": {
           "iceberg": {
               "schema": {
                   "fields": [
                        {"name": "id", "type": "int","required": true},
                        {"name": "name", "type": "string"},
                        {"name": "value", "type": "int"}
                   ]
               }
           }
       }
   }

Pour interroger une table

1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/s3/.

2. Dans le volet de navigation de gauche, choisissez Compartiments de tables.

3. Sur la page Compartiments de table, choisissez le compartiment qui contient la table que vous souhaitez interroger.

4. Dans la page des détails du compartiment, choisissez le bouton radio en regard du nom de la table que vous souhaitez interroger.

5. Choisissez Interroger une table avec Athena.

6. La console Amazon Athena s’ouvre et l’éditeur de requêtes Athena apparaît avec un exemple de requête SELECT chargé pour vous. Modifiez cette requête en fonction de votre cas d’utilisation.

7. Pour exécuter la requête, choisissez ensuite Run (Exécuter).

Pour interroger une table

1. Ouvrez la console à l'adresse https://console.aws.amazon.com/athena/.

2. Interrogez votre table. Voici un exemple de requête que vous pouvez modifier. Veillez à remplacer les user input placeholders par vos propres informations.

   SELECT * FROM "s3tablescatalog/amzn-s3-demo-table-bucket"."my_namespace"."my_table" LIMIT 10

3. Pour exécuter la requête, choisissez ensuite Run (Exécuter).