Tutorial su Amazon DynamoDB per AWS Cloud9

Per configurare la gestione delle credenziali per l' AWS CLI o il AWS CloudShell e installare il AWS CLI AWS CloudShell, il o entrambi nell'ambiente, segui i passaggi 1 e 2 nell'AWS CloudShell esempio AWS CLI and, quindi torna a questo argomento. Se avete già installato e configurato il AWS CLI AWS CloudShell, il o entrambi nel vostro ambiente, non è necessario farlo di nuovo.

Verifica l'installazione e la configurazione di AWS CLI, della aws-shell o di entrambe eseguendo il list-tablescomando DynamoDB da una sessione di terminale nel tuo ambiente per elencare le tabelle DynamoDB esistenti, se presenti. Per avviare una nuova sessione del terminale, nella barra dei menu seleziona Windows (Finestre), New Terminal (Nuovo terminale).

aws dynamodb list-tables # For the AWS CLI.
dynamodb list-tables     # For the aws-shell.

Se il comando viene eseguito correttamente, restituisce un array TableNames contenente un elenco delle tabelle DynamoDB esistenti che potresti già avere. Se non disponi ancora di tabelle DynamoDB, l'array TableNames sarà vuoto.

{
  "TableNames": []
}

Se disponi di tabelle DynamoDB, l'array TableNames contiene un elenco dei nomi delle tabelle.

Creare un archivio denominato weather-item.json con i seguenti contenuti. Per creare un nuovo file, nella barra dei menu seleziona File, New File (Nuovo file). Per salvare il file, seleziona File, Save (Salva).

{
  "CityID": { "N": "1" },
  "Date": { "S": "2017-04-12" },
  "City": { "S": "Seattle" },
  "State": { "S": "WA" },
  "Conditions": { "S": "Rain" },
  "Temperatures": { "M": {
      "HighF": { "N": "59" },
      "LowF": { "N": "46" }
    }
  }
}

In questo codice, N rappresenta un valore di attributo che è un numero. S è un valore di attributo della stringa. M è un attributo di mappa, che è un insieme di coppie attributo-valore. Quando lavori con gli item, devi specificare un tipo di dati per gli attributi. Per ulteriori tipi di dati degli attributi, consulta Tipi di dati nella Guida per gli sviluppatori di Amazon DynamoDB.

Esegui il comando put-itemDynamoDB, specificando il nome della tabella --table-name () e il percorso dell'elemento -formatted (). JSON --item

aws dynamodb put-item \
--table-name Weather \
--item file://weather-item.json

Se il comando viene eseguito correttamente, senza errori e non viene visualizzato alcun messaggio di conferma.

Per verificare i contenuti correnti della tabella, esegui il comando scan di DynamoDB, specificando il nome della tabella (--table-name).

aws dynamodb scan --table-name Weather

Se il comando viene eseguito correttamente, vengono visualizzate le informazioni sulla tabella e sull'item appena aggiunto.

Creare un archivio denominato more-weather-items.json con i seguenti contenuti.

{
  "Weather": [
    {
      "PutRequest": {
        "Item": {
          "CityID": { "N": "1" },
          "Date": { "S": "2017-04-13" },
          "City": { "S": "Seattle" },
          "State": { "S": "WA" },
          "Conditions": { "S": "Rain" },
          "Temperatures": { "M": {
              "HighF": { "N": "52" },
              "LowF": { "N": "43" }
            }
          }
        }
      }
    },
    {
      "PutRequest": {
        "Item": {
          "CityID": { "N": "1" },
          "Date": { "S": "2017-04-14" },
          "City": { "S": "Seattle" },
          "State": { "S": "WA" },
          "Conditions": { "S": "Rain" },
          "Temperatures": { "M": {
              "HighF": { "N": "49" },
              "LowF": { "N": "43" }
            }
          }
        }
      }
    },
    {
      "PutRequest": {
        "Item": {
          "CityID": { "N": "2" },
          "Date": { "S": "2017-04-12" },
          "City": { "S": "Portland" },
          "State": { "S": "OR" },
          "Conditions": { "S": "Thunderstorms" },
          "Temperatures": { "M": {
              "HighF": { "N": "59" },
              "LowF": { "N": "43" }
            }
          }
        }
      }
    },
    {
      "PutRequest": {
        "Item": {
          "CityID": { "N": "2" },
          "Date": { "S": "2017-04-13" },
          "City": { "S": "Portland" },
          "State": { "S": "OR" },
          "Conditions": { "S": "Rain" },
          "Temperatures": { "M": {
              "HighF": { "N": "51" },
              "LowF": { "N": "41" }
            }
          }
        }
      }
    },
    {
      "PutRequest": {
        "Item": {
          "CityID": { "N": "2" },
          "Date": { "S": "2017-04-14" },
          "City": { "S": "Portland" },
          "State": { "S": "OR" },
          "Conditions": { "S": "Rain Showers" },
          "Temperatures": { "M": {
              "HighF": { "N": "49" },
              "LowF": { "N": "39" }
            }
          }
        }
      }
    },
    {
      "PutRequest": {
        "Item": {
          "CityID": { "N": "3" },
          "Date": { "S": "2017-04-12" },
          "City": { "S": "Portland" },
          "State": { "S": "ME" },
          "Conditions": { "S": "Rain" },
          "Temperatures": { "M": {
              "HighF": { "N": "59" },
              "LowF": { "N": "40" }
            }
          }
        }
      }
    },
    {
      "PutRequest": {
        "Item": {
          "CityID": { "N": "3" },
          "Date": { "S": "2017-04-13" },
          "City": { "S": "Portland" },
          "State": { "S": "ME" },
          "Conditions": { "S": "Partly Sunny" },
          "Temperatures": { "M": {
              "HighF": { "N": "54" },
              "LowF": { "N": "37" }
            }
          }
        }
      }
    },
    {
      "PutRequest": {
        "Item": {
          "CityID": { "N": "3" },
          "Date": { "S": "2017-04-14" },
          "City": { "S": "Portland" },
          "State": { "S": "ME" },
          "Conditions": { "S": "Mostly Sunny" },
          "Temperatures": { "M": {
              "HighF": { "N": "53" },
              "LowF": { "N": "37" }
            }
          }
        }
      }
    }
  ]
}

In questo codice, 8 oggetti Item definiscono gli 8 item da aggiungere alla tabella, simili al singolo item definito nella fase precedente. Tuttavia, quando si esegue il comando batch-write-itemDynamoDB nel passaggio successivo, è necessario fornire JSON un oggetto con formattazione che includa Item ogni oggetto in un oggetto contenitore. PutRequest Quindi devi includere tali oggetti PutRequest in un array padre che abbia lo stesso nome della tabella.

Esegui il comando batch-write-itemDynamoDB, specificando il percorso degli elementi in formato -format da JSON aggiungere (). --request-items

aws dynamodb batch-write-item \
--request-items file://more-weather-items.json

Se il comando viene eseguito correttamente, viene visualizzato il messaggio seguente, a conferma che gli item sono stati aggiunti correttamente.

{
  "UnprocessedItems": {}
}

Per confermare i contenuti correnti della tabella, esegui di nuovo il comando scan di DynamoDB.

aws dynamodb scan --table-name Weather

Se il comando viene eseguito correttamente, adesso sono visualizzati 9 item.

Creare un archivio denominato weather-global-index.json con i seguenti contenuti.

[
  {
    "Create": {
      "IndexName": "weather-global-index",
      "KeySchema": [
        {
          "AttributeName": "City",
          "KeyType": "HASH"
        },
        {
          "AttributeName": "Date",
          "KeyType": "RANGE"
        }
      ],
      "Projection": {
        "ProjectionType": "INCLUDE",
        "NonKeyAttributes": [
          "State",
          "Conditions",
          "Temperatures"
        ]
      },
      "ProvisionedThroughput": {
        "ReadCapacityUnits": 5,
        "WriteCapacityUnits": 5
      }
    }
  }
]

In questo codice:

Esegui il comando update-table di DynamoDB.

aws dynamodb update-table \
--table-name Weather \
--attribute-definitions \
  AttributeName=City,AttributeType=S AttributeName=Date,AttributeType=S \
--global-secondary-index-updates file://weather-global-index.json

In questo comando:

Se questo comando viene eseguito correttamente, vengono visualizzate le informazioni di riepilogo sul nuovo indice secondario globale in fase di creazione. Per confermare la corretta creazione dell'indice secondario globale, esegui il comando describe-table di DynamoDB, specificando il nome della tabella (--table-name).

aws dynamodb describe-table --table-name Weather

Una volta creato correttamente l'indice secondario globale, il valore di TableStatus cambia da UPDATING a ACTIVE e il valore di IndexStatus da CREATING a ACTIVE. Non procedere oltre questa fase finché l'indice secondario globale non è stato creato correttamente. Questo processo può richiedere diversi minuti.

Per eseguire il comando get-item di DynamoDB, specifica il nome della tabella (--table-name), il valore della chiave primaria (--key) e i valori degli attributi dell'elemento da visualizzare (--projection-expression). Poiché Date è una parola chiave riservata in DynamoDB, devi fornire anche un alias per il valore di attributo Date (--expression-attribute-names) (anche State è una parola chiave riservata, quindi ne visualizzerai un alias nelle fasi successive).

aws dynamodb get-item \
--table-name Weather \
--key '{ "CityID": { "N": "1" }, "Date": { "S": "2017-04-12" } }' \
--projection-expression \
  "City, #D, Conditions, Temperatures.HighF, Temperatures.LowF" \
--expression-attribute-names '{ "#D": "Date" }'

In questo e negli altri comandi, per visualizzare tutti gli attributi dell'item, non includere --projection-expression. In questo esempio, dato che non stai includendo --projection-expression non hai bisogno di includere neanche --expression-attribute-names.

aws dynamodb get-item \
--table-name Weather \
--key '{ "CityID": { "N": "1" }, "Date": { "S": "2017-04-12" } }'

Per eseguire il comando scan di DynamoDB, specifica:

aws dynamodb scan \
--table-name Weather \
--filter-expression "(CityID = :cityID) and (#D = :date)" \
--expression-attribute-values \
  '{ ":cityID": { "N": "1" }, ":date": { "S": "2017-04-12" } }' \
--select SPECIFIC_ATTRIBUTES \
--projection-expression \
  "City, #D, Conditions, Temperatures.HighF, Temperatures.LowF" \
--expression-attribute-names '{ "#D": "Date" }'

Per eseguire il comando query di DynamoDB, specifica:

aws dynamodb query \
--table-name Weather \
--key-condition-expression "(CityID = :cityID) and (#D = :date)" \
--expression-attribute-values \
  '{ ":cityID": { "N": "1" }, ":date": { "S": "2017-04-12" } }' \
--select SPECIFIC_ATTRIBUTES \
--projection-expression \
  "City, #D, Conditions, Temperatures.HighF, Temperatures.LowF" \
--expression-attribute-names '{ "#D": "Date" }'

Nota che il comando scan ha dovuto eseguire la scansione di tutte e 9 le voci per ottenere il risultato, mentre il comando query ha dovuto eseguire la scansione solo di 1 voce.