O AWS SDK para JavaScript v2 chegou ao fim do suporte. Recomendamos migrar para o [AWS SDK para JavaScript v3](https://docs.aws.amazon.com//sdk-for-javascript/v3/developer-guide/). Para ver detalhes e informações sobre como migrar, consulte este [anúncio](https://aws.amazon.com/blogs//developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2/).
# Ler e gravar um único item no DynamoDB
![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/pt_br/sdk-for-javascript/v2/developer-guide/images/nodeicon.png)
**Este exemplo de código Node.js mostra:**
+ Como adicionar um item em uma tabela do DynamoDB.
+ Como recuperar um item em uma tabela do DynamoDB.
+ Como excluir um item de uma tabela do DynamoDB.
## O cenário
Neste exemplo, você usa uma série de módulos de Node.js para ler e gravar um item em uma tabela do DynamoDB usando esses métodos da classe de cliente `AWS.DynamoDB`:
+ [putItem](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB.html#putItem-property)
+ [getItem](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB.html#getItem-property)
+ [deleteItem](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/DynamoDB.html#deleteItem-property)
## Tarefas de pré-requisito
Para configurar e executar este exemplo, primeiro conclua estas tarefas:
+ Instale o Node.js. Para obter mais informações, consulte o website [Node.js](https://nodejs.org).
+ Crie um arquivo de configurações compartilhado com as credenciais de usuário. Para obter mais informações sobre como fornecer um arquivo de credenciais compartilhadas, consulte [Carregar credenciais em Node.js do arquivo de credenciais compartilhado](loading-node-credentials-shared.md).
+ Crie uma tabela do DynamoDB cujos itens você possa acessar. Para obter mais informações sobre como criar uma tabela do DynamoDB, consulte [Criação e uso de tabelas no DynamoDB](dynamodb-examples-using-tables.md).
## Gravação de um item
Crie um módulo do Node.js com o nome de arquivo `ddb_putitem.js`. Não se esqueça de configurar o SDK conforme mostrado anteriormente. Para acessar o DynamoDB, crie um objeto de serviço do `AWS.DynamoDB`. Crie um objeto JSON que contém os parâmetros necessários para adicionar um item, que, neste exemplo, inclui o nome da tabela e um mapa que define os atributos a serem configurados e os valores de cada atributo. Chame o método `putItem` do objeto de serviço do DynamoDB.
```
// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });
// Create the DynamoDB service object
var ddb = new AWS.DynamoDB({ apiVersion: "2012-08-10" });
var params = {
TableName: "CUSTOMER_LIST",
Item: {
CUSTOMER_ID: { N: "001" },
CUSTOMER_NAME: { S: "Richard Roe" },
},
};
// Call DynamoDB to add the item to the table
ddb.putItem(params, function (err, data) {
if (err) {
console.log("Error", err);
} else {
console.log("Success", data);
}
});
```
Para executar o exemplo, digite o seguinte na linha de comando.
```
node ddb_putitem.js
```
Este código de exemplo pode ser encontrado [aqui no GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascript/example_code/dynamodb/ddb_putitem.js).
## Obter um item
Crie um módulo do Node.js com o nome de arquivo `ddb_getitem.js`. Não se esqueça de configurar o SDK conforme mostrado anteriormente. Para acessar o DynamoDB, crie um objeto de serviço do `AWS.DynamoDB`. Para identificar o item a ser obtido, você deve fornecer o valor da chave primária desse item na tabela. Por padrão, o método `getItem` retorna todos os valores de atributo definidos para o item. Para obter apenas um subconjunto de todos os valores de atributo possíveis, especifique uma expressão de projeção.
Crie um objeto JSON que contenha os parâmetros necessários para obter um item, que, neste exemplo, inclui o nome da tabela, o nome e o valor da chave do item que você está recebendo, e uma expressão de projeção que identifica o atributo do item que deseja recuperar. Chame o método `getItem` do objeto de serviço do DynamoDB.
```
// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });
// Create the DynamoDB service object
var ddb = new AWS.DynamoDB({ apiVersion: "2012-08-10" });
var params = {
TableName: "TABLE",
Key: {
KEY_NAME: { N: "001" },
},
ProjectionExpression: "ATTRIBUTE_NAME",
};
// Call DynamoDB to read the item from the table
ddb.getItem(params, function (err, data) {
if (err) {
console.log("Error", err);
} else {
console.log("Success", data.Item);
}
});
```
Para executar o exemplo, digite o seguinte na linha de comando.
```
node ddb_getitem.js
```
Este código de exemplo pode ser encontrado [aqui no GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascript/example_code/dynamodb/ddb_getitem.js).
## Excluir um item
Crie um módulo do Node.js com o nome de arquivo `ddb_deleteitem.js`. Não se esqueça de configurar o SDK conforme mostrado anteriormente. Para acessar o DynamoDB, crie um objeto de serviço do `AWS.DynamoDB`. Crie um objeto JSON com os parâmetros necessários para excluir um item, que, neste exemplo, inclui o nome da tabela, além do nome da chave e o valor do item que você está excluindo. Chame o método `deleteItem` do objeto de serviço do DynamoDB.
```
// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });
// Create the DynamoDB service object
var ddb = new AWS.DynamoDB({ apiVersion: "2012-08-10" });
var params = {
TableName: "TABLE",
Key: {
KEY_NAME: { N: "VALUE" },
},
};
// Call DynamoDB to delete the item from the table
ddb.deleteItem(params, function (err, data) {
if (err) {
console.log("Error", err);
} else {
console.log("Success", data);
}
});
```
Para executar o exemplo, digite o seguinte na linha de comando.
```
node ddb_deleteitem.js
```
Este código de exemplo pode ser encontrado [aqui no GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascript/example_code/dynamodb/ddb_deleteitem.js).