Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
FROM(INSERT,REMOVE, atauSET) perintah di Amazon QLDB
penting
Pemberitahuan akhir dukungan: Pelanggan yang ada akan dapat menggunakan Amazon QLDB hingga akhir dukungan pada 07/31/2025. Untuk detail selengkapnya, lihat Memigrasi QLDB Buku Besar Amazon ke Amazon Aurora Postgre
Di AmazonQLDB, pernyataan yang dimulai dengan FROM
adalah ekstensi PartiQL yang memungkinkan Anda untuk menyisipkan dan menghapus elemen tertentu dalam dokumen. Anda juga dapat menggunakan pernyataan ini untuk memperbarui elemen yang ada dalam dokumen, mirip dengan UPDATE perintah.
catatan
Untuk mempelajari cara mengontrol akses untuk menjalankan perintah PartiQL ini pada tabel tertentu, lihat. Memulai dengan mode izin standar di Amazon QLDB
Topik
Sintaks
FROM-INSERT
Masukkan elemen baru dalam dokumen yang ada. Untuk menyisipkan dokumen tingkat atas baru ke dalam tabel, Anda harus menggunakanINSERT.
FROM
table_name
[ AStable_alias
] [ BYid_alias
] [ WHEREcondition
] INSERT INTOelement
VALUEdata
[ ATkey_name
]
FROM-REMOVE
Hapus elemen yang ada dalam dokumen, atau hapus seluruh dokumen tingkat atas. Yang terakhir secara semantik sama dengan sintaks tradisionalDELETE.
FROM
table_name
[ AStable_alias
] [ BYid_alias
] [ WHEREcondition
] REMOVEelement
FROM-SET
Perbarui satu atau lebih elemen dalam dokumen. Jika elemen tidak ada, itu dimasukkan. Ini secara semantik sama dengan sintaks tradisionalUPDATE.
FROM
table_name
[ AStable_alias
] [ BYid_alias
] [ WHEREcondition
] SETelement
=data
[,element
=data
, ... ]
Parameter
table_name
-
Nama tabel pengguna yang berisi data yang akan dimodifikasi. DMLpernyataan hanya didukung dalam tampilan pengguna default. Setiap pernyataan hanya dapat berjalan pada satu tabel.
Dalam klausa ini, Anda juga dapat menyertakan satu atau lebih koleksi yang bersarang dalam tabel yang ditentukan. Untuk detail selengkapnya, lihat Koleksi bersarang.
- AS
table_alias
-
(Opsional) Alias yang ditentukan pengguna yang berkisar di atas tabel yang akan dimodifikasi. Semua alias tabel yang digunakan dalam
SET
,,REMOVE
INSERT INTO
, atauWHERE
klausa harus dinyatakan dalam klausa.FROM
AS
Kata kunci adalah opsional. - OLEH
id_alias
-
(Opsional) Alias yang ditentukan pengguna yang mengikat bidang
id
metadata setiap dokumen dalam kumpulan hasil. Alias harus dinyatakan dalamFROM
klausa menggunakan kata kunci.BY
Ini berguna ketika Anda ingin memfilter pada ID dokumen saat menanyakan tampilan pengguna default. Untuk informasi selengkapnya, lihat Menggunakan klausa BY untuk menanyakan ID dokumen. - WHERE
condition
-
Kriteria seleksi untuk dokumen yang akan dimodifikasi.
catatan
Jika Anda menghilangkan
WHERE
klausa, maka semua dokumen dalam tabel dimodifikasi. element
-
Elemen dokumen yang akan dibuat atau dimodifikasi.
data
-
Nilai baru untuk elemen.
- DI
key_name
-
Nama kunci yang akan ditambahkan dalam dokumen yang akan dimodifikasi. Anda harus menentukan yang sesuai
VALUE
bersama dengan nama kunci. Ini diperlukan untuk memasukkan nilai baru posisiAT
tertentu dalam dokumen.
Koleksi bersarang
Meskipun Anda dapat menjalankan DML pernyataan pada satu tabel saja, Anda dapat menentukan koleksi bersarang dalam dokumen dalam tabel tersebut sebagai sumber tambahan. Setiap alias yang Anda deklarasikan untuk koleksi bersarang dapat digunakan dalam WHERE
klausa dan,, atau klausa. SET
INSERT
INTO
REMOVE
Misalnya, FROM
sumber pernyataan berikut mencakup VehicleRegistration
tabel dan Owners.SecondaryOwners
struktur bersarang.
FROM VehicleRegistration r, @r.Owners.SecondaryOwners o WHERE r.VIN = '1N4AL11D75C109151' AND o.PersonId = 'abc123' SET o.PersonId = 'def456'
Contoh ini memperbarui elemen spesifik dari SecondaryOwners
daftar yang memiliki a PersonId
dari 'abc123'
dalam VehicleRegistration
dokumen yang memiliki a VIN
of'1N4AL11D75C109151'
. Ekspresi ini memungkinkan Anda menentukan elemen daftar berdasarkan nilainya daripada indeksnya.
Nilai yang dikembalikan
documentId
— ID unik dari setiap dokumen yang Anda perbarui atau hapus.
Contoh
Memodifikasi elemen dalam dokumen. Jika elemen tidak ada, itu dimasukkan.
FROM Vehicle AS v WHERE v.VIN = '1N4AL11D75C109151' AND v.Color = 'Silver' SET v.Color = 'Shiny Gray'
Ubah atau sisipkan elemen dan filter pada bidang id
metadata dokumen yang ditetapkan sistem.
FROM Vehicle AS v BY v_id WHERE v_id = '
documentId
' SET v.Color = 'Shiny Gray'
Ubah PersonId
bidang elemen pertama dalam Owners.SecondaryOwners
daftar dalam dokumen.
FROM VehicleRegistration AS r WHERE r.VIN = '1N4AL11D75C109151' SET r.Owners.SecondaryOwners[0].PersonId = 'abc123'
Hapus elemen yang ada dalam dokumen.
FROM Person AS p WHERE p.GovId = '111-22-3333' REMOVE p.Address
Hapus seluruh dokumen dari tabel.
FROM Person AS p WHERE p.GovId = '111-22-3333' REMOVE p
Hapus elemen pertama dari Owners.SecondaryOwners
daftar dalam dokumen dalam VehicleRegistration
tabel.
FROM VehicleRegistration AS r WHERE r.VIN = '1N4AL11D75C109151' REMOVE r.Owners.SecondaryOwners[0]
Masukkan {'Mileage':26500}
sebagai pasangan nama-nilai tingkat atas dalam dokumen dalam tabel. Vehicle
FROM Vehicle AS v WHERE v.VIN = '1N4AL11D75C109151' INSERT INTO v VALUE 26500 AT 'Mileage'
Tambahkan {'PersonId':'abc123'}
sebagai pasangan nama-nilai di Owners.SecondaryOwners
bidang dokumen dalam tabel. VehicleRegistration
Perhatikan bahwa Owners.SecondaryOwners
harus sudah ada dan harus berupa tipe data daftar agar pernyataan ini valid. Jika tidak, kata kunci AT
diperlukan dalam INSERT INTO
klausa.
FROM VehicleRegistration AS r WHERE r.VIN = '1N4AL11D75C109151' INSERT INTO r.Owners.SecondaryOwners VALUE { 'PersonId' : 'abc123' }
Masukkan {'PersonId':'abc123'}
sebagai elemen pertama dalam Owners.SecondaryOwners
daftar yang ada dalam dokumen.
FROM VehicleRegistration AS r WHERE r.VIN = '1N4AL11D75C109151' INSERT INTO r.Owners.SecondaryOwners VALUE {'PersonId' : 'abc123'} AT 0
Tambahkan beberapa pasangan nama-nilai ke Owners.SecondaryOwners
daftar yang ada dalam dokumen.
FROM VehicleRegistration AS r WHERE r.VIN = '1N4AL11D75C109151' INSERT INTO r.Owners.SecondaryOwners << {'PersonId' : 'abc123'}, {'PersonId' : 'def456'} >>
Berjalan secara terprogram menggunakan driver
Untuk mempelajari cara menjalankan pernyataan ini secara terprogram menggunakan QLDB driver, lihat tutorial berikut di Memulai dengan driver:
-
Pergi: Tutorial mulai cepat | Referensi buku masak
-
Node.js: Tutorial mulai cepat | Referensi buku masak
-
Python: | Tutorial mulai cepat Referensi buku masak