Utilisation d'Amazon DynamoDB dans le 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.

Utilisation d'Amazon DynamoDB dans le 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 la 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. Le AWS CLI prend en charge la syntaxe CLI abrégée pour les valeurs des paramètres, et complète. 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 syntaxe abrégée et. 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 de manière valide JSON dans une commande d'une seule ligne. Pour faciliter les choses, ils AWS CLI peuvent lire JSON des fichiers. Par exemple, considérez l'JSONextrait de code 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 DynamoDB, sans manipuler les tables ou les API données du service Web DynamoDB. Au lieu de cela, toutes les API actions 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 CLI référence :

Référence du service :