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. SQL

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

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 [ AS table_alias ] [ BY id_alias ]
[ WHERE condition ]
INSERT INTO element VALUE data [ AT key_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 [ AS table_alias ] [ BY id_alias ]
[ WHERE condition ]
REMOVE element

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 [ AS table_alias ] [ BY id_alias ]
[ WHERE condition ]
SET element = 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 dalamSET,, REMOVEINSERT INTO, atau WHERE klausa harus dinyatakan dalam klausa. FROM ASKata kunci adalah opsional.

OLEH id_alias

(Opsional) Alias yang ditentukan pengguna yang mengikat bidang id metadata setiap dokumen dalam kumpulan hasil. Alias harus dinyatakan dalam FROM 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 posisi AT 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:

• Jawa: Tutorial mulai cepat | Referensi buku masak

• .NET: Tutorial mulai cepat | Referensi buku masak

• Pergi: Tutorial mulai cepat | Referensi buku masak

• Node.js: Tutorial mulai cepat | Referensi buku masak

• Python: | Tutorial mulai cepat Referensi buku masak