# Criar modelos de dados com o NoSQL Workbench É possível usar a ferramenta de modelação de dados no NoSQL Workbench para Amazon DynamoDB para criar modelos de dados ou modelos com base em modelos de dados existentes que satisfaçam os padrões de acesso a dados da aplicação. O modelador de dados inclui alguns modelos de dados de exemplo para ajudar você a começar. **Topics** + [Criar um novo modelo de dados](workbench.Modeler.CreateNew.md) + [Importar um modelo de dados existente](workbench.Modeler.ImportExisting.md) + [Editar um modelo de dados existente](workbench.Modeler.Edit.md) + [Adicionar dados de exemplo a um modelo de dados](workbench.Modeler.AddData.md) + [Adicionar e validar padrões de acesso](workbench.Modeler.AccessPatterns.md) + [Importar dados de amostra de um arquivo CSV](workbench.Modeler.ImportCSV.md) + [Facetas](workbench.Modeler.Facets.md) + [Visualizar todas as tabelas de um modelo de dados usando visualização](workbench.Modeler.AggregateView.md) + [Exportar um modelo de dados](workbench.Modeler.ExportModel.md) + [Confirmação de um modelo de dados no DynamoDB](workbench.Modeler.Commit.md) # Criar um novo modelo de dados Siga estas etapas para criar um novo modelo de dados no Amazon DynamoDB usando o NoSQL Workbench. **Para criar um novo modelo de dados** 1. Abra o NoSQL Workbench e, na tela principal, selecione **Criar modelo manualmente**. Uma nova página será aberta com uma configuração vazia para sua primeira tabela. O NoSQL Workbench cria todos os modelos de dados com um nome padrão (isto é, untitled-2) e os adiciona à pasta de projeto **Drafts**. 1. Na tela **Configuração de tabela**, especifique o seguinte: + **Table name** (Nome da tabela): insira um nome exclusivo para a tabela. + **Chave de partição**: insira um nome de chave de partição e especifique o respectivo tipo. Opcionalmente, você também pode selecionar um formato de tipo de dados mais granular para geração de dados de amostra. + Se você quiser adicionar uma **chave de classificação**, especifique o nome da chave de classificação e o respectivo tipo. Opcionalmente, você também pode selecionar um formato de dados mais granular para geração de dados de amostra. **nota** Para saber mais sobre design de chave primária, como projetar e usar chaves de partição de forma eficaz e usar chaves de classificação, consulte o seguinte: [Chave primária](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey) [Práticas recomendadas para projetar e usar chaves de partição de maneira eficaz no DynamoDB](bp-partition-key-design.md) [Práticas recomendadas para usar chaves de classificação para organizar dados no DynamoDB](bp-sort-keys.md) 1. É possível adicionar outros atributos para validar mais claramente o modelo e os padrões de acesso. Para adicionar outros atributos: + Escolha **Adicionar um atributo**. + Especifique o nome e o tipo do atributo. + Opcionalmente, você também pode selecionar um formato de dados mais granular para geração de dados de amostra. 1. Se desejar adicionar um índice secundário global, escolha **Add global secondary index** (Adicionar índice secundário global). Especifique o **Global secondary index name** (Nome do índice secundário global), o atributo **Partition key** (Chave de partição) e o **Projection type** (Tipo de projeção). Para obter mais informações sobre como trabalhar com índices secundários globais no DynamoDB, consulte [Índices secundários globais](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GSI.html). 1. Opcionalmente, **adicione uma faceta**. Faceta é um constructo virtual no NoSQL Workbench. Não é um constructo funcional no DynamoDB. No NoSQL Workbench, as facetas ajudam a visualizar os diferentes padrões de acesso a dados de uma aplicação para o DynamoDB com apenas um subconjunto dos dados em uma tabela. **nota** Recomendamos que, em vez de facetas, você use [Adicionar e validar padrões de acesso](workbench.Modeler.AccessPatterns.md) para visualizar como sua aplicação acessará os dados no DynamoDB. Os padrões de acesso evidenciam suas interações reais com o banco de dados e ajudam a criar o modelo de dados correto para o caso de uso, enquanto as facetas são visualizações não funcionais. Escolha **Adicionar faceta**. Especifique o seguinte: + O **Facet name** (Nome da faceta). + Um **alias de chave de partição**, para ajudar a distinguir essa visualização de facetas. + Um **alias de chave de classificação** se você tiver fornecido uma **chave de classificação** para a tabela. + Escolha os **atributos** que fazem parte dessa faceta. Repita esta etapa se quiser adicionar mais facetas. 1. Por fim, clique no botão **Salvar** para criar a tabela. 1. Se precisar de outras **tabelas** ou **índices secundários globais**, clique no ícone **\$1** acima da tabela que você acabou de criar. # Importar um modelo de dados existente Use o NoSQL Workbench para Amazon DynamoDB para criar um modelo de dados importando e modificando um modelo existente. Você pode importar modelos de dados no formato de modelo NoSQL Workbench ou no [Formato de modelo AWS CloudFormation JSON](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-table.html). **Para importar um modelo de dados** 1. Abra o NoSQL Workbench e, na tela principal, selecione **Importar modelo**. É possível importar um formato de modelo do NoSQL Workbench ou um modelo JSON do CloudFormation. 1. Você pode adicionar o modelo importado a um projeto existente ou criar um projeto. Se você não escolher um projeto diferente, o modelo será adicionado à pasta de rascunhos do projeto. 1. Clique em **Pesquisar na área de trabalho** e escolha um modelo para importar do seu computador. # Editar um modelo de dados existente **Como editar um usuário existente** 1. Para começar a fazer alterações em um modelo existente, abra o modelo na página do modelador. 1. No painel do seletor de recursos, você verá a lista de **tabelas** e **índices secundários globais**. 1. Para editar uma **tabela** ou um **índice secundário global**, primeiro clique no respectivo nome no painel do seletor de recursos e, em seguida, use os ícones de ação na parte superior. As ações disponíveis são **Excluir**, **Duplicar** e **Editar**. 1. Se você quiser editar **detalhes do modelo**, clique no ícone de três pontos ao lado do nome do modelo. 1. A partir daí, você pode clicar em **Editar detalhes do modelo** e editar as informações adequadamente. 1. Também é possível **duplicar**, **mover**, **excluir** e **exportar** o modelo no mesmo menu. 1. Para mudar para outro modelo, acesse a tela principal novamente ou use o menu suspenso de seleção de modelos. # Adicionar dados de exemplo a um modelo de dados **Como gerar dados de amostra automaticamente** 1. Abra o NoSQL Workbench e, na tela principal, clique no nome do modelo ao qual você deseja adicionar dados de amostra. 1. Clique nas ações adicionais (ícone de três pontos) na barra de ferramentas de conteúdo principal e selecione **Adicionar dados de amostra**. 1. Insira o número ou os itens de dados de amostra que você gostaria de gerar e selecione **Confirmar**. 1. A geração automática de dados de amostra ajuda a gerar entre 1 e 5 mil linhas de dados para uso imediato. Você pode especificar um tipo de dados de amostra granular para criar dados realistas com base em suas necessidades de projeto e teste. Para utilizar a capacidade de gerar dados realistas, você precisa especificar o formato do tipo de dados de amostra para seus atributos no modelador de dados. Consulte [Criar um novo modelo de dados](workbench.Modeler.CreateNew.md) para especificar formatos de tipo de dados de amostra. **Como adicionar dados de amostra um item por vez** 1. Abra o modelo que você deseja editar e escolha a tabela à qual quer adicionar dados de amostra. Clique nas ações adicionais (ícone de três pontos) na barra de ferramentas de conteúdo principal e selecione **Editar dados**. 1. Agora é possível adicionar, excluir e editar linhas. Depois de fazer as alterações necessárias, clique no botão **Salvar**. # Adicionar e validar padrões de acesso *Use o NoSQL Workbench para Amazon DynamoDB para criar, armazenar e validar padrões de acesso*. **nota** Consulte [Identificar padrões de acesso a dados](https://docs.aws.amazon.com/prescriptive-guidance/latest/dynamodb-data-modeling/step3.html) para ver mais detalhes sobre como identificar os padrões de acesso corretos. **Como criar um ponto de acesso** 1. Abra o NoSQL Workbench e, na tela principal, clique no nome do modelo ao qual você deseja adicionar padrões de acesso. 1. No lado esquerdo, escolha a guia **Padrões de acesso** e clique no ícone **\$1**. 1. Na próxima tela, forneça um **nome**, uma **descrição** opcional, o **tipo** do padrão de acesso e a **tabela** ou o **índice secundário global** para testar o padrão de acesso. **nota** No momento, o NoSQL Workbench permite as seguintes operações para padrões de acesso: `Scan`, `Query`, `GetItem`, `PutItem`, `UpdateItem` e `DeleteItem`. A lista de operações permitidas pelo Amazon DynamoDB é mais ampla. 1. Depois de criar um padrão de acesso, alterne para a guia **Validar** para verificar se o modelo de dados foi projetado para exibir os resultados esperados para o padrão de acesso. Consulte [Adicionar dados de exemplo a um modelo de dados](workbench.Modeler.AddData.md) para ver detalhes sobre como gerar automaticamente dados de amostra para suas tabelas. Diferentes tipos de padrão de acesso permitem diferentes parâmetros de entrada. **nota** Para validar os padrões de acesso, o NoSQL Workbench inicia um banco de dados do DynamoDB local separado na porta `8001` (por padrão) com tabelas e índices armazenados na memória. O NoSQL Workbench adiciona automaticamente os dados de amostra do modelo às tabelas temporárias. Se você editar os dados de amostra ou o próprio modelo de dados, o NoSQL Workbench atualizará as tabelas temporárias. Esse banco de dados temporário é apagado quando a aplicação é fechada. **Como editar padrões de acesso** 1. Abra o NoSQL Workbench e, na tela principal, clique no nome do modelo no qual você deseja editar padrões de acesso. 1. No lado esquerdo, escolha a guia **Padrões de acesso** 1. Para editar um padrão de acesso, selecione-o na lista à esquerda. 1. Na barra superior, clique no botão de ação **Editar**. # Importar dados de amostra de um arquivo CSV Se você tiver dados de amostra preexistentes em um arquivo CSV, poderá importá-los para o NoSQL Workbench. Isso permite que você preencha rapidamente seu modelo com dados de amostra sem ter que inseri-los linha a linha. Os nomes de coluna no arquivo CSV devem corresponder aos nomes de atributo no modelo de dados, mas não precisam estar na mesma ordem. Por exemplo, se o modelo de dados tiver atributos chamados`LoginAlias`, `FirstName` e `LastName`, suas colunas CSV podem ser `LastName`, `FirstName` e `LoginAlias`. É possível importar até 150 linhas por vez de um arquivo CSV. **Importar dados de um arquivo CSV para o NoSQL Workbench** 1. Para importar dados CSV para uma **tabela**, primeiro clique no nome da tabela no painel de recursos e, em seguida, clique nas ações adicionais (ícone de três pontos) na barra de ferramentas de conteúdo principal. 1. Selecione **Importar dados de amostra**. 1. Selecione o arquivo CSV e escolha **Open** (Abrir). Os dados CSV são anexados à tabela. # Facetas No NoSQL Workbench, as *facetas* oferecem uma maneira de visualizar um subconjunto dos dados em uma tabela, sem precisar ver os registros que não atendam às restrições da faceta. As facetas são consideradas uma ferramenta visual de modelagem de dados e não existem como uma estrutura utilizável no DynamoDB, pois são puramente uma ajuda para a modelagem de padrões de acesso. **nota** Recomendamos que, em vez de facetas, você use [Adicionar e validar padrões de acesso](workbench.Modeler.AccessPatterns.md) para visualizar como sua aplicação acessará os dados no DynamoDB. Os padrões de acesso evidenciam suas interações reais com o banco de dados e ajudam a criar o modelo de dados correto para o caso de uso, enquanto as facetas são visualizações não funcionais. **Como criar uma faceta** 1. No painel do seletor de recursos, escolha a **tabela** que você deseja editar. 1. Na barra superior, clique no ícone de ação **Editar**. 1. Role para baixo até a seção **Filtros de faceta**. 1. Escolha **Adicionar faceta**. Especifique o seguinte: + O **Facet name** (Nome da faceta). + Um **alias de chave de partição**, para ajudar a distinguir essa visualização de facetas. + Um **alias de chave de classificação** se você tiver fornecido uma **chave de classificação** para a tabela. + Escolha os **atributos** que fazem parte dessa faceta. Repita esta etapa se quiser adicionar mais facetas. # Visualizar todas as tabelas de um modelo de dados usando visualização A visualização agregada no NoSQL Workbench para Amazon DynamoDB permite visualizar todos os índices e tabelas de um modelo de dados. Para cada tabela, são exibidas as seguintes informações: + Nomes de colunas da tabela + Dados de exemplo + Todos os índices secundários globais associados à tabela. O NoSQL Workbench exibe as seguintes informações para cada índice: + Nomes de colunas do índice + Dados de exemplo **Para visualizar todas as informações da tabela** 1. Abra o NoSQL Workbench e, na tela principal, clique no nome do modelo que você deseja abrir. 1. Na barra superior, clique em **Visualização agregada**. Você verá os dados de todos os índices e tabelas na mesma tela. **Como exportar a visualização agregada como imagens** 1. Com a **Visualização agregada** selecionada, clique no ícone de três pontos e escolha **Exportar visualização agregada**. 1. Um arquivo com imagens PNG de todos os índices e tabelas será apresentado para download. # Exportar um modelo de dados Depois de criar um modelo de dados usando o NoSQL Workbench para Amazon DynamoDB, você poderá salvar e exportar o modelo no formato de modelo NoSQL Workbench ou [Formato de modelo JSON do AWS CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-table.html). **Para exportar um modelo de dados** 1. Abra o NoSQL Workbench e, na tela principal, clique no nome do modelo que você deseja editar. 1. Clique no ícone de três pontos ao lado do nome do modelo de dados e selecione **Exportar modelo**. 1. Escolha se deseja importar o modelo de dados no formato de modelo do NoSQL Workbench ou no formato de modelo JSON do CloudFormation. + Escolha o formato **Modelo do NoSQL Workbench** se quiser compartilhar o modelo com outros membros da equipe usando o NoSQL Workbench ou importá-lo para o NoSQL Workbench posteriormente. + Escolha o formato **Modelo JSON do CloudFormation** se quiser implantar o modelo diretamente na AWS ou integrá-lo ao seu fluxo de trabalho de infraestrutura como código. # Confirmação de um modelo de dados no DynamoDB Quando estiver satisfeito com seu modelo de dados, você poderá confirmá-lo no Amazon DynamoDB. **nota** Essa ação cria recursos do lado do servidor na AWS para as tabelas e os índices secundários globais representados no modelo de dados. Por padrão, o NoSQL Workbench cria tabelas e índices com capacidade sob demanda. **Para confirmar o modelo de dados no DynamoDB** 1. Abra o NoSQL Workbench e, na tela principal, clique no nome do modelo que você deseja transferir. 1. Na barra superior, clique em **Confirmar**. 1. Escolha uma conexão existente ou crie uma conexão escolhendo a guia **Adicionar nova conexão**. + Para adicionar uma nova conexão, especifique as seguintes informações: + **Account Alias (Alias da conta** + **AWS Região da** + **Access key ID (ID da chave de acesso** + **Secret access key (Chave de acesso secreta** Para obter mais informações sobre como obter as chaves de acesso, consulte [Obter uma chave de acesso da AWS](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/SettingUp.DynamoWebService.html#SettingUp.DynamoWebService.GetCredentials). + Opcionalmente, você pode especificar o seguinte: + [https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html) + [https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-arns](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-arns) 1. Se você preferir usar o [DynamoDB local](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.html): 1. Escolha a guia **Conexão local**. 1. Clique no botão **Adicionar nova conexão**. 1. Especifique o **Connection name (Nome da conexão)** e a **Port (Porta)**. **nota** Para usar o DynamoDB local, é necessário ativá-lo usando o botão **DynamoDB local** no canto inferior esquerdo da tela do NoSQL Workbench. 1. Clique em **Confirmar**.