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.
Ce aide-mémoire fournit une référence rapide pour travailler avec Amazon DynamoDB et ses différents outils. AWS SDKs
Configuration initiale
Obtenez une clé d'accès AWS pour accéder à DynamoDB par programmation.
Voir aussi :
SDK ou CLI
Choisissez votre préférence SDKou configurez le AWS CLI.
Note
Lorsque vous utilisez AWS CLI le sous Windows, une barre oblique inversée (\) 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 :
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. AWS SDKs
Créer une table
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
É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 à l'aide de UTF -8 et faire la distinction majuscules/minuscules.
-
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) -
-
(tiret) -
.
(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.
Principes de base des quotas de service
Unités de lecture et d'écriture
-
Unité de capacité de lecture (RCU) : une lecture très cohérente par seconde, ou deux lectures éventuellement cohérentes par seconde, pour les éléments d'une taille maximale de 4 Ko.
-
Unité de capacité d'écriture (WCU) : une écriture par seconde, pour les éléments d'une taille maximale de 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. LSIssont 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.
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 un encodage 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. Pour de plus amples informations, veuillez également consulter Quotas de service.
Éléments, attributs et paramètres d'expression
La taille maximale des éléments dans DynamoDB est de 400 Ko, ce qui inclut à la fois la longueur binaire du nom d'attribut UTF (longueur -8) et la longueur binaire des valeurs 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.