Utilisation de la AWS CLI

Vous pouvez utiliser l'AWS Command Line Interface (AWS CLI) pour contrôler plusieurs services AWS à partir de la ligne de commande et les automatiser à l'aide de scripts. Vous pouvez utiliser le AWS CLI pour les opérations ad hoc, telles que la création d'une table. Vous pouvez également l'utiliser pour incorporer des opérations Amazon DynamoDB au sein de scripts utilitaires.

Pour pouvoir utiliser l'AWS CLI avec DynamoDB, vous devez obtenir un ID de clé d'accès et une clé d'accès secrète. Pour plus d’informations, consultez Accorder un accès par programmation .

Pour obtenir une liste complète de toutes les commandes disponibles pour DynamoDB dans l'AWS CLI, consultez la référence des commandes AWS CLI.

Téléchargement et configuration de la AWS CLI

L'AWS CLI est disponible à l'adresse http://aws.amazon.com/cli. Elle s'exécute sous Windows, macOS ou Linux. Après avoir téléchargé l'AWS CLI, procédez comme suit pour l'installer et la configurer :

1. Accédez au Guide de l'utilisateur AWS Command Line Interface.

2. Suivez les instructions d'Installation de l'AWS CLI et de Configuration de l'AWS CLI.

Utilisation de l'AWS CLI avec DynamoDB

Le format de ligne de commande se compose d'un nom d'opération DynamoDB, suivi des paramètres pour cette opération. l'AWS CLI prend en charge une version raccourcie de la syntaxe pour les valeurs des paramètres, ainsi que JSON.

Par exemple, la commande suivante permet de créer une table nommée Music. La clé de partition est Artist et la clé de tri est SongTitle. (Pour une lecture plus facile, les commandes longues dans cette section sont divisées en plusieurs lignes).

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=1,WriteCapacityUnits=1 \
    --table-class STANDARD

Les commandes suivantes permettent d'ajouter de nouveaux éléments à la table. Ces exemples utilisent une combinaison de la syntaxe raccourcie et de JSON.

aws dynamodb put-item \
    --table-name Music \
    --item \
        '{"Artist": {"S": "No One You Know"}, "SongTitle": {"S": "Call Me Today"}, "AlbumTitle": {"S": "Somewhat Famous"}}' \
    --return-consumed-capacity TOTAL  

aws dynamodb put-item \
    --table-name Music \
    --item '{
        "Artist": {"S": "Acme Band"},
        "SongTitle": {"S": "Happy Day"},
        "AlbumTitle": {"S": "Songs About Life"} }' \
    --return-consumed-capacity TOTAL

Sur la ligne de commande, il peut être difficile de composer un JSON valide. Toutefois, l'AWS CLI peut lire les fichiers JSON. Par exemple, imaginons l'extrait de code JSON suivant qui est stocké dans un fichier nommé key-conditions.json.

{
    "Artist": {
        "AttributeValueList": [
            {   
                "S": "No One You Know"
            }   
        ],  
        "ComparisonOperator": "EQ"
    },  
    "SongTitle": {
        "AttributeValueList": [
            {   
                "S": "Call Me Today"
            }   
        ],  
        "ComparisonOperator": "EQ"
    }
}

Vous pouvez désormais émettre une demande de Query à l'aide de l'AWS CLI. Dans cet exemple, le contenu du fichier key-conditions.json est utilisé pour le paramètre --key-conditions.

aws dynamodb query --table-name Music --key-conditions file://key-conditions.json

Utilisation du AWS CLI avec DynamoDB local

Ils AWS CLI peuvent également interagir avec DynamoDB local (version téléchargeable) qui s'exécute sur votre ordinateur. Pour ce faire, ajoutez le paramètre suivant pour chaque commande :

--endpoint-url http://localhost:8000

L'exemple suivant utilise l'AWS CLI pour répertorier les tables dans une base de données locale.

aws dynamodb list-tables --endpoint-url http://localhost:8000

Si DynamoDB utilise un numéro de port autre que la valeur par défaut (8000), modifiez la valeur --endpoint-url en conséquence.

Note

Impossible AWS CLI d'utiliser le DynamoDB local (version téléchargeable) comme point de terminaison par défaut. Par conséquent, vous devez spécifier --endpoint-url avec chaque commande.