Création d'un espace de noms

Un espace de noms de table est une construction logique sous laquelle vous regroupez les tables au sein d'un compartiment de tables Amazon S3. Chaque table appartient à un seul espace de noms. Avant de créer une table dans un bucket de tables, vous devez créer un espace de noms dans lequel les tables seront regroupées. Vous pouvez créer un espace de noms à l'aide de la console Amazon S3, AWS Command Line Interface (AWS CLI), de l'API REST Amazon S3 ou de moteurs de requêtes intégrés. AWS SDKs

Noms d’espace de noms

Les règles de dénomination suivantes s’appliquent aux espaces de noms :

• Les noms doivent comporter entre 1 et 255 caractères.

• Les noms ne peuvent être composés que de lettres minuscules, de chiffres et de traits de soulignement (). _ Les traits de soulignement ne sont pas autorisés au début des noms d'espaces de noms.

• Les noms doivent commencer et se terminer par une lettre ou un chiffre.

• Les noms ne doivent pas contenir de tirets (-) ni de points (.).

Pour plus d'informations sur les noms d'espaces de noms valides, consultezRègles de dénomination des tables et des espaces de noms.

Utilisation de la console S3 et d'Amazon Athena

La procédure suivante utilise le flux de travail Create table with Athena pour créer un espace de noms dans la console Amazon S3. Si vous ne souhaitez pas également utiliser Amazon Athena pour créer une table dans votre espace de noms, vous pouvez annuler le flux de travail après avoir créé votre espace de noms.

Pour créer un espace de noms

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 dans lequel vous souhaitez créer un espace de noms.

4. Sur la page des détails du bucket, choisissez Create table with Athena.

5. Dans la boîte de dialogue Créer une table avec Athena, choisissez Create a namespace, puis Create namespace.

6. Entrez 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, 0—9 et les traits de soulignement (). _ Les traits de soulignement ne sont pas autorisés au début des noms d'espaces de noms.

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

8. Si vous souhaitez également créer une table, choisissez Créer une table avec Athéna. Pour plus d'informations sur la création d'une table avec Athena, consultez. Utilisation de la console S3 et d'Amazon Athena Si vous ne souhaitez pas créer de tableau pour le moment, choisissez Annuler.

Utilisation de la console S3 et d'Amazon Athena

La procédure suivante utilise le flux de travail Create table with Athena pour créer un espace de noms dans la console Amazon S3. Si vous ne souhaitez pas également utiliser Amazon Athena pour créer une table dans votre espace de noms, vous pouvez annuler le flux de travail après avoir créé votre espace de noms.

Pour créer un espace de noms

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 dans lequel vous souhaitez créer un espace de noms.

4. Sur la page des détails du bucket, choisissez Create table with Athena.

5. Dans la boîte de dialogue Créer une table avec Athena, choisissez Create a namespace, puis Create namespace.

6. Entrez 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, 0—9 et les traits de soulignement (). _ Les traits de soulignement ne sont pas autorisés au début des noms d'espaces de noms.

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

8. Si vous souhaitez également créer une table, choisissez Créer une table avec Athéna. Pour plus d'informations sur la création d'une table avec Athena, consultez. Utilisation de la console S3 et d'Amazon Athena Si vous ne souhaitez pas créer de tableau pour le moment, choisissez Annuler.

À l'aide du AWS CLI

Cet exemple montre comment créer un espace de noms de tables à l’aide de l’ AWS CLI. Pour utiliser cet exemple, remplacez user input placeholders par vos propres informations.

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

À l'aide du AWS CLI

Cet exemple montre comment créer un espace de noms de tables à l’aide de l’ AWS CLI. Pour utiliser cet exemple, remplacez user input placeholders par vos propres informations.

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

Utilisation d’un moteur de requête

Vous pouvez créer un espace de noms dans un Apache Spark session connectée à vos compartiments de table Amazon S3.

Cet exemple montre comment créer une table en utilisant les instructions CREATE dans un moteur de requête intégré avec S3 Tables. Pour utiliser cet exemple, remplacez user input placeholders par vos propres informations.

spark.sql("CREATE NAMESPACE IF NOT EXISTS s3tablesbucket.my_namespace")

Utilisation d’un moteur de requête

Vous pouvez créer un espace de noms dans un Apache Spark session connectée à vos compartiments de table Amazon S3.

Cet exemple montre comment créer une table en utilisant les instructions CREATE dans un moteur de requête intégré avec S3 Tables. Pour utiliser cet exemple, remplacez user input placeholders par vos propres informations.

spark.sql("CREATE NAMESPACE IF NOT EXISTS s3tablesbucket.my_namespace")