Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Istruzioni INSERT PartiQL per DynamoDB
<a name="ql-reference.insert"></a>

Utilizza l'istruzione `INSERT` per aggiungere un elemento a una tabella in Amazon DynamoDB.

**Nota**  
È possibile inserire un solo elemento alla volta; non è possibile emettere una singola istruzione PartiQL DynamoDB che inserisce più elementi. Per informazioni sull'inserimento di più elementi, consulta [Esecuzione di transazioni con PartiQL per DynamoDB](ql-reference.multiplestatements.transactions.md) o [Esecuzione di operazioni in batch con PartiQL per DynamoDB](ql-reference.multiplestatements.batching.md).

**Topics**
+ [Sintassi](#ql-reference.insert.syntax)
+ [Parameters](#ql-reference.insert.parameters)
+ [Valore restituito](#ql-reference.insert.return)
+ [Esempi](#ql-reference.insert.examples)

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

Inserisci un singolo elemento.

```
INSERT INTO table VALUE item
```

## Parameters
<a name="ql-reference.insert.parameters"></a>

***table***  
(Obbligatorio) La tabella in cui si desidera inserire i dati. La tabella deve già essere presente.

***item***  
(Obbligatorio) Un elemento DynamoDB valido rappresentato come [tupla PartiQL](https://partiql.org/docs.html). È necessario specificare solo *un* elemento e tenere presente che ciascun nome di attributo nell'elemento fa distinzione tra maiuscole e minuscole e può essere riportato con virgolette *singole* (`'...'`) in PartiQL.  
Anche i valori stringa sono riportati con virgolette *singole* (`'...'`) in PartiQL.

## Valore restituito
<a name="ql-reference.insert.return"></a>

Questa istruzione non restituisce alcun valore.

**Nota**  
Se nella tabella DynamoDB è già presente un elemento con la stessa chiave primaria della chiave primaria dell'elemento da inserire, viene restituito `DuplicateItemException`.

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

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