Sélectionner vos préférences de cookies

Nous utilisons des cookies essentiels et des outils similaires qui sont nécessaires au fonctionnement de notre site et à la fourniture de nos services. Nous utilisons des cookies de performance pour collecter des statistiques anonymes afin de comprendre comment les clients utilisent notre site et d’apporter des améliorations. Les cookies essentiels ne peuvent pas être désactivés, mais vous pouvez cliquer sur « Personnaliser » ou « Refuser » pour refuser les cookies de performance.

Si vous êtes d’accord, AWS et les tiers approuvés utiliseront également des cookies pour fournir des fonctionnalités utiles au site, mémoriser vos préférences et afficher du contenu pertinent, y compris des publicités pertinentes. Pour accepter ou refuser tous les cookies non essentiels, cliquez sur « Accepter » ou « Refuser ». Pour effectuer des choix plus détaillés, cliquez sur « Personnaliser ».

Aide-mémoire pour DynamoDB

Mode de mise au point
Aide-mémoire pour DynamoDB - Amazon DynamoDB

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.

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

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

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 \ --provisioned-throughput \ ReadCapacityUnits=10,WriteCapacityUnits=5
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 ^ --provisioned-throughput ^ ReadCapacityUnits=10,WriteCapacityUnits=5
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.

En savoir plus

Rubrique suivante :

Composants de base

Rubrique précédente :

Comment ça marche
ConfidentialitéConditions d'utilisation du sitePréférences de cookies
© 2025, Amazon Web Services, Inc. ou ses affiliés. Tous droits réservés.