# Instruções Insert em PartiQL para DynamoDB
<a name="ql-reference.insert"></a>

Use a instrução `INSERT` para adicionar um item a uma tabela no Amazon DynamoDB.

**nota**  
Você só pode inserir um item de cada vez; não é possível emitir uma única instrução PartiQL do DynamoDB para inserir vários itens. Para obter informações sobre como inserir vários itens, consulte [Executar transações com PartiQL para DynamoDB](ql-reference.multiplestatements.transactions.md) ou [Executar operações em lote com PartiQL para DynamoDB](ql-reference.multiplestatements.batching.md).

**Topics**
+ [Sintaxe](#ql-reference.insert.syntax)
+ [Parâmetros](#ql-reference.insert.parameters)
+ [Valor de retorno](#ql-reference.insert.return)
+ [Exemplos](#ql-reference.insert.examples)

## Sintaxe
<a name="ql-reference.insert.syntax"></a>

Insira um único item.

```
INSERT INTO table VALUE item
```

## Parâmetros
<a name="ql-reference.insert.parameters"></a>

***table***  
(Obrigatório) A tabela na qual você deseja inserir os dados. A tabela já deve existir.

***item***  
(Obrigatório) Um item válido do DynamoDB representado como uma [tupla PartiQL](https://partiql.org/docs.html). Você só deve especificar *um* item, e cada nome de atributo no item diferencia maiúsculas e minúsculas e pode ser indicado com aspas *simples* (`'...'`) na linguagem PartiQL.  
Os valores de string também são denotados com aspas *simples* (`'...'`) em PartiQL.

## Valor de retorno
<a name="ql-reference.insert.return"></a>

Esta instrução não retorna nenhum valor.

**nota**  
Se a tabela do DynamoDB já tiver um item com a mesma chave primária da chave primária do item que está sendo inserido, `DuplicateItemException` será retornado.

## Exemplos
<a name="ql-reference.insert.examples"></a>

```
INSERT INTO "Music" value {'Artist' : 'Acme Band','SongTitle' : 'PartiQL Rocks'}
```