Pernyataan hapus PartiQL untuk DynamoDB - Amazon DynamoDB
SintaksParameterNilai yang dikembalikanContoh

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

Pernyataan hapus PartiQL untuk DynamoDB

Gunakan pernyataan DELETE untuk menghapus item yang sudah ada dari tabel Amazon DynamoDB Anda.

catatan

Anda hanya dapat menghapus satu item dalam satu waktu. Anda tidak dapat mengeluarkan pernyataan DynamoDB PartiQL tunggal yang menghapus beberapa item. Untuk informasi tentang menghapus beberapa item, lihat Melakukan transaksi dengan PartiQL untuk DynamoDB atau Menjalankan operasi batch dengan PartiQL untuk DynamoDB.

Sintaks

DELETE FROM table 
 WHERE condition [RETURNING returnvalues]
 <returnvalues>  ::= ALL OLD *

Parameter

tabel

(Diperlukan) Tabel DynamoDB yang berisi item yang akan dihapus.

ketentuan

(Diperlukan) Kriteria seleksi untuk item yang akan dihapus; syarat ini harus diselesaikan untuk nilai kunci primer tunggal.

returnvalues

(Opsional) Gunakan returnvalues jika Anda ingin mendapatkan atribut item seperti yang muncul sebelum atribut item tersebut dihapus. Nilai yang valid adalah:

  • ALL OLD *- Konten dari item lama akan dikembalikan.

Nilai yang dikembalikan

Pernyataan ini tidak mengembalikan nilai kecuali parameter returnvalues ditentukan.

catatan

Jika tabel DynamoDB tidak memiliki item dengan kunci primer yang sama seperti yang item yang DELETE-nya dikeluarkan, SUCCESS dikembalikan dengan 0 item dihapus. Jika tabel memiliki item dengan kunci primer yang sama, tetapi syarat dalam klausul WHERE pernyataan dari DELETE bernilai false, ConditionalCheckFailedException akan dikembalikan.

Contoh

Kueri berikut akan menghapus item dalam tabel "Music".

DELETE FROM "Music" WHERE "Artist" = 'Acme Band' AND "SongTitle" = 'PartiQL Rocks'

Anda dapat menambahkan parameter RETURNING ALL OLD * untuk mengembalikan data yang telah dihapus.

DELETE FROM "Music" WHERE "Artist" = 'Acme Band' AND "SongTitle" = 'PartiQL Rocks' RETURNING ALL OLD *

Pernyataan Delete sekarang mengembalikan yang berikut:

{
    "Items": [
        {
            "Artist": {
                "S": "Acme Band"
            },
            "SongTitle": {
                "S": "PartiQL Rocks"
            }
        }
    ]
}