Utilisez Amazon DynamoDB avec AWS CLI - AWS Command Line Interface
PrérequisCréation et utilisation de tables DynamoDBUtilisation de DynamoDB LocalRessources

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.

Utilisez Amazon DynamoDB avec AWS CLI

Présentation d'Amazon DynamoDB

Le AWS Command Line Interface (AWS CLI) prend en charge tous les services de AWS base de données, y compris Amazon DynamoDB. Vous pouvez l'utiliser AWS CLI pour des opérations impromptues, telles que la création d'une table. Vous pouvez également l'utiliser pour intégrer des opérations DynamoDB dans des scripts utilitaires.

Pour plus d'informations sur l'utilisation de AWS CLI avec DynamoDB, dynamodb consultez le manuel de référence des commandes. AWS CLI

Pour répertorier les AWS CLI commandes de DynamoDB, utilisez la commande suivante.

$ aws dynamodb help

Prérequis

Pour exécuter les dynamodb commandes, vous devez :

Création et utilisation de tables DynamoDB

Le format de ligne de commande consiste en un nom de commande DynamoDB, suivi des paramètres de cette commande. L'AWS CLI prend en charge la syntaxe raccourcie de l'interface de ligne de commande pour les valeurs des paramètres, ainsi que l'intégralité du texte JSON.

L'exemple suivant crée une table nommée MusicCollection. 

$ aws dynamodb create-table \
    --table-name MusicCollection \
    --attribute-definitions AttributeName=Artist,AttributeType=S AttributeName=SongTitle,AttributeType=S \
    --key-schema AttributeName=Artist,KeyType=HASH AttributeName=SongTitle,KeyType=RANGE \
    --provisioned-throughput ReadCapacityUnits=1,WriteCapacityUnits=1

Vous pouvez ajouter de nouvelles lignes à la table avec des commandes similaires à celles indiquées dans l'exemple suivant. Ces exemples utilisent une combinaison de la syntaxe raccourcie et de JSON.

$ aws dynamodb put-item \
    --table-name MusicCollection \
    --item '{
        "Artist": {"S": "No One You Know"},
        "SongTitle": {"S": "Call Me Today"} ,
        "AlbumTitle": {"S": "Somewhat Famous"} 
      }' \
    --return-consumed-capacity TOTAL
{
    "ConsumedCapacity": {
        "CapacityUnits": 1.0,
        "TableName": "MusicCollection"
    }
}
$ aws dynamodb put-item \
    --table-name MusicCollection \
    --item '{ 
        "Artist": {"S": "Acme Band"}, 
        "SongTitle": {"S": "Happy Day"} , 
        "AlbumTitle": {"S": "Songs About Life"} 
      }' \
    --return-consumed-capacity TOTAL
{
    "ConsumedCapacity": {
        "CapacityUnits": 1.0,
        "TableName": "MusicCollection"
    }
}

Il peut être difficile de composer un JSON valide sur une seule ligne de commande. Pour simplifier le processus, l'AWS CLI peut lire des fichiers JSON. Par exemple, imaginons l'extrait JSON suivant qui est stocké dans un fichier nommé expression-attributes.json.

{
  ":v1": {"S": "No One You Know"},
  ":v2": {"S": "Call Me Today"}
}

Vous pouvez utiliser ce fichier pour émettre une demande query à l'aide de l'AWS CLI. Dans l'exemple suivant, le contenu du fichier expression-attributes.json est utilisé pour le paramètre --expression-attribute-values.

$ aws dynamodb query --table-name MusicCollection \
    --key-condition-expression "Artist = :v1 AND SongTitle = :v2" \
    --expression-attribute-values file://expression-attributes.json
{
    "Count": 1,
    "Items": [
        {
            "AlbumTitle": {
                "S": "Somewhat Famous"
            },
            "SongTitle": {
                "S": "Call Me Today"
            },
            "Artist": {
                "S": "No One You Know"
            }
        }
    ],
    "ScannedCount": 1,
    "ConsumedCapacity": null
}

Utilisation de DynamoDB Local

Outre DynamoDB, vous pouvez utiliser le AWS CLI avec DynamoDB Local. DynamoDB Local est une petite base de données et un serveur côté client qui imite le service DynamoDB. DynamoDB Local vous permet d'écrire des applications qui utilisent l'API DynamoDB, sans manipuler les tables ou les données du service Web DynamoDB. Au lieu de cela, toutes les actions d'API sont redirigées vers une base de données locale. Cela vous permet d'économiser sur le débit alloué, le stockage de données et les frais de transfert de données.

Pour plus d'informations sur DynamoDB Local et sur son utilisation avec AWS CLI le, consultez les sections suivantes du manuel Amazon DynamoDB Developer Guide :

Ressources

AWS CLIréférence :

Référence du service :