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.
# Aide-mémoire pour DynamoDB
Ce aide-mémoire fournit une référence rapide pour travailler avec Amazon DynamoDB et ses différents outils. AWS SDKs
## Configuration initiale du
1. [Inscrivez-vous pour AWS](SettingUp.DynamoWebService.html#SettingUp.DynamoWebService.SignUpForAWS).
1. [Obtenez une clé d’accès AWS](SettingUp.DynamoWebService.html#SettingUp.DynamoWebService.GetCredentials) pour accéder à DynamoDB par programmation.
1. [Configurez vos informations d’identification DynamoDB](SettingUp.DynamoWebService.html#SettingUp.DynamoWebService.ConfigureCredentials).
**Voir aussi :**
+ [Configuration de DynamoDB (service web)](SettingUp.DynamoWebService.html)
+ [Mise en route avec DynamoDB](GettingStartedDynamoDB.html)
+ [Présentation de base des principaux composants](HowItWorks.CoreComponents.html)
## SDK ou CLI
Choisissez votre [SDK](sdk-general-information-section.html) préféré ou configurez l’[AWS CLI](/cli/latest/index.html).
**Note**
Lorsque vous utilisez AWS CLI le sous Windows, une barre oblique inversée (\$1) qui ne figure pas dans un devis est traitée comme un retour de transport. De plus, vous devez éviter les guillemets et les accolades à l’intérieur d’autres guillemets. À titre d’exemple, reportez-vous à l’onglet **Windows** dans « Create a table » (Créer une table) dans la section suivante.
**Voir aussi :**
+ [AWS CLI avec DynamoDB](Tools.CLI.html)
+ [Mise en route avec DynamoDB : étape 2](getting-started-step-2.html)
## Actions de base
Cette section fournit le code pour les tâches de base de DynamoDB. Pour plus d'informations sur ces tâches, consultez [Getting started with DynamoDB and the](GettingStarted.html). AWS SDKs
### Création d’une table
------
#### [ Default ]
```
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 \
--billing-mode PAY_PER_REQUEST \
--table-class STANDARD
```
------
#### [ Windows ]
```
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 ^
--billing-mode PAY_PER_REQUEST ^
--table-class STANDARD
```
------
### Écrire un élément dans une table
```
aws dynamodb put-item \ --table-name Music \ --item file://item.json
```
### Lire un élément à partir d’une table
```
aws dynamodb get-item \ --table-name Music \ --item file://item.json
```
### Supprimer un élément d’une table
```
aws dynamodb delete-item --table-name Music --key file://key.json
```
### Interroger une table
```
aws dynamodb query --table-name Music
--key-condition-expression "ArtistName=:Artist and SongName=:Songtitle"
```
### Supprimer une table
```
aws dynamodb delete-table --table-name Music
```
### Répertorier le nom des tables
```
aws dynamodb list-tables
```
## Règles de dénomination
+ Tous les noms doivent être codés en UTF-8 et sont sensibles à la casse.
+ Les noms de table et les noms d’index doivent être compris entre 3 et 255 caractères, et peuvent contenir uniquement les caractères suivants :
+ `a-z`
+ `A-Z`
+ `0-9`
+ `_`(soulignement)
+ `-`(trait d’union)
+ `.`(point)
+ Un nom d’attribut doit compter au moins un caractère, mais ne peut pas avoir une taille supérieure à 64 Ko.
Pour plus d’informations, consultez les [règles de dénomination](HowItWorks.NamingRulesDataTypes.html).
## Principes de base des quotas de service
**Unités de lecture et d’écriture**
+ **RCU (Read capacity unit)** : une unité de capacité de lecture équivaut à une lecture fortement cohérente par seconde (ou à deux lectures éventuellement cohérentes par seconde) d’éléments dont la taille peut atteindre 4 Ko.
+ **WCU (Write capacity unit)** : Une unité de capacité d’écriture équivaut à une écriture par seconde d’éléments dont la taille peut atteindre 1 Ko.
**Limites liées aux tables**
+ **Taille de la table** : il n’existe pas de limite concrète de la taille d’une table. Les tables sont sans contraintes en ce qui concerne le nombre d’éléments ou le nombre d’octets.
+ **Nombre de tables** — Pour chaque AWS compte, il existe un quota initial de 2 500 tables par AWS région.
+ **Limite de taille de page pour les requêtes et les analyses** : la limite est de 1 Mo par page, par requête ou analyse. Si les paramètres de votre requête ou votre opération d’analyse sur une table génèrent plus de 1 Mo de données, DynamoDB renvoie les éléments correspondants initiaux. Il renvoie également une propriété `LastEvaluatedKey` que vous pouvez utiliser dans une nouvelle demande pour lire la page suivante.
**Index**
+ **Index secondaires locaux (LSIs)** — Vous pouvez définir un maximum de cinq index secondaires locaux. LSIs sont principalement utiles lorsqu'un index doit avoir une forte cohérence avec la table de base.
+ **Index secondaires globaux (GSIs)** : le quota par défaut est de 20 index secondaires globaux par table.
+ **Attributs d’index secondaire projeté par table** : vous pouvez projeter jusqu’à un total de 100 attributs dans l’ensemble des index secondaires locaux et globaux d’une table. Cette possibilité ne s’applique qu’aux attributs projetés spécifiés par l’utilisateur.
**Clé de partition**
+ La longueur minimale d’une valeur de clé de partition est 1 octet. La longueur maximale est de 2 048 octets.
+ Il n’existe pas de limite pratique quant au nombre de valeurs de clé de partition distinctes, pour les tables ou pour les index secondaires.
+ La longueur minimale d’une valeur de clé de tri est 1 octet. La longueur maximale est de 1 024 octets.
+ En général, il n’existe pas de limite pratique sur le nombre de valeurs de clé de tri distinctes par valeur de clé de partition. L’exception concerne les tables avec index secondaires.
Pour plus d’informations sur les index secondaires, ainsi que sur la conception des clés de partition et des clés de tri, consultez la section [Bonnes pratiques](best-practices.html).
**Limites applicables aux types de données couramment utilisés**
+ **Chaîne** : la longueur d’une chaîne est limitée par la taille maximum de l’élément, qui de 400 Ko. Les chaînes sont Unicode avec codage binaire UTF-8.
+ **Nombre** : un nombre peut avoir jusqu’à 38 chiffres de précision et peut être positif, négatif ou nul.
+ **Binaire** : la longueur d’un élément de type binaire est limitée par la taille maximum de l’élément, qui de 400 Ko. Les applications qui fonctionnent avec des attributs de type binaire doivent encoder les données au format base 64 avant de les envoyer à DynamoDB.
Pour afficher la liste complète des types de données pris en charge, consultez [Types de données](HowItWorks.NamingRulesDataTypes.html#HowItWorks.DataTypes). Pour de plus amples informations, veuillez également consulter [Quotas de service](ServiceQuotas.html#limits-items).
### Éléments, attributs et paramètres d’expression
La taille maximum d’un élément dans DynamoDB est de 400 Ko, ce qui comprend la longueur binaire du nom d’attribut (longueur UTF-8) et les longueurs binaires de valeur d’attribut (longueur UTF-8). Le nom d’attribut est comptabilisé parmi la limite de taille.
Il n’existe aucune limite au nombre de valeurs dans un élément de type List (liste), Map (mappage) ou Set (ensemble), pour autant que la taille de l’élément ne dépasse pas la talle limite de 400 Ko.
Pour les paramètres d’expression, la longueur maximale d’une chaîne d’expression est de 4 Ko.
Pour plus d’informations sur la taille des éléments, les attributs et les paramètres d’expression, consultez la section [Quotas de service](ServiceQuotas.html#limits-items).
## En savoir plus
+ [Sécurité](security.html)
+ [Surveillance et journalisation](monitoring.html)
+ [Utilisation des flux](streamsmain.html)
+ [Sauvegardes](Backup-and-Restore.html) et [Point-in-time restauration](Point-in-time-recovery.html)
+ [Intégration à d'autres AWS services](OtherServices.html)
+ [Référence d’API](/amazondynamodb/latest/APIReference/Welcome.html)
+ [Centre d’architecture : bonnes pratiques en matière de bases de données](https://aws.amazon.com/architecture/databases/)
+ [Didacticiels vidéo](https://youtu.be/Mw8wCj0gkRc)
+ [Forum DynamoDB](https://repost.aws/search/questions?globalSearch=dynamodb)