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

# Meminta metadata dokumen
<a name="working.metadata"></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.

`INSERT`Pernyataan membuat revisi awal dokumen dengan nomor versi nol. Untuk mengidentifikasi setiap dokumen secara unik, Amazon QLDB menetapkan ID *dokumen* sebagai bagian dari metadata.

Selain ID dokumen dan nomor versi, QLDB menyimpan metadata lain yang dihasilkan sistem untuk setiap dokumen dalam tabel. Metadata ini mencakup informasi transaksi, atribut jurnal, dan nilai hash dokumen.

Semua sistem yang ditugaskan IDs adalah pengidentifikasi unik universal (UUID) yang masing-masing diwakili dalam string yang dikodekan Base62. Untuk informasi selengkapnya, lihat [Unik IDs di Amazon QLDB](working.unique-id.md).

**Topics**
+ [

## Pandangan berkomitmen
](#working.metadata.committed)
+ [

## Bergabung dengan pandangan yang berkomitmen dan pengguna
](#working.metadata.committed-joins)

## Pandangan berkomitmen
<a name="working.metadata.committed"></a>

*Anda dapat mengakses metadata dokumen dengan menanyakan tampilan yang dikomit.* Tampilan ini mengembalikan dokumen dari tabel yang ditentukan sistem yang secara langsung sesuai dengan tabel pengguna Anda. Ini mencakup revisi terbaru yang berkomitmen dan tidak dihapus dari data Anda dan metadata yang dihasilkan sistem. Untuk menanyakan tampilan ini, tambahkan awalan `_ql_committed_` ke nama tabel dalam kueri Anda. (Awalan `_ql_` dicadangkan dalam QLDB untuk objek sistem.)

```
SELECT * FROM _ql_committed_VehicleRegistration AS r
WHERE r.data.VIN IN ('1N4AL11D75C109151', 'KM8SRDHF6EU074761')
```

Menggunakan data yang sebelumnya dimasukkan[Membuat tabel dengan indeks dan memasukkan dokumen](working.create.md), output dari kueri ini menunjukkan isi sistem dari setiap revisi terbaru dokumen yang tidak dihapus. Dokumen sistem memiliki metadata bersarang di `metadata` bidang, dan data pengguna Anda bersarang di bidang. `data`

```
{
    blockAddress:{
        strandId:"JdxjkR9bSYB5jMHWcI464T",
        sequenceNo:14
    },
    hash:{{wCsmM6qD4STxz0WYmE+47nZvWtcCz9D6zNtCiM5GoWg=}},
    data:{
        VIN: "1N4AL11D75C109151",
        LicensePlateNumber: "LEWISR261LL",
        State: "WA",
        City: "Seattle",
        PendingPenaltyTicketAmount: 90.25,
        ValidFromDate: 2017-08-21T,
        ValidToDate: 2020-05-11T,
        Owners: {
            PrimaryOwner: { PersonId: "294jJ3YUoH1IEEm8GSabOs" },
            SecondaryOwners: [{ PersonId: "5Ufgdlnj06gF5CWcOIu64s" }]
        }
    },
    metadata:{
        id:"3Qv67yjXEwB9SjmvkuG6Cp",
        version:0,
        txTime:2019-06-05T20:53:321d-3Z,
        txId:"HgXAkLjAtV0HQ4lNYdzX60"
    }
},
{
    blockAddress:{
        strandId:"JdxjkR9bSYB5jMHWcI464T",
        sequenceNo:14
    },
    hash:{{wPuwH60TtcCvg/23BFp+redRXuCALkbDihkEvCX22Jk=}},
    data:{
        VIN: "KM8SRDHF6EU074761",
        LicensePlateNumber: "CA762X",
        State: "WA",
        City: "Kent",
        PendingPenaltyTicketAmount: 130.75,
        ValidFromDate: 2017-09-14T,
        ValidToDate: 2020-06-25T,
        Owners: {
            PrimaryOwner: { PersonId: "IN7MvYtUjkp1GMZu0F6CG9" },
            SecondaryOwners: []
        }
    },
    metadata:{
        id:"JOzfB3lWqGU727mpPeWyxg",
        version:0,
        txTime:2019-06-05T20:53:321d-3Z,
        txId:"HgXAkLjAtV0HQ4lNYdzX60"
    }
}
```

**Bidang tampilan yang berkomitmen**
+ `blockAddress`— Lokasi blok di jurnal buku besar Anda tempat revisi dokumen dilakukan. Alamat, yang dapat digunakan untuk verifikasi kriptografi, memiliki dua bidang berikut.
  + `strandId`— ID unik untai jurnal yang berisi blok.
  + `sequenceNo`— Nomor indeks yang menentukan lokasi blok di dalam untai.
**catatan**  
Kedua dokumen dalam contoh ini memiliki identik `blockAddress` dengan yang sama`sequenceNo`. Karena dokumen-dokumen ini dimasukkan dalam satu transaksi (dan dalam hal ini, dalam satu pernyataan), mereka dilakukan di blok yang sama.
+ `hash`— Nilai hash Ion SHA-256 yang secara unik mewakili revisi dokumen. Hash mencakup revisi `data` dan `metadata` bidang dan dapat digunakan untuk verifikasi [kriptografi](verification.md).
+ `data`— Atribut data pengguna dokumen.

  Jika Anda menyunting revisi, `data` struktur ini digantikan oleh `dataHash` bidang, yang nilainya adalah hash Ion dari struktur yang dihapus. `data`
+ `metadata`— Atribut metadata dokumen.
  + `id`— ID unik yang ditetapkan sistem dari dokumen.
  + `version`— Nomor versi dokumen. Ini adalah bilangan bulat berbasis nol yang bertambah dengan setiap revisi dokumen.
  + `txTime`— Stempel waktu saat revisi dokumen dilakukan pada jurnal.
  + `txId`— ID unik dari transaksi yang melakukan revisi dokumen.

## Bergabung dengan pandangan yang berkomitmen dan pengguna
<a name="working.metadata.committed-joins"></a>

Anda dapat menulis kueri yang bergabung dengan tabel dalam tampilan komited dengan tabel dalam tampilan pengguna. Misalnya, Anda mungkin ingin menggabungkan dokumen `id` dari satu tabel dengan bidang yang ditentukan pengguna dari tabel lain.

Kueri berikut menggabungkan dua tabel bernama `DriversLicense` dan `Person` pada `id` bidang `PersonId` dan dokumen masing-masing, menggunakan tampilan komited untuk yang terakhir.

```
SELECT * FROM DriversLicense AS d INNER JOIN _ql_committed_Person AS p
ON d.PersonId = p.metadata.id
WHERE p.metadata.id = '1CWScY2qHYI9G88C2SjvtH'
```

Untuk mempelajari cara menanyakan bidang ID dokumen dalam tampilan pengguna default, lanjutkan ke[Menggunakan klausa BY untuk menanyakan ID dokumen](working.metadata.by-clause.md).