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

• Installation et configuration de l' AWS CLI. Pour plus d’informations, consultez Installation ou mise à jour vers la dernière version du AWS CLI et Authentification et informations d'accès pour AWS CLI.

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. Il AWS CLI prend en charge la syntaxe abrégée de la CLI pour les valeurs des paramètres et le JSON complet.

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 faciliter les choses, ils AWS CLI peuvent lire les 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 :

• DynamoDB Local

• Utilisation du AWS CLI avec DynamoDB Local

Ressources

AWS CLI référence :

• aws dynamodb

• aws dynamodb create-table

• aws dynamodb put-item

• aws dynamodb query

Référence du service :

• DynamoDB Local dans le guide du développeur Amazon DynamoDB

• Utilisation de AWS CLI DynamoDB Local dans le manuel du développeur Amazon DynamoDB