

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

# Langkah 4: Ubah dokumen dalam buku besar
<a name="getting-started-step-4"></a>

**penting**  
Pemberitahuan akhir dukungan: Pelanggan yang ada akan dapat menggunakan Amazon QLDB hingga akhir dukungan pada 07/31/2025. Untuk detail selengkapnya, lihat [Memigrasi Buku Besar QLDB Amazon ke Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.

Sekarang setelah Anda memiliki data untuk dikerjakan, Anda dapat mulai membuat perubahan pada dokumen di `vehicle-registration` buku besar di Amazon QLDB. Misalnya, perhatikan Audi A5 dengan VIN. `1N4AL11D75C109151` Mobil ini awalnya dimiliki oleh seorang pengemudi bernama Raul Lewis di Seattle, WA.

Misalkan Raul menjual mobil itu kepada seorang penduduk di Everett, WA bernama Brent Logan. Kemudian, Brent dan Alexis Pena memutuskan untuk menikah. Brent ingin menambahkan Alexis sebagai pemilik sekunder pada pendaftaran. Pada langkah ini, pernyataan bahasa manipulasi data (DHTML) berikut menunjukkan bagaimana membuat perubahan yang sesuai dalam buku besar Anda untuk mencerminkan peristiwa ini.

**Tip**  
Sebagai praktik terbaik, gunakan sistem dokumen yang ditugaskan `id` sebagai kunci asing. Meskipun Anda dapat menentukan bidang yang dimaksudkan untuk menjadi pengidentifikasi unik (misalnya, VIN kendaraan), pengidentifikasi unik sebenarnya dari dokumen adalah milik-nya. `id` Bidang ini disertakan dalam metadata dokumen, yang dapat Anda kueri dalam tampilan *komited (tampilan* tabel yang ditentukan sistem).  
Untuk informasi selengkapnya tentang tampilan di QLDB, lihat. [Konsep inti](ledger-structure.md) Untuk mempelajari lebih lanjut tentang metadata, lihat. [Meminta metadata dokumen](working.metadata.md)

**Untuk memodifikasi dokumen**

1. [Buka konsol QLDB Amazon di /qldb. https://console.aws.amazon.com](https://console.aws.amazon.com/qldb)

1. Di panel navigasi, pilih editor **PartiQL**.

1. Pilih `vehicle-registration` buku besar.
**catatan**  
Jika Anda menyiapkan buku besar menggunakan fitur **data sampel Muat** otomatis konsol, lanjutkan ke langkah 6.

1. Jika Anda menjalankan `INSERT` pernyataan secara manual untuk memuat data sampel, lanjutkan dengan langkah-langkah ini.

   Untuk awalnya mendaftarkan Raul sebagai pemilik kendaraan ini, mulailah dengan menemukan dokumen yang ditugaskan sistemnya `id` di tabel. `Person` *Bidang ini disertakan dalam metadata dokumen, yang dapat Anda kueri dalam tampilan tabel yang ditentukan sistem, yang disebut tampilan komited.*

   Di jendela editor kueri, masukkan pernyataan berikut, lalu pilih **Jalankan**.

   ```
   SELECT metadata.id FROM _ql_committed_Person AS p
   WHERE p.data.FirstName = 'Raul' and p.data.LastName = 'Lewis'
   ```

   Awalan `_ql_committed_` adalah awalan cadangan yang menandakan bahwa Anda ingin menanyakan tampilan tabel yang berkomitmen. `Person` Dalam tampilan ini, data Anda bersarang di `data` bidang, dan metadata bersarang di bidang. `metadata`

1. Sekarang, gunakan ini `id` dalam `UPDATE` pernyataan untuk memodifikasi dokumen yang sesuai dalam `VehicleRegistration` tabel. Masukkan pernyataan berikut, lalu pilih **Jalankan**.

   ```
   UPDATE VehicleRegistration AS r
   SET r.Owners.PrimaryOwner.PersonId = '294jJ3YUoH1IEEm8GSabOs' --replace with your id
   WHERE r.VIN = '1N4AL11D75C109151'
   ```

   Konfirmasikan bahwa Anda memodifikasi `Owners` bidang dengan mengeluarkan pernyataan ini.

   ```
   SELECT r.Owners FROM VehicleRegistration AS r
   WHERE r.VIN = '1N4AL11D75C109151'
   ```

1. Untuk mentransfer kepemilikan kendaraan ke Brent di kota Everett, pertama-tama temukan miliknya `id` dari `Person` meja dengan pernyataan berikut.

   ```
   SELECT metadata.id FROM _ql_committed_Person AS p
   WHERE p.data.FirstName = 'Brent' and p.data.LastName = 'Logan'
   ```

   Selanjutnya, gunakan ini `id` untuk memperbarui `PrimaryOwner` dan `City` di `VehicleRegistration` tabel.

   ```
   UPDATE VehicleRegistration AS r
   SET r.Owners.PrimaryOwner.PersonId = '7NmE8YLPbXc0IqesJy1rpR', --replace with your id
       r.City = 'Everett'
   WHERE r.VIN = '1N4AL11D75C109151'
   ```

   Konfirmasikan bahwa Anda mengubah `City` bidang `PrimaryOwner` dan dengan mengeluarkan pernyataan ini.

   ```
   SELECT r.Owners.PrimaryOwner, r.City
   FROM VehicleRegistration AS r
   WHERE r.VIN = '1N4AL11D75C109151'
   ```

1. Untuk menambahkan Alexis sebagai pemilik sekunder mobil, temukan dia`Person id`.

   ```
   SELECT metadata.id FROM _ql_committed_Person AS p
   WHERE p.data.FirstName = 'Alexis' and p.data.LastName = 'Pena'
   ```

   Kemudian, masukkan ini `id` ke dalam `SecondaryOwners` daftar dengan pernyataan [DMLFROM-INSERT](ql-reference.from.md) berikut.

   ```
   FROM VehicleRegistration AS r 
   WHERE r.VIN = '1N4AL11D75C109151'
   INSERT INTO r.Owners.SecondaryOwners
       VALUE { 'PersonId' : '5Ufgdlnj06gF5CWcOIu64s' } --replace with your id
   ```

   Konfirmasikan bahwa Anda memodifikasi `SecondaryOwners` dengan mengeluarkan pernyataan ini.

   ```
   SELECT r.Owners.SecondaryOwners FROM VehicleRegistration AS r
   WHERE r.VIN = '1N4AL11D75C109151'
   ```

Untuk meninjau perubahan ini di `vehicle-registration` buku besar, lihat[Langkah 5: Lihat riwayat revisi untuk dokumen](getting-started-step-5.md).