As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Trabalhe com DynamoDB
<a name="examples-dynamodb"></a>

O [DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Introduction.html) é um serviço de banco de dados NoSQL totalmente gerenciado que proporciona um desempenho rápido e previsível com escalabilidade contínua. Esta seção mostra como trabalhar com o DynamoDB usando o AWS SDK para Java 2.x.

## Escolher o cliente do DynamoDB
<a name="ddb-clients-overview"></a>

O SDK fornece duas abordagens principais para trabalhar com o DynamoDB:

Cliente de nível inferior (`DynamoDbClient`)  
Fornece acesso direto às operações do DynamoDB com controle total sobre solicitações e respostas. Use esse cliente quando precisar de um controle refinado ou trabalhar com esquemas dinâmicos.

Cliente aprimorado (`DynamoDbEnhancedClient`)  
Oferece programação orientada a objetos com mapeamento automático entre objetos do Java e itens do DynamoDB. Também fornece recursos orientados a documentos para trabalhar com dados semelhantes a JSON que não seguem um esquema fixo. Use esse cliente ao trabalhar com modelos de dados bem definidos ou dados do tipo de documento.

## Configurar clientes do DynamoDB
<a name="ddb-configuration-setup"></a>

Antes de trabalhar com o DynamoDB, configure o cliente para obter desempenho e confiabilidade ideais.

### Noções básicas do comportamento de nova tentativa do DynamoDB
<a name="ddb-retry-behavior"></a>

Os clientes do DynamoDB usam uma contagem máxima de novas tentativas padrão de 8, que é maior que a de outros clientes de AWS service (Serviço da AWS) . Essa contagem mais alta de tentativas ajuda a lidar com a natureza distribuída e as limitações temporárias de capacidade do DynamoDB. Consulte mais informações sobre estratégias de novas tentativas em [Configure o comportamento de repetição no AWS SDK for Java 2.x](retry-strategy.md).

### Otimize o desempenho com endpoints baseados em contas
<a name="ddb-account-based-endpoints-v2"></a>

O DynamoDB [AWS oferece endpoints baseados em contas](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Programming.SDKOverview.html#Programming.SDKs.endpoints) que melhoram o desempenho usando AWS seu ID de conta para simplificar o roteamento de solicitações. 

Para usar esse recurso, você precisa da versão 2.28.4 ou posterior do AWS SDK for Java 2.x. É possível encontrar a versão mais recente no [repositório central do Maven](https://central.sonatype.com/artifact/software.amazon.awssdk/bom/versions). As versões compatíveis do SDK usam os novos endpoints automaticamente.

Para desativar o roteamento baseado em conta, escolha uma destas opções:
+ Configurar um cliente de serviço do DynamoDB com `AccountIdEndpointMode` definido como `DISABLED`.
+ Definir uma variável de ambiente.
+ Definir uma propriedade do sistema da JVM.
+ Atualize a AWS configuração do arquivo de configuração compartilhado.

O seguinte exemplo mostra como desabilitar o roteamento baseado em contas configurando um cliente de serviço do DynamoDB:

```
DynamoDbClient.builder()
                 .accountIdEndpointMode(AccountIdEndpointMode.DISABLED)
                 .build();
```

Para obter mais informações sobre as outras opções de configuração, consulte [Endpoints baseados em conta](https://docs.aws.amazon.com/sdkref/latest/guide/feature-account-endpoints.html) no Guia de referência de ferramentas AWS SDKs e ferramentas.

## O que é abordado neste tópico
<a name="ddb-topics-overview"></a>

As seguintes seções mostram como trabalhar com o DynamoDB:
+ [Trabalhar com tabelas no DynamoDB](examples-dynamodb-tables.md): criar, descrever, atualizar e excluir tabelas
+ [Trabalhe com itens em DynamoDB](examples-dynamodb-items.md): adicionar, recuperar e atualizar itens individuais
+ [Mapeie objetos Java para itens do DynamoDB com o AWS SDK for Java 2.x](dynamodb-enhanced-client.md): usar mapeamento de objetos e dados orientados a documentos com o Cliente Aprimorado

Para ver exemplos adicionais de código do DynamoDB, consulte exemplos de código do [DynamoDB na Biblioteca de exemplos de códigos.](java_dynamodb_code_examples.md) AWS