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

# Menggunakan klausa BY untuk menanyakan ID dokumen
<a name="working.metadata.by-clause"></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.

Meskipun Anda dapat menentukan bidang yang dimaksudkan untuk menjadi pengidentifikasi unik (misalnya, VIN kendaraan), pengidentifikasi unik sebenarnya dari dokumen adalah bidang `id` metadata, seperti yang dijelaskan dalam. [Memasukkan dokumen](working.create.md#working.create.insert) Untuk alasan ini, Anda dapat menggunakan `id` bidang untuk membuat hubungan antar tabel.

`id`Bidang dokumen hanya dapat diakses secara langsung dalam tampilan yang berkomitmen, tetapi Anda juga dapat memproyeksikannya dalam tampilan pengguna default dengan menggunakan `BY` klausa. Sebagai contoh, lihat query berikut dan hasilnya.

```
SELECT r_id, r.VIN, r.LicensePlateNumber, r.State, r.City, r.Owners
FROM VehicleRegistration AS r BY r_id
WHERE r_id = '3Qv67yjXEwB9SjmvkuG6Cp'
```

```
{
    r_id: "3Qv67yjXEwB9SjmvkuG6Cp",
    VIN: "1N4AL11D75C109151",
    LicensePlateNumber: "LEWISR261LL",
    State: "WA",
    City: "Seattle",
    Owners: {
        PrimaryOwner: { PersonId: "294jJ3YUoH1IEEm8GSabOs" },
        SecondaryOwners: [{ PersonId: "5Ufgdlnj06gF5CWcOIu64s" }]
    }
}
```

Dalam query ini, `r_id` adalah alias yang ditentukan pengguna yang dideklarasikan dalam `FROM` klausa, menggunakan kata kunci. `BY` `r_id`Alias ini mengikat bidang `id` metadata untuk setiap dokumen dalam kumpulan hasil kueri. *Anda dapat menggunakan alias ini dalam `SELECT` klausa dan juga dalam `WHERE` klausa kueri dalam tampilan pengguna.*

Namun, untuk mengakses atribut metadata lainnya, Anda harus menanyakan tampilan yang dikomit.

## Bergabung pada ID dokumen
<a name="working.by-clause.joining-on-id"></a>

Misalkan Anda menggunakan dokumen `id` dari satu tabel sebagai kunci asing di bidang yang ditentukan pengguna dari tabel lain. Anda dapat menggunakan `BY` klausa untuk menulis kueri gabungan batin untuk dua tabel pada bidang ini (mirip [Bergabung dengan pandangan yang berkomitmen dan pengguna](working.metadata.md#working.metadata.committed-joins) dengan topik sebelumnya).

Contoh berikut menggabungkan dua tabel bernama `DriversLicense` dan `Person` pada `id` bidang `PersonId` dan dokumen masing-masing, menggunakan `BY` klausa untuk yang terakhir.

```
SELECT * FROM DriversLicense AS d INNER JOIN Person AS p BY pid
ON d.PersonId = pid
WHERE pid = '1CWScY2qHYI9G88C2SjvtH'
```

Untuk mempelajari cara membuat perubahan pada dokumen di tabel Anda, lanjutkan ke[Memperbarui dan menghapus dokumen](working.revisions.md).