Tramite 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, consultare Come ottenere una chiave di accesso AWS.

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 della AWS CLI con la versione scaricabile di DynamoDB

La AWS CLI può interagire anche con la versione scaricabile di DynamoDB che viene eseguita 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

La AWS CLI non è in grado di usare la versione scaricabile di DynamoDB come endpoint predefinito. Di conseguenza devi specificare --endpoint-url per ogni comando.