Création d’un espace de noms - Amazon Simple Storage Service

Création d’un espace de noms

Un espace de noms de table est une construction logique sous laquelle vous regroupez des tables dans un compartiment de table Amazon S3. Chaque table appartient à un seul espace de noms. Avant de créer une table dans un compartiment de table, vous devez créer un espace de noms sous lequel les tables sont regroupées. Vous pouvez créer un espace de noms en utilisant la console Amazon S3, AWS Command Line Interface (AWS CLI), l’API REST Amazon S3, les kits AWS SDK, ou des moteurs de requête intégrés.

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 ou à la fin 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 traits d’union (-) ni de points (.).

  • Un espace de noms doit être unique dans un compartiment de tables.

  • Les espaces de noms ne doivent pas commencer par le préfixe réservé aws.

Pour plus d’informations sur les espaces de noms valides, consultez Règles de dénomination des tables et des espaces de noms.

La procédure suivante utilise le flux de travail Créer une table avec 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éé l’espace de noms.

Pour créer un espace de noms

  1. Connectez-vous à la AWS Management Console et ouvrez la console Amazon S3 à 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 un espace de noms.

  4. Sur la page des détails du compartiment, 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 choisissez Créer un espace de noms.

  6. 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 ou à la fin 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 Athena. 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 table pour le moment, choisissez Annuler.

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

Vous pouvez créer un espace de noms dans une session Apache Spark connectée à vos compartiments de tables 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 les espaces réservés à la saisie utilisateur par vos propres informations.

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