Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Création d'une table globale (Version 2017.11.29)
**Important**
Cette documentation concerne la version 2017.11.29 (héritée) des tables globales, qui doit être évitée pour les nouvelles tables globales. Les clients doivent utiliser la [version 2019.11.21 (actuelle) des tables globales](GlobalTables.md) dans la mesure du possible, car elle offre une plus grande flexibilité, une efficacité accrue et utilise moins de capacité d’écriture que la version 2017.11.29 (héritée).
Pour déterminer quelle version vous utilisez, consultez [Détermination de la version d’une table globale](V2globaltables_versions.md#globaltables.DetermineVersion). Pour mettre à jour les tables globales de la version 2017.11.29 (héritée) vers la version 2019.11.21 (actuelle), consultez [Versions des tables globales DynamoDB](V2globaltables_versions.md).
Cette section explique comment créer une table globale à l'aide de la console Amazon DynamoDB ou AWS Command Line Interface du ().AWS CLI
**Topics**
+ [Création d’une table globale (console)](#creategt_console)
+ [Création d’une table globale (AWS CLI)](#creategt_cli)
## Création d’une table globale (console)
Suivez ces étapes pour créer une table globale à l’aide de la console. L’exemple suivant crée une table globale avec des tables de réplica aux États-Unis et en Europe.
1. [Ouvrez la console DynamoDB à la maison. https://console.aws.amazon.com/dynamodb/](https://console.aws.amazon.com/dynamodb/home) Pour cet exemple, choisissez la région us-east-2 (USA Est (Ohio)).
1. Dans le volet de navigation sur le côté gauche de la console, choisissez **Tables**.
1. Choisissez **Créer une table**.
Sous **Table name (Nom de la table)**, saisissez **Music**.
Pour **Primary key (Clé primaire)** entrez **Artist**. Choisissez **Add sort key (Ajouter une clé de tri)**, puis entrez **SongTitle**. (**Artist** et **SongTitle** doivent tous deux être des chaînes.)
Pour créer la table, choisissez **Create**. La table sert de première table de réplica dans une nouvelle table globale. Il s’agit du prototype pour d’autres tables de réplica que vous ajouterez ultérieurement.
1. Choisissez l’onglet **Tables globales**, puis choisissez **Créer un réplica version 2017.11.29 (héritée)**.
![\[Capture d’écran de la console montrant le bouton Créer un réplica version 2017.11.29 (ancienne).\]](http://docs.aws.amazon.com/fr_fr/amazondynamodb/latest/developerguide/images/GlobalTables-old.png)
1. De la liste déroulante **Régions de réplication disponibles**, choisissez **USA Ouest (Oregon)**.
La console vérifie qu’il n’existe pas de table du même nom dans la région sélectionnée. (Si une table du même nom existe, vous devez la supprimer avant de pouvoir créer une nouvelle table de réplicas dans cette région.)
1. Choisissez **Créer un réplica**. Cela a pour effet de démarrer le processus de création de table dans la région USA Ouest (Oregon).
L’onglet **Table globale** pour la table sélectionnée (et pour toutes les autres tables de réplica) indique que la table a été répliquée dans plusieurs régions.
1. Vous allez maintenant ajouter une autre région, de sorte que votre table globale soit répliquée et synchronisée à travers les États-Unis et l’Europe. Pour ce faire, répétez l’étape 5, mais cette fois en spécifiant **Europe (Francfort)** au lieu de **USA Ouest (Oregon)**.
1. Vous devriez toujours utiliser le AWS Management Console dans la région de l'est des États-Unis (Ohio). Sélectionnez **Eléments** dans le menu de navigation de gauche, sélectionnez le table **Musique**, puis choisissez **Créer un élément**.
1. Pour **Artist (Artiste)**, saisissez **item\$11**.
1. Pour **SongTitle**, saisissez **Song Value 1**.
1. Pour écrire l’élément, choisissez **Créer un élément**.
1. Après quelques instants, l’élément est répliqué dans les trois régions de votre table globale. Pour vérifier cela, sur la console, dans le sélecteur de région situé en haut à droite, choisissez **Europe (Francfort)**. La table `Music` dans la région Europe (Francfort) doit contenir le nouvel élément.
1. Répétez l’étape 9 et choisissez **USA Ouest (Oregon)** pour vérifier la réplication dans cette région.
## Création d’une table globale (AWS CLI)
Suivez ces étapes pour créer une table globale `Music` avec AWS CLI. L’exemple suivant crée une table globale avec des tables de réplica aux États-Unis et en Europe.
1. Créez une table (`Music`) dans la région USA Est (Ohio), avec DynamoDB Streams activé (`NEW_AND_OLD_IMAGES`).
```
aws dynamodb create-table \
--table-name Music \
--attribute-definitions \
AttributeName=Artist,AttributeType=S \
AttributeName=SongTitle,AttributeType=S \
--key-schema \
AttributeName=Artist,KeyType=HASH \
AttributeName=SongTitle,KeyType=RANGE \
--provisioned-throughput \
ReadCapacityUnits=10,WriteCapacityUnits=5 \
--stream-specification StreamEnabled=true,StreamViewType=NEW_AND_OLD_IMAGES \
--region us-east-2
```
1. Créez une table `Music` identique dans la région USA Est (Virginie du Nord).
```
aws dynamodb create-table \
--table-name Music \
--attribute-definitions \
AttributeName=Artist,AttributeType=S \
AttributeName=SongTitle,AttributeType=S \
--key-schema \
AttributeName=Artist,KeyType=HASH \
AttributeName=SongTitle,KeyType=RANGE \
--provisioned-throughput \
ReadCapacityUnits=10,WriteCapacityUnits=5 \
--stream-specification StreamEnabled=true,StreamViewType=NEW_AND_OLD_IMAGES \
--region us-east-1
```
1. Créez une table globale (`Music`) composée de tables de réplique dans les régions `us-east-2` et `us-east-1`.
```
aws dynamodb create-global-table \
--global-table-name Music \
--replication-group RegionName=us-east-2 RegionName=us-east-1 \
--region us-east-2
```
**Note**
Le nom de la table globale (`Music`) doit correspondre au nom de chacune des tables de réplique (`Music`). Pour de plus amples informations, veuillez consulter [Bonnes pratiques relatives aux tables globales](globaltables-bestpractices.md).
1. Créez une autre table en Europe (Irlande), avec les mêmes paramètres que ceux que vous avez créés aux étape 1 et 2.
```
aws dynamodb create-table \
--table-name Music \
--attribute-definitions \
AttributeName=Artist,AttributeType=S \
AttributeName=SongTitle,AttributeType=S \
--key-schema \
AttributeName=Artist,KeyType=HASH \
AttributeName=SongTitle,KeyType=RANGE \
--provisioned-throughput \
ReadCapacityUnits=10,WriteCapacityUnits=5 \
--stream-specification StreamEnabled=true,StreamViewType=NEW_AND_OLD_IMAGES \
--region eu-west-1
```
Une fois cette étape accomplie, ajoutez la nouvelle table à la table globale `Music`.
```
aws dynamodb update-global-table \
--global-table-name Music \
--replica-updates 'Create={RegionName=eu-west-1}' \
--region us-east-2
```
1. Pour vérifier que la réplication fonctionne, ajoutez un élément à la table `Music` dans la région USA Est (Ohio).
```
aws dynamodb put-item \
--table-name Music \
--item '{"Artist": {"S":"item_1"},"SongTitle": {"S":"Song Value 1"}}' \
--region us-east-2
```
1. Patientez quelques secondes, puis vérifiez que l’élément a été correctement répliqué dans les régions USA Est (Virginie du Nord) et Europe (Irlande).
```
aws dynamodb get-item \
--table-name Music \
--key '{"Artist": {"S":"item_1"},"SongTitle": {"S":"Song Value 1"}}' \
--region us-east-1
```
```
aws dynamodb get-item \
--table-name Music \
--key '{"Artist": {"S":"item_1"},"SongTitle": {"S":"Song Value 1"}}' \
--region eu-west-1
```