Tutorial do Amazon DynamoDB para AWS Cloud9

Para configurar o gerenciamento de credenciais para o AWS CLI ou o AWS CloudShell e instalar o AWS CLI AWS CloudShell, o ou ambos em seu ambiente, siga as etapas 1 e 2 no AWS CloudShell exemplo AWS CLI e, em seguida, retorne a este tópico. Se você já instalou e configurou o AWS CLI AWS CloudShell, o ou ambos em seu ambiente, não precisa fazer isso novamente.

Teste a instalação e a configuração do AWS CLI, do aws-shell ou de ambos executando o list-tablescomando do DynamoDB em uma sessão de terminal em seu ambiente para listar suas tabelas existentes do DynamoDB, se houver alguma. Para iniciar uma nova sessão de terminal, na barra de menus, selecione Windows (Janelas), New Terminal (Novo terminal).

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

Se esse comando for bem-sucedido, ele gera uma matriz TableNames que contém uma lista das tabelas do DynamoDB existentes que você já pode ter. Caso ainda não possua tabelas do DynamoDB, a matriz TableNames estará vazia.

{
  "TableNames": []
}

Se você tiver tabelas do DynamoDB, a matriz TableNames conterá uma lista dos nomes das tabelas.

Crie um arquivo chamado weather-item.json com o conteúdo a seguir. Para criar um novo arquivo, na barra de menus, selecione File (Arquivo), New File (Novo arquivo). Para salvar o arquivo, selecione File (Arquivo), Save (Salvar).

{
  "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" }
    }
  }
}

Neste código, N representa um valor de atributo que é um número. S é um valor de atributo de string. M é um atributo de mapa, que é um conjunto de pares de valores de atributos. É necessário especificar o tipo de dados de um atributo sempre que trabalhar com itens. Para obter os tipos de dados de atributos adicionais disponíveis, consulte Data Types (Tipos de dados) no Manual do desenvolvedor do Amazon DynamoDB.

Execute o comando put-item do DynamoDB, especificando o nome da tabela (--table-name) e o caminho para o item no formato JSON (--item).

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

Se o comando for bem-sucedido, ele é executado sem erros e nenhuma mensagem de confirmação é exibida.

Para confirmar o conteúdo atual da tabela, execute o comando scan do DynamoDB, especificando o nome da tabela (--table-name).

aws dynamodb scan --table-name Weather

Se o comando for bem-sucedido, são exibidas informações resumidas sobre a tabela e sobre o item que acabou de adicionar.

Crie um arquivo chamado more-weather-items.json com o conteúdo a seguir.

{
  "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" }
            }
          }
        }
      }
    }
  ]
}

Neste código, oito objetos Item definem os oito itens para adicionar à tabela, semelhante ao único item definido na etapa anterior. No entanto, ao executar o comando batch-write-item do DynamoDB na próxima etapa, será necessário fornecer um objeto no formato JSON que inclui cada objeto do Item em um objeto PutRequest relativo. Em seguida, será necessário incluir os objetos PutRequest em uma matriz pai com o mesmo nome que a tabela.

Execute o comando batch-write-item do DynamoDB, especificando o caminho para os itens no formato JSON para adicionar (--request-items).

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

Se o comando for bem-sucedido, ele exibe a seguinte mensagem, confirmando que os itens foram adicionados com sucesso.

{
  "UnprocessedItems": {}
}

Para confirmar o conteúdo atual da tabela, execute o comando scan do DynamoDB novamente.

aws dynamodb scan --table-name Weather

Se o comando for bem-sucedido, serão exibidos nove itens.

Crie um arquivo chamado weather-global-index.json com o conteúdo a seguir.

[
  {
    "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
      }
    }
  }
]

Neste código:

Execute o comando update-table do 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

Neste comando:

Se esse comando for bem-sucedido, ele exibe informações resumidas sobre o novo índice secundário global que está sendo criado. Para confirmar se o índice secundário global foi criado com sucesso, execute o comando describe-table do DynamoDB, especificando o nome da tabela (--table-name).

aws dynamodb describe-table --table-name Weather

Quando o índice secundário global for criado com sucesso, o valor TableStatus muda de UPDATING para ACTIVE e o valor IndexStatus muda de CREATING para ACTIVE. Não avance para a próxima etapa até que o índice secundário global seja criado com sucesso. Isso pode demorar vários minutos.

Para executar o comando get-item do DynamoDB, especifique o nome da tabela (--table-name), o valor da chave primária (--key) e os valores do atributo do item para exibição (--projection-expression). Como Date é uma palavra-chave reservada no DynamoDB você também deverá fornecer um alias para o valor do atributo Date (--expression-attribute-names). (O State também é uma palavra-chave reservada e, portanto, você verá um alias fornecido a ela em etapas posteriores).

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" }'

Neste e em outros comandos, para exibir todos os atributos do item, não inclua --projection-expression. Neste exemplo, como --projection-expression não está incluso, também não é necessário incluir --expression-attribute-names.

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

Para executar o comando scan do DynamoDB, especifique:

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" }'

Para executar o comando query do DynamoDB, especifique:

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" }'

Observe que o comando scan precisou verificar todos os nove itens para obter o resultado, enquanto o comando query precisou verificar apenas um item.