# NoSQL Workbench para DynamoDB
O NoSQL Workbench para Amazon DynamoDB é uma aplicação GUI multiplataforma do lado do cliente para operações e desenvolvimento de bancos de dados modernos. Ele está disponível para Windows, macOS e Linux. O NoSQL Workbench permite criar modelos de dados do DynamoDB, definir padrões de acesso como operações reais do DynamoDB e validá-los usando dados de amostra. Além disso, é possível organizar os modelos de dados dentro dos projetos. O NoSQL Workbench inclui o DynamoDB local, o que possibilita testar tabelas e índices antes de transferir seu modelo de dados para a nuvem. Para saber mais sobre o DynamoDB local e seus requisitos, consulte [Configurar o DynamoDB local (versão para download)](DynamoDBLocal.md).
**Modelador de dados**
Com o NoSQL Workbench para DynamoDB, é possível iniciar um novo projeto do zero ou usar um projeto de amostra que corresponda ao seu caso de uso. Em seguida, você pode criar tabelas e índices secundários globais, definir atributos e configurar dados de amostra. Também é possível visualizar os padrões de acesso como operações reais do DynamoDB (PutItem, UpdateItem, Query e outras) e executá-las nos dados de amostra configurados para validar se o padrão de acesso funciona conforme o esperado, fazendo ajustes no modelo de dados com base nos resultados da validação. Por fim, depois de validado, é necessário transferir o modelo para o DynamoDB local ou a sua conta da AWS para testes adicionais e uso na produção. Para colaboração, é possível importar e exportar os modelos de dados criados. Para obter mais informações, consulte [Criar modelos de dados com o NoSQL Workbench](workbench.Modeler.md).
**Criador de operações**
O NoSQL Workbench oferece uma avançada interface gráfica do usuário para você desenvolver e testar consultas. Você pode usar o *criador de operações* para visualizar, explorar e consultar conjuntos de dados dinâmicos. O criador de operações estruturadas é compatível com expressão de projeção e expressão de condição, além de gerar código de amostra em vários idiomas. Você pode clonar tabelas diretamente de uma conta do Amazon DynamoDB para outra em diferentes regiões. Também é possível clonar tabelas diretamente entre o DynamoDB local e uma conta do Amazon DynamoDB para uma cópia mais rápida do esquema de chaves da tabela (e, opcionalmente, do esquema e dos itens do GSI) entre seus ambientes de desenvolvimento. Para obter mais informações, consulte [Explorar conjuntos de dados e criar operações com o NoSQL Workbench](workbench.querybuilder.md).
O vídeo a seguir detalha conceitos de modelagem de dados com o NoSQL Workbench.
[](http://www.youtube.com/watch?v=https://www.youtube.com/embed/p5va6ZX9_o0?si=vqQuf6FjoBuK1phR)
**Topics**
+ [Baixar o NoSQL Workbench para DynamoDB](workbench.settingup.md)
+ [Criar modelos de dados com o NoSQL Workbench](workbench.Modeler.md)
+ [Explorar conjuntos de dados e criar operações com o NoSQL Workbench](workbench.querybuilder.md)
+ [Modelos de dados de amostra para o NoSQL Workbench](workbench.SampleModels.md)
+ [Histórico de versões do NoSQL Workbench](WorkbenchDocumentHistory.md)
# Baixar o NoSQL Workbench para DynamoDB
Siga estas instruções para baixar o NoSQL Workbench e o DynamoDB local para Amazon DynamoDB.
**Como baixar o NoSQL Workbench e o DynamoDB local**
+ Baixe a versão apropriada do NoSQL Workbench para seu sistema operacional.
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/amazondynamodb/latest/developerguide/workbench.settingup.html)
**nota**
O NoSQL Workbench inclui o DynamoDB local como parte opcional do processo de instalação.
O Ambiente de Execução Java (JRE) versão 17.x ou mais recente é necessário para executar o DynamoDB local.
**nota**
O NoSQL Workbench é compatível com Ubuntu 12.04, Fedora 21 e Debian 8 ou quaisquer versões mais recentes dessas distribuições do Linux.
Há dois programas de software obrigatórios para instalações do Ubuntu: `libfuse2` e `curl`.
A partir do Ubuntu 22.04, o libfuse2 não é mais instalado por padrão. Para resolver isso, execute `sudo add-apt-repository universe && sudo apt install libfuse2` para instalar a versão mais recente do Ubuntu.
Para cURL, execute `sudo apt update && sudo apt upgrade && sudo apt install curl`.
# 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**.
# Explorar conjuntos de dados e criar operações com o NoSQL Workbench
O NoSQL Workbench para Amazon DynamoDB oferece uma interface gráfica do usuário avançada para desenvolvimento e teste de consultas. Você pode usar o criador de operações no NoSQL Workbench para visualizar, explorar e consultar conjuntos de dados dinâmicos. O criador de operações estruturadas é compatível com expressão de projeção e expressão de condição, além de gerar código de amostra em vários idiomas. Você pode clonar tabelas diretamente de uma conta do Amazon DynamoDB para outra em diferentes regiões. Também é possível clonar tabelas diretamente entre o DynamoDB local e uma conta do Amazon DynamoDB para uma cópia mais rápida do esquema de chaves da tabela (e, opcionalmente, do esquema e dos itens do GSI) entre seus ambientes de desenvolvimento. Você pode salvar até 50 operações de dados do DynamoDB no criador de operações.
**Topics**
+ [Conectar-se a conjuntos de dados dinâmicos](workbench.querybuilder.connect.md)
+ [Criar operações complexas](workbench.querybuilder.operationbuilder.md)
+ [Clonar tabelas com NoSQL Workbench](workbench.querybuilder.cloning-tables.md)
+ [Exportar dados para um arquivo CSV](workbench.querybuilder.exportcsv.md)
# Conectar-se a conjuntos de dados dinâmicos
Para se conectar às suas tabelas do Amazon DynamoDB com o NoSQL Workbench, você deve primeiro se conectar à sua conta da AWS.
**Para adicionar uma conexão ao seu banco de dados**
1. No NoSQL Workbench, no painel de navegação no lado esquerdo, escolha o ícone **Operation builder** (Criador de operações).
1. Escolha **Add Connection** (Adicionar conexão).
1. Especifique as seguintes informações:
+ **Connection name (Nome da conexão**
+ **AWS Region** (Região da AWS)
+ **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:
+ [**Session token** (Token da sessão)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html)
+ [**IAM role ARN** (ARN do perfil do IAM)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html#identifiers-arns)
1. Selecione **Connect** (Conectar).
Se não quiser se cadastrar em uma conta de nível gratuito e preferir usar o [DynamoDB Local (versão disponível para download)](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.html):
1. Escolha a guia **Local** na tela de conexão.
1. Especifique as seguintes informações:
+ **Connection name** (Nome da conexão)
+ **Port** (Porta)
1. Selecione o botão **Connect** (Conectar).
**nota**
Para se conectar ao DynamoDB local, inicialize manualmente o DynamoDB local usando o terminal (consulte [Deploying DynamoDB local on your computer](DynamoDBLocal.DownloadingAndRunning.md)) ou inicialize o DynamoDB local diretamente usando a opção de DDB local no menu de navegação do NoSQL Workbench. Verifique se a porta de conexão é a mesma porta local do DynamoDB.
1. Na conexão criada, escolha **Open** (Abrir).
Após a conexão ao banco de dados do DynamoDB, a lista de tabelas disponíveis é exibida no painel esquerdo. Escolha uma das tabelas para retornar um exemplo dos dados armazenados na tabela.
Agora você pode executar consultas na tabela selecionada.
Para executar consultas em uma tabela, consulte a próxima seção sobre operações de criação. Consulte [Criar operações complexas](workbench.querybuilder.operationbuilder.md).
# Criar operações complexas
O criador de operações no NoSQL Workbench para Amazon DynamoDB oferece uma interface visual na qual você pode executar operações de plano de dados complexas. Ele inclui suporte para expressões de projeção e de condição. Depois de criar uma operação, você pode salvá-la para uso posterior (até 50 operações podem ser salvas). Em seguida, você pode procurar uma lista de suas operações de plano de dados usadas com frequência no menu **Saved Operations** (Operações salvas) e usá-los para preencher e criar automaticamente uma nova operação. Você também pode optar por gerar código de exemplo para essas operações, em várias linguagens.
O NoSQL Workbench é compatível com a criação de instruções [PartiQL](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.html) para DynamoDB, o que permite interagir com o DynamoDB usando uma linguagem de consultas compatível com SQL. O NoSQL Workbench também é compatível com a criação de operações de API CRUD do DynamoDB.
Para usar o NoSQL Workbench para criar operações, no painel de navegação no lado esquerdo, escolha o ícone **Operation builder** (Criador de operações).
**Topics**
+ [Criar instruções em PartiQL](workbench.querybuilder.partiql.md)
+ [Criar operações de API](workbench.querybuilder.operationbuilder.api.md)
# Criar instruções em PartiQL
Para usar o NoSQL Workbench para criar declarações do [PartiQL para DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.html), selecione **Editor PartiQL** no canto superior da interface de usuário do NoSQL Workbench.
É possível criar os tipos de instrução PartiQL a seguir no criador de operações.
**Topics**
+ [Instruções em Singleton](#workbench.querybuilder.partiql.single)
+ [Transações](#workbench.querybuilder.partiql.transaction)
+ [Batch](#workbench.querybuilder.partiql.batch)
## Instruções em Singleton
Para executar ou gerar código para uma instrução PartiQL, faça o seguinte:
1. Selecione **Editor PartiQL** próximo à parte superior da janela.
1. Insira uma [PartiQL statement](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.statements.html) (Instrução PartiQL) válida.
1. Se a sua instrução usar parâmetros:
1. Escolha **Optional request parameters** (Parâmetros de solicitação opcionais).
1. Escolha **Add new parameters** (Adicionar novos parâmetros).
1. Insira o tipo e o valor do atributo.
1. Para adicionar parâmetros extras, repita as etapas b e c.
1. Se desejar gerar código, escolha **Generate code** (Gerar código).
Selecione a linguagem desejada nas guias exibidas. Agora você pode copiar esse código e usá-lo na sua aplicação.
1. Se desejar que a operação seja executada imediatamente, escolha **Run** (Executar).
1. Se desejar salvar esta operação para uso posterior, escolha **Save operation** (Salvar operação). Depois, insira um nome para sua operação e escolha **Save** (Salvar).
## Transações
Para executar ou gerar código para uma transação do PartiQL, faça o seguinte:
1. Selecione **PartiQLTransaction** no menu suspenso **Mais operações**.
1. Escolha **Add a new statement** (Adicionar uma nova instrução).
1. Insira uma [PartiQL statement](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.statements.html) (Instrução PartiQL) válida.
**nota**
Não há suporte a operações de leitura e gravação na mesma solicitação de transação PartiQL. Uma instrução SELECT não pode estar presente na mesma solicitação que instruções INSERT, UPDATE e DELETE. Consulte [Executar transações com PartiQL para DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.multiplestatements.transactions.html) para obter mais detalhes.
1. Se a sua instrução usar parâmetros
1. Escolha **Optional request parameters** (Parâmetros de solicitação opcionais).
1. Escolha **Add new parameters** (Adicionar novos parâmetros).
1. Insira o tipo e o valor do atributo.
1. Para adicionar parâmetros extras, repita as etapas b e c.
1. Para adicionar mais instruções, repita as etapas 2 a 4.
1. Se desejar gerar código, escolha **Generate code** (Gerar código).
Selecione a linguagem desejada nas guias exibidas. Agora você pode copiar esse código e usá-lo na sua aplicação.
1. Se desejar que a operação seja executada imediatamente, escolha **Run** (Executar).
1. Se desejar salvar esta operação para uso posterior, escolha **Save operation** (Salvar operação). Depois, insira um nome para sua operação e escolha **Save** (Salvar).
## Batch
Para executar ou gerar código para um lote de PartiQL, faça o seguinte:
1. Selecione **PartiQLBatch** no menu suspenso **Mais operações**.
1. Escolha **Add a new statement** (Adicionar uma nova instrução).
1. Insira uma [PartiQL statement](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.statements.html) (Instrução PartiQL) válida.
**nota**
Não há suporte a operações de leitura e gravação na mesma solicitação de lote de PartiQL, o que significa que uma instrução SELECT não pode estar na mesma solicitação que instruções INSERT, UPDATE e DELETE. Operações de gravação no mesmo item não são permitidas. Assim como na operação BatchGetItem, apenas operações de leitura singleton são aceitas. Operações de verificação e consulta não são aceitas. Consulte [Executar operações em lote com PartiQL para DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.multiplestatements.batching.html) para obter mais detalhes.
1. Se a sua instrução usar parâmetros:
1. Escolha **Optional request parameters** (Parâmetros de solicitação opcionais).
1. Escolha **Add new parameters** (Adicionar novos parâmetros).
1. Insira o tipo e o valor do atributo.
1. Para adicionar parâmetros extras, repita as etapas b e c.
1. Para adicionar mais instruções, repita as etapas 2 a 4.
1. Se desejar gerar código, escolha **Generate code** (Gerar código).
Selecione a linguagem desejada nas guias exibidas. Agora você pode copiar esse código e usá-lo na sua aplicação.
1. Se desejar que a operação seja executada imediatamente, escolha **Run** (Executar).
1. Se desejar salvar esta operação para uso posterior, escolha **Save operation** (Salvar operação). Depois, insira um nome para sua operação e escolha **Save** (Salvar).
# Criar operações de API
Para usar o NoSQL Workbench para criar APIs CRUD do DynamoDB, selecione **Criador de operações** à esquerda da interface de usuário do NoSQL Workbench.
Depois, selecione **Abrir** e escolha uma conexão.
Você pode executar as operações a seguir no criador de operações.
+ [Excluir tabela](#workbench.querybuilder.operationbuilder.DeleteTable)
+ [Criar tabela](#workbench.querybuilder.operationbuilder.CreateTable)
+ [Atualizar tabela](#workbench.querybuilder.operationbuilder.UpdateTable)
+ [Colocar item](#workbench.querybuilder.operationbuilder.Put)
+ [Atualizar item](#workbench.querybuilder.operationbuilder.update)
+ [Excluir item](#workbench.querybuilder.operationbuilder.Delete)
+ [Query](#workbench.querybuilder.operationbuilder.Query)
+ [Verificar](#workbench.querybuilder.operationbuilder.scan)
+ [Transação Obter itens](#workbench.querybuilder.operationbuilder.transactget)
+ [Transação Gravar itens](#workbench.querybuilder.operationbuilder.transactwrite)
## Excluir tabela
Para executar uma operação `Delete Table`, faça o seguinte:
1. Encontre a tabela que você deseja excluir na seção **Tabelas**.
1. Selecione **Excluir tabela** no menu de reticências horizontais.
1. Confirme se você deseja excluir a tabela inserindo o **Nome da tabela**.
1. Selecione **Excluir**.
Para obter mais informações essa operação, consulte [Delete table](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteTable.html) (Excluir tabela) na *Amazon DynamoDB API Reference* (Referência da API do Amazon DynamoDB).
## Excluir o GSI
Para executar uma operação `Delete GSI`, faça o seguinte:
1. Encontre o GSI de uma tabela que você deseja excluir na seção **Tabelas**.
1. Selecione **Excluir GSI** no menu de reticências horizontal.
1. Confirme se você deseja excluir o GSI inserindo o **Nome do GSI**.
1. Selecione **Excluir**.
Para obter mais informações essa operação, consulte [Delete table](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteTable.html) (Excluir tabela) na *Amazon DynamoDB API Reference* (Referência da API do Amazon DynamoDB).
## Create table
Para executar uma operação `Create Table`, faça o seguinte:
1. Selecione o ícone **\$1** ao lado da seção **Tabelas**.
1. Insira o nome da tabela desejado.
1. Crie uma chave de partição.
1. Opcional: crie uma chave de classificação.
1. Para personalizar as configurações de capacidade, desmarque a caixa ao lado de **Usar configurações de capacidade padrão**.
+ Agora é possível selecionar **Provisioned** (Provisionada) ou **On-demand capacity** (Capacidade sob demanda).
Com a opção Provisionada selecionada, você pode definir unidades de capacidade mínima e máxima de leitura e gravação. Você também pode habilitar ou desabilitar a escalabilidade automática.
+ Se, no momento, a tabela estiver definida como sob demanda, você não poderá especificar um throughput provisionado.
+ Se você mudar de sob demanda para throughput provisionado, o ajuste de escala automático será aplicado automaticamente a todos os GSIs com: mín.: 1, máx.: 10; meta: 70%.
1. Selecione **Ignorar GSIs e criar** para criar essa tabela sem um GSI. Você também pode selecionar **Próximo** para criar um GSI com essa nova tabela.
Para obter mais informações sobre essa operação, consulte [Create table](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_CreateTable.html) (Criar tabela) na *Amazon DynamoDB API Reference* (Referência da API do Amazon DynamoDB).
## Criar o GSI
Para executar uma operação `Create GSI`, faça o seguinte:
1. Encontre uma tabela à qual você deseja adicionar um GSI.
1. No menu de reticências horizontal, selecione **Criar GSI**.
1. Nomeie o GSI em **Nome do índice**.
1. Crie uma chave de partição.
1. Opcional: crie uma chave de classificação.
1. Selecione uma opção de tipo de projeção no menu suspenso.
1. Selecione **Criar GSI**.
Para obter mais informações sobre essa operação, consulte [Create table](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_CreateTable.html) (Criar tabela) na *Amazon DynamoDB API Reference* (Referência da API do Amazon DynamoDB).
## Atualizar tabela
Para atualizar as configurações de capacidade de uma tabela com uma operação `Update Table`, faça o seguinte:
1. Encontre a tabela para a qual você deseja atualizar as configurações de capacidade.
1. No menu de reticências horizontal, selecione **Atualizar configurações de capacidade**.
1. Selecione **Provisionada** ou **Capacidade sob demanda**.
Com a opção **Provisionada** selecionada, você pode definir unidades de capacidade mínima e máxima de leitura e gravação. Você também pode habilitar ou desabilitar a escalabilidade automática.
1. Selecione **Atualizar**.
Para obter mais informações sobre essa operação, consulte [Atualizar tabela](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateTable.html) na *Amazon DynamoDB API Reference* (Referência da API do Amazon DynamoDB).
## Atualizar o GSI
Para atualizar as configurações de capacidade de um GSI com uma operação `Update Table`, faça o seguinte:
**nota**
Por padrão, os índices secundários globais herdam as configurações de capacidade da tabela de base. Os índices secundários globais podem ter um modo de capacidade diferente somente quando a tabela básica está no modo de capacidade provisionada. Ao criar um índice secundário global em uma tabela de modo provisionado, você deve especificar unidades de capacidade de leitura e gravação para a workload esperada no índice. Para obter mais informações, consulte [Considerações sobre throughput provisionado para índices secundários globais](GSI.md#GSI.ThroughputConsiderations).
1. Encontre o GSI cujas configurações de capacidade você deseja atualizar.
1. No menu de reticências horizontal, selecione **Atualizar configurações de capacidade**.
1. Agora é possível selecionar **Provisioned** (Provisionada) ou **On-demand capacity** (Capacidade sob demanda).
Com a opção **Provisionada** selecionada, você pode definir unidades de capacidade mínima e máxima de leitura e gravação. Você também pode habilitar ou desabilitar a escalabilidade automática.
1. Selecione **Atualizar**.
Para obter mais informações sobre essa operação, consulte [Atualizar tabela](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateTable.html) na *Amazon DynamoDB API Reference* (Referência da API do Amazon DynamoDB).
## Colocar item
Você pode criar um item usando a operação `Put Item`. Para executar ou gerar código para uma operação `Put Item`, faça o seguinte:
1. Encontre a tabela na qual você deseja criar um item.
1. No menu suspenso **Ações**, selecione **Criar item**.
1. Insira o valor da chave de partição.
1. Insira o valor da chave de classificação, se houver.
1. Se desejar adicionar atributos que não sejam de chave, faça o seguinte:
1. Selecione **\$1 Adicionar outros atributos**.
1. Especifique o **Attribute name** (Nome do atributo), o **Type** (Tipo) e o **Value** (Valor).
1. Se for necessário cumprir a expressão de condição para que a operação `Put Item` tenha êxito, faça o seguinte:
1. Escolha **Condition** (Condição).
1. Especifique o nome do atributo, o operador de comparação, o tipo de atributo e o valor do atributo.
1. Se outras condições forem necessárias, escolha **Condition** (Condição) novamente.
Para obter mais informações, consulte [Exemplo de expressão de condição do DynamoDB na CLI](Expressions.ConditionExpressions.md).
1. Se desejar gerar código, escolha **Generate code** (Gerar código).
Selecione a linguagem desejada nas guias exibidas. Agora você pode copiar esse código e usá-lo na sua aplicação.
1. Se desejar que a operação seja executada imediatamente, escolha **Run** (Executar).
1. Se desejar salvar esta operação para uso posterior, escolha **Save operation** (Salvar operação). Em seguida, insira um nome para a operação e clique em **Save** (Salvar).
Para obter mais informações sobre essa operação, consulte [PutItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_PutItem.html) na *Referência da API do Amazon DynamoDB*.
## Atualizar item
Para executar ou gerar código para uma operação `Update Item`, faça o seguinte:
1. Encontre a tabela na qual você deseja atualizar um item.
1. Selecione o item.
1. Insira o nome e o valor do atributo para a expressão selecionada.
1. Se desejar adicionar mais expressões, escolha outra expressão na lista suspensa **Atualizar expressão** e selecione o ícone **\$1**.
1. Se for necessário cumprir a expressão de condição para que a operação `Update Item` tenha êxito, faça o seguinte:
1. Escolha **Condition** (Condição).
1. Especifique o nome do atributo, o operador de comparação, o tipo de atributo e o valor do atributo.
1. Se outras condições forem necessárias, escolha **Condition** (Condição) novamente.
Para obter mais informações, consulte [Exemplo de expressão de condição do DynamoDB na CLI](Expressions.ConditionExpressions.md).
1. Se desejar gerar código, escolha **Generate code** (Gerar código).
Escolha a guia da linguagem desejada. Agora você pode copiar esse código e usá-lo na sua aplicação.
1. Se desejar que a operação seja executada imediatamente, escolha **Run** (Executar).
1. Se desejar salvar esta operação para uso posterior, escolha **Save operation** (Salvar operação). Em seguida, insira um nome para a operação e clique em **Save** (Salvar).
Para obter mais informações sobre essa operação, consulte [UpdateItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateItem.html) na *Referência da API do Amazon DynamoDB*.
## Excluir item
Para executar uma operação `Delete Item`, faça o seguinte:
1. Encontre a tabela na qual você deseja excluir um item.
1. Selecione o item.
1. No menu suspenso **Ações**, selecione **Excluir item**.
1. Confirme se você deseja excluir o item selecionando **Excluir**.
Para obter mais informações sobre essa operação, consulte [DeleteItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteItem.html) na *Referência da API do Amazon DynamoDB*.
## Duplicar item
É possível duplicar um item criando um item com os mesmos atributos. Para duplicar um item, faça o seguinte:
1. Encontre a tabela na qual você deseja duplicar um item.
1. Selecione o item.
1. No menu suspenso **Ações**, selecione **Duplicar item**.
1. Especifique uma nova chave de partição.
1. Especifique uma nova chave de classificação (se necessário).
1. Selecione **Executar**.
Para obter mais informações sobre essa operação, consulte [DeleteItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteItem.html) na *Referência da API do Amazon DynamoDB*.
## Consulta
Para executar ou gerar código para uma operação `Query`, faça o seguinte:
1. Selecione **Consultar** na parte superior da interface de usuário do NoSQL Workbench.
1. Especifique o valor da chave de partição.
1. Se uma chave de classificação for necessária para a operação `Query`:
1. Selecione **Sort key** (Chave de classificação).
1. Especifique o operador de comparação e o valor do atributo.
1. Selecione **Consultar** para realizar essa operação de consulta. Se forem necessárias mais opções, marque a caixa de seleção **Mais opções** e continue com as etapas a seguir.
1. Se nem todos os atributos precisarem ser retornados com o resultado da operação, selecione **Projection expression** (Expressão de projeção).
1. Escolha o ícone **\$1**.
1. Insira o atributo a ser retornado com o resultado da consulta.
1. Se mais atributos forem necessários, escolha o **\$1 **.
1. Se for necessário cumprir a expressão de condição para que a operação `Query` tenha êxito, faça o seguinte:
1. Escolha **Condition** (Condição).
1. Especifique o nome do atributo, o operador de comparação, o tipo de atributo e o valor do atributo.
1. Se outras condições forem necessárias, escolha **Condition** (Condição) novamente.
Para obter mais informações, consulte [Exemplo de expressão de condição do DynamoDB na CLI](Expressions.ConditionExpressions.md).
1. Se desejar gerar código, escolha **Generate code** (Gerar código).
Escolha a guia da linguagem desejada. Agora você pode copiar esse código e usá-lo na sua aplicação.
1. Se desejar que a operação seja executada imediatamente, escolha **Run** (Executar).
1. Se desejar salvar esta operação para uso posterior, escolha **Save operation** (Salvar operação). Em seguida, insira um nome para a operação e clique em **Save** (Salvar).
Para obter mais informações sobre essa operação, consulte [Query](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_Query.html) na *Referência da API do Amazon DynamoDB*.
## Verificar
Para executar ou gerar código para uma operação `Scan`, faça o seguinte:
1. Selecione **Verificar** na parte superior da interface de usuário do NoSQL Workbench.
1. Selecione o botão **Verificar** para realizar essa operação básica de verificação. Se forem necessárias mais opções, marque a caixa de seleção **Mais opções** e continue com as etapas a seguir.
1. Especifique um nome de atributo para filtrar os resultados da verificação.
1. Se nem todos os atributos precisarem ser retornados com o resultado da operação, selecione **Projection expression** (Expressão de projeção).
1. Se a expressão de condição precisar ser satisfeita para a operação scan ser bem-sucedida, faça o seguinte:
1. Escolha **Condition** (Condição).
1. Especifique o nome do atributo, o operador de comparação, o tipo de atributo e o valor do atributo.
1. Se outras condições forem necessárias, escolha **Condition** (Condição) novamente.
Para obter mais informações, consulte [Exemplo de expressão de condição do DynamoDB na CLI](Expressions.ConditionExpressions.md).
1. Se desejar gerar código, escolha **Generate code** (Gerar código).
Escolha a guia da linguagem desejada. Agora você pode copiar esse código e usá-lo na sua aplicação.
1. Se desejar que a operação seja executada imediatamente, escolha **Run** (Executar).
1. Se desejar salvar esta operação para uso posterior, escolha **Save operation** (Salvar operação). Em seguida, insira um nome para a operação e clique em **Save** (Salvar).
## TransactGetItems
Para executar ou gerar código para uma operação `TransactGetItems`, faça o seguinte:
1. No menu suspenso **Mais operações** na parte superior da interface de usuário do NoSQL Workbench, selecione **TransactGetItems**.
1. Selecione o ícone **\$1** ao lado de **TransactGetItem**.
1. Especifique uma chave de partição.
1. Especifique uma chave de classificação (se necessário).
1. Selecione **Executar** para realizar a operação, **Salvar operação** para salvá-la ou **Gerar código** para gerar código para ela.
Para obter mais informações, consulte [Amazon DynamoDB Transactions](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/transactions.html).
## TransactWriteItems
Para executar ou gerar código para uma operação `TransactWriteItems`, faça o seguinte:
1. No menu suspenso **Mais operações** na parte superior da interface de usuário do NoSQL Workbench, selecione **TransactWriteItems**.
1. Selecione uma operação no menu suspenso **Ações**.
1. Selecione o ícone **\$1** ao lado de **TransactWriteItem**.
1. Na lista suspensa **Ações**, selecione a operação desejada.
+ Para `DeleteItem`, siga as instruções para a operação [Excluir item](#workbench.querybuilder.operationbuilder.Delete).
+ Para `PutItem`, siga as instruções para a operação [Colocar item](#workbench.querybuilder.operationbuilder.Put).
+ Para `UpdateItem`, siga as instruções para a operação [Atualizar item](#workbench.querybuilder.operationbuilder.update).
Para alterar a ordem das ações, escolha uma ação na lista à esquerda e selecione as setas para cima ou para baixo para movê-la para cima ou para baixo na lista.
Para excluir uma ação, escolha a ação na lista e selecione o ícone **Delete** (Excluir) (lixeira).
1. Selecione **Executar** para realizar a operação, **Salvar operação** para salvá-la ou **Gerar código** para gerar código para ela.
Para obter mais informações, consulte [Amazon DynamoDB Transactions](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/transactions.html).
# Clonar tabelas com NoSQL Workbench
A clonagem de tabelas copiará o esquema de chaves de uma tabela (e, opcionalmente, o esquema e os itens do GSI) entre seus ambientes de desenvolvimento. Você pode clonar uma tabela entre o DynamoDB local e uma conta do Amazon DynamoDB, e até mesmo clonar uma tabela de uma conta para outra em diferentes regiões a fim de acelerar a experimentação.
**Como clonar uma tabela**
1. Em **Criador de operações**, selecione sua conexão e região (a seleção da região não está disponível para o DynamoDB local).
1. Depois de se conectar ao DynamoDB, navegue pelas tabelas e selecione a que deseja clonar.
1. No menu de reticências horizontal, selecione a opção **Clonar**.
1. Insira os detalhes de destino do clone:
1. Selecione uma conexão.
1. Selecione uma região (a seleção da região não está disponível para o DynamoDB local).
1. Insira um novo nome de tabela.
1. Selecione uma opção de clonagem:
1. A opção **Esquema de chaves** é selecionada por padrão e não pode ser desmarcada. Por padrão, a clonagem de uma tabela copiará a chave primária e a chave de classificação, se estiverem disponíveis.
1. A opção **Esquema do GSI** será selecionada por padrão se a tabela a ser clonada tiver um GSI. A clonagem de uma tabela copiará a chave primária e a chave de classificação do GSI, se estiverem disponíveis. Você tem a opção de desmarcar a opção Esquema do GSI para pular a clonagem do esquema do GSI. A clonagem de uma tabela copiará as configurações de capacidade da tabela base como as configurações de capacidade do GSI. Você pode usar a operação `UpdateTable` no criador de operações para atualizar a configuração de capacidade do GSI da tabela após a conclusão da clonagem.
1. Insira o número de itens a serem clonados. Para clonar somente o esquema de chaves e, opcionalmente, o esquema do GSI, você pode manter o valor de **Itens a serem clonados** em 0. O número máximo de itens que podem ser clonados é 5.000.
1. Escolha um modo de capacidade:
1. A opção **Modo sob demanda** está selecionada por padrão. O DynamoDB sob demanda oferece definição de preço “pagamento por solicitação” para solicitações de leitura e gravação, para que você pague apenas pelo o que usar. Para saber mais, consulte [DynamoDB On-demand mode](capacity-mode.md#capacity-mode-on-demand).
1. A opção **Modo provisionado** permite especificar o número de leituras e gravações por segundo que você precisa para a aplicação. Você pode usar Auto Scaling para ajustar a capacidade provisionada da tabela automaticamente em resposta às alterações de tráfego. Para saber mais, consulte [DynamoDB Provisioned mode](provisioned-capacity-mode.md).
1. Selecione **Clonar** para começar a clonagem.
1. O processo de clonagem será executado em segundo plano. A guia **Criador de operações** mostrará uma notificação quando houver uma alteração no status da tabela de clonagem. Você pode acessar esse status selecionando a guia **Criador de operações** e o botão de seta. O botão de seta está localizado no widget de status da tabela de clonagem, localizado na parte inferior da barra lateral de menu.
# Exportar dados para um arquivo CSV
Você pode exportar os resultados de uma consulta do Operation Builder para um arquivo CSV. Isso permite que você carregue os dados em uma planilha ou os processe usando a linguagem de programação que preferir.
**Exportar para CSV**
1. No Operation Builder, execute uma operação à sua escolha, como uma varredura ou uma consulta.
**nota**
Só é possível exportar os resultados de operações da API de leitura e instruções PartiQL para um arquivo CSV. Não é possível exportar os resultados de instruções de leitura de transações.
No momento, você pode exportar uma página de resultados por vez para um arquivo CSV. Se houver várias páginas de resultados, você deverá exportar cada página individualmente.
1. Selecione os itens que você deseja exportar dos resultados.
1. No menu suspenso **Ações**, selecione **Exportar como CSV**.
1. Escolha um nome de arquivo e um local para o arquivo CSV e selecione **Save** (Salvar).
# Modelos de dados de amostra para o NoSQL Workbench
A página inicial do modelador exibe uma série de modelos de exemplo fornecidos com o NoSQL Workbench. Esta seção descreve esses modelos e seus usos potenciais.
**Topics**
+ [Modelo de dados de funcionários](#workbench.SampleModels.EmployeeDataModel)
+ [Modelo de dados de fórum de discussão](#workbench.SampleModels.DiscussionForumDataModel)
+ [Modelo de dados de biblioteca de música](#workbench.SampleModels.MusicLibraryDataModel)
+ [Modelo de dados de estação de esqui](#workbench.SampleModels.SkiResortDataModel)
+ [Modelo de dados de ofertas de cartão de crédito](#workbench.SampleModels.CreditCardOffersDataModel)
+ [Modelo de dados de favoritos](#workbench.SampleModels.BookmarksDataModel)
## Modelo de dados de funcionários
Este modelo de dados é um modelo introdutório. Ele representa os detalhes básicos de um funcionário, como um alias exclusivo, nome, sobrenome, designação, gerente e habilidades.
Este modelo de dados descreve algumas técnicas, como lidar com atributos complexos, por exemplo, ter mais de uma habilidade. Esse modelo também é um exemplo de relação de um para muitos entre o gerente e seus funcionários subordinados, alcançado pelo índice secundário DirectReports.
Os padrões de acesso facilitados por este modelo de dados são:
+ Recuperação de um registro de funcionário usando o alias de login do funcionário, facilitada por uma tabela chamada `Employee`.
+ Pesquisa de funcionários por nome, facilitada pelo índice secundário global da tabela Employee (Funcionários) chamado `Name`.
+ Recuperação de todos os relatórios diretos de um gerente usando o alias de login do gerente, facilitada pelo índice secundário global da tabela Employee (Funcionários) chamado `DirectReports`.
## Modelo de dados de fórum de discussão
Este modelo de dados representa fóruns de discussão. Usando este modelo, os clientes podem se envolver com a comunidade de desenvolvedores, fazer perguntas e responder às postagens de outros clientes. Cada serviço da AWS tem um fórum dedicado. Qualquer um pode iniciar um novo tópico de discussão postando uma mensagem em um fórum, e cada assunto de tópico recebe um número de respostas.
Os padrões de acesso facilitados por este modelo de dados são:
+ Recuperação de um registro de fórum usando o nome do fórum, facilitada por uma tabela chamada `Forum`.
+ Recuperação de um thread específico ou de todos os threads de um fórum, facilitada por uma tabela chamada `Thread`.
+ Pesquisa de respostas usando o endereço de e-mail do usuário de publicação, facilitada pelo índice secundário global da tabela Reply (Responder) chamado `PostedBy-Message-Index`.
## Modelo de dados de biblioteca de música
Este modelo de dados representa uma biblioteca de músicas que tem uma grande coleção de músicas e mostra as mais baixadas quase em tempo real.
Os padrões de acesso facilitados por este modelo de dados são:
+ Recuperação de um registro de música, facilitada por uma tabela chamada `Songs`.
+ Recuperação de um registro de download específico ou de todos os registros de download de uma música, facilitada por uma tabela chamada `Songs`.
+ Recuperação de um registro de número de downloads mensais ou de todos os registros de download mensais de uma música, facilitada por uma tabela chamada `Song`.
+ Recuperação de todos os registros (incluindo gravação de músicas, registros de download e registros de contagem de downloads mensais) de uma música, facilitada por uma tabela chamada `Songs`.
+ Pesquisa das músicas mais baixadas, facilitada pelo índice secundário global da tabela Músicas chamado `DownloadsByMonth`.
## Modelo de dados de estação de esqui
Este modelo de dados representa uma estância de esqui que tem uma grande coleção de dados para cada subida mecânica recolhidos diariamente.
Os padrões de acesso facilitados por este modelo de dados são:
+ Recuperação de todos os dados para um determinado teleférico ou o resort em geral, dinâmicos e estáticos, facilitado por uma tabela chamada `SkiLifts`.
+ Recuperação de todos os dados dinâmicos (incluindo usuários do teleférico, cobertura de neve, perigo de avalanche e status do teleférico) para um teleférico ou o resort em geral em uma data específica, facilitada por uma tabela chamada `SkiLifts`.
+ Recuperação de todos os dados estáticos (incluindo se o teleférico for apenas para esquiadores experientes, altura na subida do teleférico e tempo de subida do teleférico) para um teleférico específico, facilitada por uma tabela chamada `SkiLifts`.
+ Recuperação da data dos dados registrados para uma subida mecânica específica ou a instância geral classificada pelo total de esquiadores únicos, facilitada pelo índice secundário global da tabela SkiLifts, chamado `SkiLiftsByRiders`.
## Modelo de dados de ofertas de cartão de crédito
Este modelo de dados é utilizado por uma aplicação de ofertas de cartão de crédito.
Um provedor de cartão de crédito produz ofertas ao longo do tempo. Essas ofertas incluem transferências de saldo sem taxas, aumento do limite de crédito, redução das taxas de juros, reembolso e milhas aéreas. Depois que um cliente aceita ou recusa essas ofertas, o respectivo status da oferta é atualizado de forma correspondente.
Os padrões de acesso facilitados por este modelo de dados são:
+ Recuperação de registros de conta usando `AccountId`, facilitada pela tabela principal.
+ Recuperação de todas as contas com poucos itens projetados, facilitada pelo índice secundário `AccountIndex`.
+ Recuperação de contas e todos os registros de oferta associados a essas contas usando `AccountId`, facilitada pela tabela principal.
+ Recuperação de contas e registros de ofertas específicas associados a essas contas usando `AccountId` e `OfferId`, facilitada pela tabela principal.
+ Recuperação de todos os registros de oferta `ACCEPTED/DECLINED` do `OfferType` específico associado a contas usando `AccountId`, `OfferType` e`Status`, conforme facilitada pelo índice secundário `GSI1`.
+ Recuperação de ofertas e registros de itens de oferta associados usando `OfferId`, facilitada pela tabela principal.
## Modelo de dados de favoritos
Este modelo de dados é usado para armazenar favoritos para os clientes.
Um cliente pode ter vários favoritos e um favorito pode pertencer a vários clientes. Este modelo de dados representa uma relação do tipo “muitos para muitos”.
Os padrões de acesso facilitados por este modelo de dados são:
+ Agora, uma única consulta com o `customerId` pode retornar dados do cliente e dos favoritos.
+ Um índice `ByEmail` da consulta retorna os dados do cliente por endereço de e-mail. Observe que os marcadores não são recuperados por esse índice.
+ Um índice de consulta `ByUrl` obtém dados de favoritos por URL. Observe que customerId é a chave de classificação para o índice porque o mesmo URL pode ser adicionado aos favoritos por vários clientes.
+ Um índice `ByCustomerFolder` da consulta obtém marcadores por pasta para cada cliente.
# Histórico de versões do NoSQL Workbench
A tabela a seguir descreve as alterações importantes em cada versão da ferramenta do cliente do *NoSQL Workbench*.
****
| Versão | Alteração | Descrição | Data |
| --- | --- | --- | --- |
| 3.20.0 | Novo Data Modeler for DynamoDB | O Data Modeler for DynamoDB oferece uma experiência de usuário atualizada. O Data Modeler for DynamoDB agora permite usar padrões de acesso. | 16 de fevereiro de 2026 |
| 3.13.5 | O modo de capacidade para as configurações de tabela padrão agora é sob demanda | Quando você cria uma tabela com configurações padrão, o DynamoDB cria uma tabela que usa o modo de capacidade sob demanda em vez do modo de capacidade provisionada. | 24 de fevereiro de 2025 |
| 3.13.0 | Melhorias no criador de operações do NoSQL Workbench | O NoSQL Workbench agora inclui suporte nativo para o modo escuro. Operações aprimoradas de tabelas e de itens no criador de operações. As informações de solicitações do criador de operações e de resultados de itens estão disponíveis no formato JSON. | 24 de abril de 2024 |
| 3.12.0 | Clonar tabelas com o NoSQL Workbench e exibir a capacidade consumida | Agora é possível clonar tabelas entre o DynamoDB local e uma conta de serviço web do DynamoDB ou entre contas de serviço web do DynamoDB para acelerar as iterações de desenvolvimento. Visualize a RCU ou a WCU consumida após a execução de uma operação usando o Operations Builder. Corrigimos o problema de substituição de dados ao importar de um arquivo CSV. | 26 de fevereiro de 2024 |
| 3.11.0 | Aprimoramentos do DynamoDB local | Agora você pode especificar a porta ao iniciar a instância integrada do DynamoDB local. O NoSQL Workbench agora pode ser instalado no Windows sem direitos de administrador. Atualizamos os modelos de dados. | 17 de janeiro de 2024 |
| 3.10.0 | Suporte nativo para o chip da Apple | O NoSQL Workbench agora inclui suporte nativo para Mac com chip da Apple. Agora você pode configurar o formato de geração de dados de amostra para atributos do tipo `Number`. | 5 de dezembro de 2023 |
| 3.9.0 | Melhorias no modelador de dados | O Visualizador agora aceita a confirmação de modelos de dados no DynamoDB local com a opção de sobrescrever tabelas existentes. | 3 de novembro de 2022 |
| 3.8.0 | Geração de dados de amostra | O NoSQL Workbench agora comporta a geração de dados de amostra para os modelos de dados do DynamoDB. | 25 de setembro de 2023 |
| 3.6.0 | Melhorias no criador de operações | Melhorias no gerenciamento de conexões no criador de operações. Os nomes de atributos no modelador de dados agora podem ser alterados sem excluir dados. Outras correções de erros. | 11 de abril de 2023 |
| 3.5.0 | Suporte para novas regiões da AWS | O NoSQL Workbench agora é compatível com as regiões ap-south-2, ap-southeast-3, ap-southeast-4, eu-central-2, eu-south-2, me-central-1 e me-west-1. | 23 de fevereiro de 2023 |
| 3.4.0 | Suporte ao DynamoDB local | O NoSQL Workbench agora comporta a instalação do DynamoDB local como parte do processo de instalação. | 6 de dezembro de 2022 |
| 3.3.0 | Suporte para operações do ambiente de gerenciamento | O Operation Builder agora é compatível com operações do ambiente de gerenciamento. | 1º de junho de 2022 |
| 3.2.0 | Importação e exportação de arquivo CSV | Agora você pode importar dados de amostra de um arquivo CSV na ferramenta Visualizer e também exportar os resultados de uma consulta do Operation Builder para um arquivo CSV. | 11 de outubro de 2021 |
| 3.1.0 | Salvar operações | O Criador de operações no NoSQL Workbench agora oferece suporte a operações de salvar para uso posterior. | 12 de julho de 2021 |
| 3.0.0 | Configurações de capacidade e importação/exportação do CloudFormation | O NoSQL Workbench for Amazon DynamoDB agora oferece suporte à especificação de um modo de capacidade de leitura/gravação para tabelas e pode importar e exportar modelos de dados no formato CloudFormation. | 21 de abril de 2021 |
| 2.2.0 | Suporte a PartiQL | O NoSQL Workbench para Amazon DynamoDB adiciona suporte à criação de instruções PartiQL para DynamoDB. | 4 de dezembro de 2020 |
| 1.1.0 | Suporte a Linux. | O NoSQL Workbench para Amazon DynamoDB oferece suporte às distribuições Ubuntu, Fedora e Debian do Linux. | 4 de maio de 2020 |
| 1.0.0 | NoSQL Workbench para Amazon DynamoDB – GA. | NoSQL Workbench para Amazon DynamoDB geralmente está disponível. | 2 de março de 2020 |
| 0.4.1 | Suporte para funções do IAM e credenciais de segurança temporárias. | O NoSQL Workbench para Amazon DynamoDB adiciona suporte para funções e credenciais de segurança temporárias do AWS Identity and Access Management (IAM). | 19 de dezembro de 2019 |
| 0.3.1 | Suporte para o [DynamoDB local (versão disponível para download)](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.html). | Agora o NoSQL Workbench comporta a conexão com o [DynamoDB local (versão para download)](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DynamoDBLocal.html) para desenvolver, criar, consultar e gerenciar tabelas do DynamoDB. | 8 de novembro de 2019 |
| 0.2.1 | A demonstração do NoSQL Workbench foi lançada. | Essa é a versão inicial do NoSQL Workbench for DynamoDB. Use o NoSQL Workbench para projetar, criar, consultar e gerenciar tabelas do DynamoDB. | 16 de setembro de 2019 |