# Executar os exemplos de código neste Guia do desenvolvedor
Os AWS SDKs fornecem um amplo suporte ao Amazon DynamoDB nas seguintes linguagens:
+ [ Java](https://aws.amazon.com/sdk-for-java)
+ [JavaScript no navegador](https://aws.amazon.com/sdk-for-browser)
+ [.NET](https://aws.amazon.com/sdk-for-net)
+ [Node.js](https://aws.amazon.com/sdk-for-node-js)
+ [PHP](https://aws.amazon.com/sdk-for-php)
+ [Python](https://aws.amazon.com/sdk-for-python)
+ [Ruby](https://aws.amazon.com/sdk-for-ruby)
+ [C\$1\$1](https://aws.amazon.com/sdk-for-cpp)
+ [Go](https://aws.amazon.com/sdk-for-go)
+ [Android](https://aws.amazon.com/mobile/sdk/)
+ [iOS](https://aws.amazon.com/mobile/sdk/)
Os exemplos de código neste guia do desenvolvedor fornecem uma cobertura mais detalhada das operações do DynamoDB usando as seguintes linguagens de programação:
+ [Exemplos de código Java](CodeSamples.Java.md)
+ [Exemplos de código .NET](CodeSamples.DotNet.md)
Antes de iniciar este exercício, será necessário criar uma conta da AWS, obter a chave de acesso e a chave secreta e configurar a AWS Command Line Interface (AWS CLI) no seu computador. Para obter mais informações, consulte [Configurar o DynamoDB (serviço da Web)](SettingUp.DynamoWebService.md).
**nota**
Se estiver usando a versão para download do DynamoDB, você precisará usar a AWS CLI para criar as tabelas e os dados de exemplo. Também precisará especificar o parâmetro `--endpoint-url` com cada comando da AWS CLI. Para obter mais informações, consulte [Definir o endpoint local](DynamoDBLocal.UsageNotes.md#DynamoDBLocal.Endpoint).
# Criar tabelas e carregar dados para exemplos de código no DynamoDB
Veja abaixo as noções básicas sobre como criar tabelas no DynamoDB, carregar um conjunto de dados de exemplo, consultar os dados e atualizá-los.
+ [Etapa 1: crie uma tabela no DynamoDB](getting-started-step-1.md)
+ [Etapa 2: grave dados em uma tabela do DynamoDB](getting-started-step-2.md)
+ [Etapa 3: leia os dados de uma tabela do DynamoDB](getting-started-step-3.md)
+ [Etapa 4: atualize os dados em uma tabela do DynamoDB](getting-started-step-4.md)
# Exemplos de código Java
**Topics**
+ [Java: configurar suas credenciais da AWS](#CodeSamples.Java.Credentials)
+ [Java: configurar a região e o endpoint da AWS](#CodeSamples.Java.RegionAndEndpoint)
Este Guia do Desenvolvedor contém trechos de código Java e programas prontos para serem executados. Você encontrará esses exemplos de código nas seguintes seções:
+ [Trabalhar com itens e atributos no DynamoDB](WorkingWithItems.md)
+ [Trabalhar com tabelas e dados no DynamoDB](WorkingWithTables.md)
+ [Consultar tabelas no DynamoDB](Query.md)
+ [Verificar tabelas no DynamoDB](Scan.md)
+ [Melhorar o acesso aos dados com índices secundários no DynamoDB](SecondaryIndexes.md)
+ [Java 1.x: DynamoDBMapper](DynamoDBMapper.md)
+ [Capturar dados de alterações para o DynamoDB Streams](Streams.md)
É possível começar rapidamente usando o Eclipse com o [AWS Toolkit for Eclipse](https://aws.amazon.com/eclipse/). Além de um IDE completo, você também terá o AWS SDK para Java com atualizações automáticas e modelos pré-configurados para a compilação de aplicações da AWS.
**Como executar os exemplos de código Java (usando o Eclipse)**
1. Baixe e instale o IDE do [Eclipse](http://www.eclipse.org).
1. Baixe e instale a [AWS Toolkit for Eclipse](https://aws.amazon.com/eclipse/).
1. Inicie o Eclipse e, no menu **Eclipse**, escolha **File (Arquivo)**, **New (Novo)** e **Other (Outro)**.
1. Em **Selecionar um assistente**, escolha **AWS**, **Projeto AWS Java** e **Próximo**.
1. Em **Criar um AWS Java**, faça o seguinte:
1. Em **Nome do projeto**, digite um nome para o seu projeto.
1. Em **Selecionar conta (Selecionar conta)**, escolha o perfil de suas credenciais na lista.
Se essa for a primeira vez que você usa o [AWS Toolkit for Eclipse](https://aws.amazon.com/eclipse/), escolha **Configurar contas da AWS** para configurar suas credenciais da AWS.
1. Escolha **Finish (Concluir)** para criar o projeto.
1. No menu do **Eclipse**, escolha **File (Arquivo)**, **New (Novo)** e, em seguida, **Class (Classe)**.
1. Em **Java Class (Classe Java)**, digite um nome para a sua classe em **Name (Nome)** (use o mesmo nome que o exemplo de código que você deseja executar) e escolha **Finish (Concluir)** para criar a classe.
1. Copie o exemplo de código da página de documentação no editor do Eclipse.
1. Para executar o código, escolha **Run (Executar)** no menu do Eclipse.
O SDK for Java fornece clientes thread-safe para trabalhar com o DynamoDB. De acordo com as melhores práticas, seus aplicativos devem criar um único cliente e reutilizá-lo entre os threads.
Para obter mais informações, consulte a [AWS SDK para Java](https://aws.amazon.com/sdk-for-java).
**nota**
Os exemplos de código neste guia são destinados para uso com a versão mais recente do AWS SDK para Java.
Se estiver usando o AWS Toolkit for Eclipse, você poderá configurar atualizações automáticas para o SDK for Java. Para fazer isso no Eclipse, vá para **Preferences** (Preferências) e escolha **AWS Toolkit**, **AWS SDK para Java** e **Download new SDKs automatically** (Fazer download automático de novos SDKs).
## Java: configurar suas credenciais da AWS
O SDK for Java exige que você forneça credenciais da AWS para a sua aplicação em tempo de execução. Os exemplos de código neste guia pressupõem que você esteja usando um arquivo de credenciais da AWS, conforme descrito em [Configurar suas credenciais da AWS](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/set-up-creds.html) no *Guia do desenvolvedor da AWS SDK para Java*.
Veja a seguir um exemplo de um arquivo de credenciais da AWS chamado `~/.aws/credentials` em que o caractere de til (`~`) representa seu diretório inicial.
```
[default]
aws_access_key_id = AWS access key ID goes here
aws_secret_access_key = Secret key goes here
```
## Java: configurar a região e o endpoint da AWS
Por padrão, os exemplos de código acessam o DynamoDB na região Oeste dos EUA (Oregon). É possível alterar a região ao modificar as propriedades `AmazonDynamoDB`.
O exemplo de código a seguir instancia uma nova `AmazonDynamoDB`.
```
import software.amazon.dynamodb.AmazonDynamoDBClientBuilder;
import com.amazonaws.regions.Regions;
...
// This client will default to US West (Oregon)
AmazonDynamoDB client = AmazonDynamoDBClientBuilder.standard()
.withRegion(Regions.US_WEST_2)
.build();
```
É possível usar o método `withRegion` para executar seu código no DynamoDB em qualquer região em que ele está disponível. Para obter uma lista completa, consulte [Regiões e endpoints da AWS](https://docs.aws.amazon.com/general/latest/gr/rande.html#ddb_region), na *Referência geral da Amazon Web Services*.
Se desejar executar os exemplos de código usando o DynamoDB localmente no seu computador, defina o endpoint conforme descrito a seguir.
### AWS SDK V1
```
AmazonDynamoDB client = AmazonDynamoDBClientBuilder.standard().withEndpointConfiguration(
new AwsClientBuilder.EndpointConfiguration("http://localhost:8000", "us-west-2"))
.build();
```
### AWS SDK V2
```
DynamoDbClient client = DynamoDbClient.builder()
.endpointOverride(URI.create("http://localhost:8000"))
// The region is meaningless for local DynamoDb but required for client builder validation
.region(Region.US_EAST_1)
.credentialsProvider(StaticCredentialsProvider.create(
AwsBasicCredentials.create("dummy-key", "dummy-secret")))
.build();
```
# Exemplos de código .NET
**Topics**
+ [.NET: configurar as suas credenciais da AWS](#CodeSamples.DotNet.Credentials)
+ [.NET: configurar a região e o endpoint da AWS](#CodeSamples.DotNet.RegionAndEndpoint)
Este guia contém trechos de código .NET e programas prontos para serem executados. Você encontrará esses exemplos de código nas seguintes seções:
+ [Trabalhar com itens e atributos no DynamoDB](WorkingWithItems.md)
+ [Trabalhar com tabelas e dados no DynamoDB](WorkingWithTables.md)
+ [Consultar tabelas no DynamoDB](Query.md)
+ [Verificar tabelas no DynamoDB](Scan.md)
+ [Melhorar o acesso aos dados com índices secundários no DynamoDB](SecondaryIndexes.md)
+ [Trabalhar com o modelo de documento do .NET no DynamoDB](DotNetSDKMidLevel.md)
+ [Trabalhar com o modelo de persistência de objetos do .NET e o DynamoDB](DotNetSDKHighLevel.md)
+ [Capturar dados de alterações para o DynamoDB Streams](Streams.md)
Você pode começar rapidamente usando o AWS SDK para .NET com o Toolkit for Visual Studio.
**Como executar os exemplos de código .NET (usando o Visual Studio)**
1. Baixe e instale o [Microsoft Visual Studio](https://www.visualstudio.com).
1. (Opcional) Baixe e instale o [Toolkit for Visual Studio](https://aws.amazon.com/visualstudio/).
1. Configure suas credenciais AWS. Configure um perfil de credenciais em seu arquivo de credenciais compartilhadas da AWS (`~/.aws/credentials`). Para obter mais informações, consulte [Configurar credenciais da AWS](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/net-dg-config-creds.html) no *Guia do desenvolvedor do AWS SDK para .NET*.
1. Inicie o Visual Studio. Escolha **File (Arquivo)**, **New (Novo)**, **Project (Projeto)**.
1. Busque por **Console App**, selecione o modelo C\$1 que tem como alvo o.NET e escolha **Avançar**. Configure o nome e a localização do projeto e, em seguida, escolha **Criar**.
1. Adicione o pacote do NuGet para o AWS SDK para DynamoDB ao projeto:
1. No Solution Explorer, abra o menu de contexto (clique com o botão direito do mouse) do seu projeto e escolha **Manage NuGet Packages (Gerenciar pacotes do NuGet)**.
1. No Gerenciador de pacotes NuGet, escolha **Browse (Procurar)**.
1. Na caixa de pesquisa, digite **AWSSDK.DynamoDBv2** e aguarde a conclusão da pesquisa.
1. Escolha **AWSSDK.DynamoDBv2** e **Install (Instalar)**.
1. Em seu projeto do Visual Studio, abra `Program.cs`. Substitua o conteúdo pelo exemplo de código da página de documentação que você deseja executar.
1. Para executar o código, escolha **Start (Iniciar)** na barra de ferramentas do Visual Studio.
O SDK para .NET fornece clientes thread-safe para trabalhar com o DynamoDB. De acordo com as melhores práticas, seus aplicativos devem criar um único cliente e reutilizá-lo entre os threads.
Para obter mais informações, consulte [AWS SDK for .NET](https://aws.amazon.com/sdk-for-net).
**nota**
Os exemplos de código neste guia são destinados para uso com a versão mais recente do AWS SDK para .NET.
## .NET: configurar as suas credenciais da AWS
O SDK para .NET exige que você forneça credenciais da AWS para a sua aplicação em tempo de execução. Os exemplos de código neste guia pressupõem que você esteja usando o SDK Store para gerenciar seu arquivo de credenciais da AWS, conforme descrito em [Usar o SDK Store](https://docs.aws.amazon.com/sdk-for-net/v3/developer-guide/net-dg-config-creds.html#sdk-store) no *Guia do desenvolvedor do AWS SDK para .NET*.
O Toolkit for Visual Studio oferece suporte a vários conjuntos de credenciais de qualquer número de contas. Cada conjunto é chamado de *perfil*. O Visual Studio adiciona entradas ao arquivo `App.config` do projeto para que a sua aplicação possa encontrar as credenciais da AWS em tempo de execução.
O exemplo a seguir mostra o arquivo `App.config` padrão que é gerado ao criar um novo projeto usando o Toolkit for Visual Studio.
```
```
Em tempo de execução, o programa usa o conjunto `default` de credenciais da AWS, conforme especificado pela entrada `AWSProfileName`. As credenciais da AWS são mantidas no SDK Store em formato criptografado. O Toolkit for Visual Studio fornece uma interface gráfica do usuário para gerenciar suas credenciais no Visual Studio. Para obter mais informações, consulte [Specifying credentials](https://docs.aws.amazon.com/AWSToolkitVS/latest/UserGuide/tkv_setup.html#creds) (Especificar credenciais) no *AWS Toolkit for Visual Studio User Guide* (Guia do usuário do ).
**nota**
Por padrão, os exemplos de código acessam o DynamoDB na região Oeste dos EUA (Oregon). É possível alterar a região ao modificar a entrada `AWSRegion` no arquivo App.config. É possível definir `AWSRegion` como qualquer região em que o DynamoDB está disponível. Para obter uma lista completa, consulte [Regiões e endpoints da AWS](https://docs.aws.amazon.com/general/latest/gr/rande.html#ddb_region), na *Referência geral da Amazon Web Services*.
## .NET: configurar a região e o endpoint da AWS
Por padrão, os exemplos de código acessam o DynamoDB na região Oeste dos EUA (Oregon). É possível alterar a região ao modificar a entrada `AWSRegion` no arquivo `App.config`. É possível alterar a região ao modificar as propriedades `AmazonDynamoDBClient`.
O exemplo de código a seguir instancia uma nova `AmazonDynamoDBClient`. O cliente é modificado de forma que o código seja executado no DynamoDB em uma região diferente.
```
AmazonDynamoDBConfig clientConfig = new AmazonDynamoDBConfig();
// This client will access the US East 1 region.
clientConfig.RegionEndpoint = RegionEndpoint.USEast1;
AmazonDynamoDBClient client = new AmazonDynamoDBClient(clientConfig);
```
Para obter uma lista completa de regiões, consulte [Regiões e endpoints da AWS](https://docs.aws.amazon.com/general/latest/gr/rande.html#ddb_region) na *Referência geral da Amazon Web Services*.
Se desejar executar os exemplos de código usando o DynamoDB localmente no seu computador, defina o endpoint conforme descrito a seguir.
```
AmazonDynamoDBConfig clientConfig = new AmazonDynamoDBConfig();
// Set the endpoint URL
clientConfig.ServiceURL = "http://localhost:8000";
AmazonDynamoDBClient client = new AmazonDynamoDBClient(clientConfig);
```