Utilisation d’Amazon DynamoDB dans l’AWS CLI

L’AWS Command Line Interface (AWS CLI) assure la prise en charge de tous les services de base de données AWS, y compris Amazon DynamoDB. Vous pouvez utiliser l’AWS CLI pour les opérations impromptues, telles que la création d’une table. Vous pouvez également l’utiliser pour incorporer des opérations DynamoDB au sein de scripts utilitaires.

Pour plus d’informations sur l’utilisation de l’AWS CLI avec DynamoDB, consultez dynamodb dans la Référence des commandes de l’AWS CLI.

Pour afficher les commandes de l’AWS CLI pour DynamoDB, utilisez la commande suivante.

$ aws dynamodb help

Prérequis

Pour exécuter les commandes dynamodb, vous devez respecter les conditions requises suivantes :

Création et utilisation de tables DynamoDB

Le format de ligne de commande se compose d’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

En plus de DynamoDB, vous pouvez utiliser l’AWS CLI avec DynamoDB Local. DynamoDB Local est une petite base de données côté client et un serveur qui imite le service DynamoDB. DynamoDB Local vous permet d’écrire des applications qui utilisent l’API DynamoDB, sans manipuler de tables ni de données dans le 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 son utilisation avec l’AWS CLI, consultez les sections suivantes du Manuel du développeur Amazon DynamoDB :

Ressources

Référence de l’AWS CLI :

Référence du service :