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 SDK. AWS
Configuration initiale
Obtenez une clé d'accès AWS pour accéder à DynamoDB par programmation.
Voir aussi :
SDK ou CLI
Choisissez votre SDK préféré ou configurez l'AWS CLI.
Note
Lorsque vous utilisez Windows, une barre oblique inversée (\) qui ne figure pas dans un devis est traitée comme un retour de transport. AWS CLI 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 la section Prise en main de DynamoDB et des kits de développement logiciel. AWS
Créer une table
É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) -
-(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
-
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é
LastEvaluatedKeyque vous pouvez utiliser dans une nouvelle demande pour lire la page suivante.
Index
-
Index secondaires locaux : vous pouvez définir au maximum cinq index secondaires locaux. Les index secondaires locaux sont particulièrement utiles lorsqu'un index doit présenter une forte cohérence avec la table de base.
-
Index secondaires globaux : il existe un quota par défaut 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 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. Pour de plus amples informations, veuillez également consulter Quotas de service.
É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.
En savoir plus
