

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Pernyataan sisipkan PartiQL untuk DynamoDB
<a name="ql-reference.insert"></a>

Gunakan pernyataan `INSERT` untuk menambahkan item ke tabel di Amazon DynamoDB.

**catatan**  
Anda hanya dapat menyisipkan satu item pada satu waktu; Anda tidak dapat mengeluarkan pernyataan DynamoDB PartiQL tunggal yang menyisipkan beberapa item. Untuk informasi tentang cara menyisipkan beberapa item, lihat [Melakukan transaksi dengan PartiQL untuk DynamoDB](ql-reference.multiplestatements.transactions.md) atau [Menjalankan operasi batch dengan PartiQL untuk DynamoDB](ql-reference.multiplestatements.batching.md).

**Topics**
+ [Sintaksis](#ql-reference.insert.syntax)
+ [Parameter](#ql-reference.insert.parameters)
+ [Nilai yang dikembalikan](#ql-reference.insert.return)
+ [Contoh](#ql-reference.insert.examples)

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

Sisipkan satu item.

```
INSERT INTO table VALUE item
```

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

***table***  
(Diperlukan) Tabel tempat Anda ingin menyisipkan data. Tabel harus sudah ada.

***item***  
(Diperlukan) Item DynamoDB yang valid diwakili sebagai [tupel PartiQL](https://partiql.org/docs.html). Anda harus menentukan hanya *satu* item dan setiap nama atribut dalam item adalah peka huruf besar-kecil dan dapat dilambangkan dengan tanda petik *tunggal* (`'...'`) di PartiQL.  
Nilai string juga dilambangkan dengan tanda petik *tunggal* (`'...'`) di PartiQL.

## Nilai yang dikembalikan
<a name="ql-reference.insert.return"></a>

Pernyataan ini tidak mengembalikan nilai apa pun.

**catatan**  
Jika tabel DynamoDB sudah memiliki item dengan kunci primer yang sama sebagai kunci primer dari item yang sedang disisipkan, `DuplicateItemException` dikembalikan.

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

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