Utilizzo di AWS CLI

È possibile utilizzare AWS Command Line Interface (AWS CLI) per controllare più servizi AWS dalla riga di comando e automatizzarli tramite script. Puoi usare la AWS CLI per operazioni ad hoc, quali la creazione di tabelle. È possibile utilizzarla anche per incorporare operazioni Amazon DynamoDB all'interno di script di utilità.

Prima di poter utilizzare la AWS CLI con DynamoDB, è necessario ottenere un ID chiave di accesso e una chiave di accesso segreta. Per ulteriori informazioni, consulta Concessione dell'accesso programmatico .

Per l'elenco completo di tutti i comandi disponibili per DynamoDB nella AWS CLI, consulta Riferimento ai comandi della AWS CLI.

Download e configurazione dell' AWS CLI

La AWS CLI è disponibile all'indirizzo http://aws.amazon.com/cli. Viene eseguita su Windows, macOS o Linux. Dopo aver scaricato la AWS CLI, segui le fasi per installarla e configurarla:

1. Passa alla Guida per l'utente di AWS Command Line Interface.

2. Segui le istruzioni riportate in Installazione della AWS CLI e Configurazione della AWS CLI.

Utilizzo di AWS CLI con DynamoDB

Il formato della riga di comando è costituito dal nome dell'operazione DynamoDB seguito dai parametri per l'operazione. AWS CLI supporta una sintassi abbreviata per i valori dei parametri, oltre a JSON.

Ad esempio, il seguente comando crea una tabella denominata Music. La chiave di partizione è Artist e la chiave di ordinamento è. SongTitle Per facilitare la leggibilità, in questa sezione i comandi lunghi sono suddivisi su righe separate.

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

I seguenti comandi aggiungono nuovi item alla tabella. In questi esempi viene utilizzata una combinazione di sintassi abbreviata e 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

Sulla riga di comando, può essere difficile comporre un JSON valido. Tuttavia, AWS CLI può leggere i file JSON. Considera ad esempio il seguente frammento di codice JSON, che viene memorizzato in un file denominato key-conditions.json:

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

È ora possibile emettere una richiesta Query utilizzando l'AWS CLI. In questo esempio il contenuto del file key-conditions.json viene utilizzato per il parametro --key-conditions:

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

Utilizzo di AWS CLI con DynamoDB local

AWS CLIPossono anche interagire con DynamoDB locale (versione scaricabile) in esecuzione sul computer. Per abilitare questo comportamento, aggiungi il seguente parametro a ciascun comando:

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

Il seguente esempio utilizza AWS CLI per elencare le tabelle in un database locale:

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

Se DynamoDB sta usando un numero di porta diverso da quello predefinito (8000), modificare di conseguenza il valore di --endpoint-url.

Nota

Non AWS CLI possono utilizzare la versione locale di DynamoDB (versione scaricabile) come endpoint predefinito. Di conseguenza devi specificare --endpoint-url per ogni comando.