Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengakses 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 Buku Besar QLDB Amazon ke Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.
Anda dapat mengakses Amazon QLDB menggunakan Konsol Manajemen AWS,AWS CLI(), AWS Command Line Interface atau QLDB API. Bagian berikut menjelaskan cara menggunakan opsi ini dan prasyarat untuk menggunakannya.
## Prasyarat
Sebelum Anda dapat mengakses QLDB, Anda harus mengatur Akun AWS jika Anda belum melakukannya.
**Topics**
+ [Mendaftar untuk Akun AWS](#sign-up-for-aws)
+ [Buat pengguna dengan akses administratif](#create-an-admin)
+ [Kelola izin QLDB di IAM](#accessing.prereqs.permissions)
+ [Berikan akses terprogram (opsional)](#grant-programmatic-access)
### Mendaftar untuk Akun AWS
Jika Anda tidak memiliki Akun AWS, selesaikan langkah-langkah berikut untuk membuatnya.
**Untuk mendaftar untuk Akun AWS**
1. Buka [https://portal.aws.amazon.com/billing/pendaftaran.](https://portal.aws.amazon.com/billing/signup)
1. Ikuti petunjuk online.
Bagian dari prosedur pendaftaran melibatkan menerima panggilan telepon atau pesan teks dan memasukkan kode verifikasi pada keypad telepon.
Saat Anda mendaftar untuk sebuah Akun AWS, sebuah *Pengguna root akun AWS*dibuat. Pengguna root memiliki akses ke semua Layanan AWS dan sumber daya di akun. Sebagai praktik keamanan terbaik, tetapkan akses administratif ke pengguna, dan gunakan hanya pengguna root untuk melakukan [tugas yang memerlukan akses pengguna root](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks).
AWS mengirimi Anda email konfirmasi setelah proses pendaftaran selesai. Kapan saja, Anda dapat melihat aktivitas akun Anda saat ini dan mengelola akun Anda dengan masuk [https://aws.amazon.com.rproxy.govskope.cake/](https://aws.amazon.com/) dan memilih **Akun Saya**.
### Buat pengguna dengan akses administratif
Setelah Anda mendaftar Akun AWS, amankan Pengguna root akun AWS, aktifkan AWS IAM Identity Center, dan buat pengguna administratif sehingga Anda tidak menggunakan pengguna root untuk tugas sehari-hari.
**Amankan Anda Pengguna root akun AWS**
1. Masuk ke [Konsol Manajemen AWS](https://console.aws.amazon.com/)sebagai pemilik akun dengan memilih **pengguna Root** dan memasukkan alamat Akun AWS email Anda. Di laman berikutnya, masukkan kata sandi.
Untuk bantuan masuk dengan menggunakan pengguna root, lihat [Masuk sebagai pengguna root](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial) di *AWS Sign-In Panduan Pengguna*.
1. Mengaktifkan autentikasi multi-faktor (MFA) untuk pengguna root Anda.
Untuk petunjuk, lihat [Mengaktifkan perangkat MFA virtual untuk pengguna Akun AWS root (konsol) Anda](https://docs.aws.amazon.com/IAM/latest/UserGuide/enable-virt-mfa-for-root.html) di Panduan Pengguna *IAM*.
**Buat pengguna dengan akses administratif**
1. Aktifkan Pusat Identitas IAM.
Untuk mendapatkan petunjuk, silakan lihat [Mengaktifkan AWS IAM Identity Center](https://docs.aws.amazon.com/singlesignon/latest/userguide/get-set-up-for-idc.html) di *Panduan Pengguna AWS IAM Identity Center *.
1. Di Pusat Identitas IAM, berikan akses administratif ke pengguna.
Untuk tutorial tentang menggunakan Direktori Pusat Identitas IAM sebagai sumber identitas Anda, lihat [Mengkonfigurasi akses pengguna dengan default Direktori Pusat Identitas IAM](https://docs.aws.amazon.com/singlesignon/latest/userguide/quick-start-default-idc.html) di *Panduan AWS IAM Identity Center Pengguna*.
**Masuk sebagai pengguna dengan akses administratif**
+ Untuk masuk dengan pengguna Pusat Identitas IAM, gunakan URL masuk yang dikirim ke alamat email saat Anda membuat pengguna Pusat Identitas IAM.
Untuk bantuan masuk menggunakan pengguna Pusat Identitas IAM, lihat [Masuk ke portal AWS akses](https://docs.aws.amazon.com/signin/latest/userguide/iam-id-center-sign-in-tutorial.html) di *Panduan AWS Sign-In Pengguna*.
**Tetapkan akses ke pengguna tambahan**
1. Di Pusat Identitas IAM, buat set izin yang mengikuti praktik terbaik menerapkan izin hak istimewa paling sedikit.
Untuk petunjuknya, lihat [Membuat set izin](https://docs.aws.amazon.com/singlesignon/latest/userguide/get-started-create-a-permission-set.html) di *Panduan AWS IAM Identity Center Pengguna*.
1. Tetapkan pengguna ke grup, lalu tetapkan akses masuk tunggal ke grup.
Untuk petunjuk, lihat [Menambahkan grup](https://docs.aws.amazon.com/singlesignon/latest/userguide/addgroups.html) di *Panduan AWS IAM Identity Center Pengguna*.
### Kelola izin QLDB di IAM
Untuk informasi tentang penggunaan AWS Identity and Access Management (IAM) untuk mengelola izin QLDB bagi pengguna, lihat. [Bagaimana Amazon QLDB bekerja dengan IAM](security_iam_service-with-iam.md)
### Berikan akses terprogram (opsional)
Pengguna membutuhkan akses terprogram jika mereka ingin berinteraksi dengan AWS luar. Konsol Manajemen AWS Cara untuk memberikan akses terprogram tergantung pada jenis pengguna yang mengakses AWS.
Untuk memberi pengguna akses programatis, pilih salah satu opsi berikut.
****
| Pengguna mana yang membutuhkan akses programatis? | Untuk | Oleh |
| --- | --- | --- |
| Identitas tenaga kerja (Pengguna yang dikelola di Pusat Identitas IAM) | Gunakan kredensi sementara untuk menandatangani permintaan terprogram ke AWS CLI,, AWS SDKs atau. AWS APIs | Mengikuti petunjuk untuk antarmuka yang ingin Anda gunakan. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/qldb/latest/developerguide/accessing.html) |
| IAM | Gunakan kredensi sementara untuk menandatangani permintaan terprogram ke AWS CLI,, AWS SDKs atau. AWS APIs | Mengikuti petunjuk dalam [Menggunakan kredensil sementara dengan AWS sumber daya](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html) di Panduan Pengguna IAM. |
| IAM | (Tidak direkomendasikan)Gunakan kredensi jangka panjang untuk menandatangani permintaan terprogram ke AWS CLI,, AWS SDKs atau. AWS APIs | Mengikuti petunjuk untuk antarmuka yang ingin Anda gunakan. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/qldb/latest/developerguide/accessing.html) |
## Cara mengakses Amazon QLDB
Setelah menyelesaikan prasyarat untuk menyiapkan Akun AWS, lihat topik berikut untuk mempelajari lebih lanjut tentang cara mengakses QLDB:
+ [Menggunakan konsol](console_QLDB.md)
+ [Menggunakan AWS CLI (hanya API manajemen)](Tools.CLI.md)
+ [Menggunakan shell QLDB Amazon (hanya API data)](data-shell.md)
+ [Menggunakan API](Using.API.md)
# Mengakses Amazon QLDB menggunakan konsol
**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.
[Anda dapat mengakses Konsol Manajemen AWS untuk Amazon QLDB https://console.aws.amazon.com di/qldb.](https://console.aws.amazon.com/qldb)
Anda dapat menggunakan konsol untuk melakukan hal berikut di QLDB:
+ Buat, hapus, jelaskan, dan buat daftar buku besar.
+ *Jalankan pernyataan [PartiQL](ql-reference.md) dengan menggunakan editor PartiQL.*
+ Kelola tag untuk sumber daya QLDB.
+ Verifikasi data jurnal secara kriptografis.
+ Ekspor atau streaming blok jurnal.
Untuk mempelajari cara membuat buku besar QLDB Amazon dan mengaturnya dengan contoh data aplikasi, lihat. [Memulai dengan konsol QLDB Amazon](getting-started.md)
## Referensi cepat editor PartiQL
**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.
Amazon QLDB mendukung subset [PartiQL](https://partiql.org/) sebagai bahasa kueri [dan](http://amzn.github.io/ion-docs/) Amazon Ion sebagai format data berorientasi dokumen. Untuk panduan lengkap dan informasi lebih rinci tentang implementasi QLDB dari PartiQL, lihat. [Referensi PartiQL Amazon QLDB](ql-reference.md)
Topik berikut memberikan ikhtisar referensi singkat tentang cara menggunakan PartiQL di QLDB.
**Topics**
+ [Tips cepat PartiQL di QLDB](#partiql-editor-ref-tips)
+ [Commands](#partiql-editor-ref-commands)
+ [Tampilan yang ditentukan sistem](#partiql-editor-ref-views)
+ [Aturan sintaks dasar](#partiql-editor-ref-syntax)
+ [Pintasan keyboard editor PartiQL](#console_QLDB.partiql-editor-shortcuts)
### Tips cepat PartiQL di QLDB
Berikut ini adalah ringkasan singkat tips dan praktik terbaik untuk bekerja dengan PartiQL di QLDB:
+ **Memahami batas konkurensi dan transaksi** — Semua pernyataan, termasuk `SELECT` kueri, tunduk pada konflik dan batas transaksi [kontrol konkurensi optimis (OCC)](concurrency.md), termasuk [batas waktu transaksi 30](limits.md#limits.fixed) detik.
+ **Gunakan indeks — Gunakan indeks** kardinalitas tinggi dan jalankan kueri yang ditargetkan untuk mengoptimalkan pernyataan Anda dan menghindari pemindaian tabel lengkap. Untuk mempelajari selengkapnya, lihat [Mengoptimalkan kinerja kueri](working.optimize.md).
+ **Gunakan predikat kesetaraan** *— Pencarian yang diindeks memerlukan operator kesetaraan (atau).* `=` `IN` Operator ketidaksetaraan (`<`,`>`,`LIKE`,`BETWEEN`) tidak memenuhi syarat untuk pencarian yang diindeks dan menghasilkan pemindaian tabel lengkap.
+ **Gunakan sambungan batin saja — QLDB hanya** mendukung sambungan batin. Sebagai praktik terbaik, bergabunglah di bidang yang diindeks untuk setiap tabel yang Anda ikuti. Pilih indeks kardinalitas tinggi untuk kriteria gabungan dan predikat kesetaraan.
### Commands
QLDB mendukung perintah PartiQL berikut.
**Bahasa definisi data (DDL)**
| Perintah | Deskripsi |
| --- | --- |
| [CREATE INDEX](ql-reference.create-index.md) | Membuat indeks untuk bidang dokumen tingkat atas di atas meja. |
| [CREATE TABLE](ql-reference.create-table.md) | Membuat tabel. |
| [DROP INDEX](ql-reference.drop-index.md) | Menghapus indeks dari tabel. |
| [MEJA DROP](ql-reference.drop-table.md) | Menonaktifkan tabel yang ada. |
| [BUKA TABEL](ql-reference.undrop-table.md) | Mengaktifkan kembali tabel yang tidak aktif. |
**Bahasa manipulasi data (DML)**
| Perintah | Deskripsi |
| --- | --- |
| [HAPUS](ql-reference.delete.md) | Menandai dokumen aktif sebagai dihapus dengan membuat revisi akhir dokumen yang baru. |
| [DARI (MASUKKAN, HAPUS, atau ATUR)](ql-reference.from.md) | Secara semantik sama seperti. UPDATE |
| [INSERT](ql-reference.insert.md) | Menambahkan satu atau lebih [dokumen](ql-reference.docs.md) ke tabel. |
| [SELECT](ql-reference.select.md) | Mengambil data dari satu atau lebih tabel. |
| [UPDATE](ql-reference.update.md) | Memperbarui, menyisipkan, atau menghapus elemen tertentu dalam dokumen. |
#### Contoh pernyataan DML
**SISIPKAN**
```
INSERT INTO VehicleRegistration VALUE
{
'VIN' : 'KM8SRDHF6EU074761', --string
'RegNum' : 1722, --integer
'PendingPenaltyTicketAmount' : 130.75, --decimal
'Owners' : { --nested struct
'PrimaryOwner' : { 'PersonId': '294jJ3YUoH1IEEm8GSabOs' },
'SecondaryOwners' : [ --list of structs
{ 'PersonId' : '1nmeDdLo3AhGswBtyM1eYh' },
{ 'PersonId': 'IN7MvYtUjkp1GMZu0F6CG9' }
]
},
'ValidToDate' : `2020-06-25T` --Ion timestamp literal with day precision
}
```
**PEMBARUAN-SISIPKAN**
```
UPDATE Vehicle AS v
INSERT INTO v VALUE 26500 AT 'Mileage'
WHERE v.VIN = '1N4AL11D75C109151'
```
**UPDATE-HAPUS**
```
UPDATE Person AS p
REMOVE p.Address
WHERE p.GovId = '111-22-3333'
```
**PILIH - Subquery berkorelasi**
```
SELECT r.VIN, o.SecondaryOwners
FROM VehicleRegistration AS r, @r.Owners AS o
WHERE r.VIN IN ('1N4AL11D75C109151', 'KM8SRDHF6EU074761')
```
**PILIH - Gabung batin**
```
SELECT v.Make, v.Model, r.Owners
FROM VehicleRegistration AS r INNER JOIN Vehicle AS v
ON r.VIN = v.VIN
WHERE r.VIN IN ('1N4AL11D75C109151', 'KM8SRDHF6EU074761')
```
**PILIH - Dapatkan ID dokumen menggunakan klausa BY**
```
SELECT r_id FROM VehicleRegistration AS r BY r_id
WHERE r.VIN = '1HVBBAANXWH544237'
```
### Tampilan yang ditentukan sistem
QLDB mendukung tampilan tabel yang ditentukan sistem berikut.
| Tayang | Deskripsi |
| --- | --- |
| table\$1name | [Tampilan pengguna](working.userdata.md) default dari tabel yang menyertakan status data pengguna Anda saat ini saja. |
| \$1ql\$1committed\$1table\$1name | [Tampilan komit](working.metadata.md) lengkap yang ditentukan sistem dari tabel yang menyertakan status saat ini dari data pengguna dan metadata yang dihasilkan sistem, seperti ID dokumen. |
| history(table\$1name) | [Fungsi riwayat](working.history.md) bawaan yang mengembalikan riwayat revisi lengkap tabel. |
### Aturan sintaks dasar
QLDB mendukung aturan sintaks dasar berikut untuk PartiQL.
| Karakter | Deskripsi |
| --- | --- |
| ' | Tanda kutip tunggal menunjukkan nilai string, atau nama bidang dalam struktur Amazon Ion. |
| " | Tanda kutip ganda menunjukkan pengidentifikasi yang dikutip, seperti [kata cadangan](ql-reference.reserved.md) yang digunakan sebagai nama tabel. |
| ` | Backticks menunjukkan nilai literal Ion. |
| . | Notasi titik mengakses nama bidang struktur induk. |
| [ ] | Tanda kurung siku mendefinisikan Ionlist, atau menunjukkan nomor urut berbasis nol untuk daftar yang ada. |
| \$1 \$1 | Kurung kurawal mendefinisikan Ion. struct |
| << >> | Kurung sudut ganda menentukan tas PartiQL, yang merupakan koleksi yang tidak berurutan. Anda menggunakan tas untuk memasukkan beberapa dokumen ke dalam tabel. |
| Sensitivitas kasus | Semua nama objek sistem QLDB — termasuk nama bidang dan nama tabel — peka huruf besar/kecil. |
### Pintasan keyboard editor PartiQL
Editor *PartiQL di konsol QLDB* mendukung pintasan keyboard berikut.
| Tindakan | macOS | Windows |
| --- | --- | --- |
| Jalankan . | Cmd\$1Return | Ctrl\$1Enter |
| Komentar | Cmd\$1/ | Ctrl\$1/ |
| Jelas | Cmd\$1Shift\$1Delete | Ctrl\$1Shift\$1Delete |
# Mengakses Amazon QLDB menggunakan (hanya API manajemen AWS CLI )
**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.
Anda dapat menggunakan AWS Command Line Interface (AWS CLI) untuk mengontrol beberapa Layanan AWS dari baris perintah dan mengotomatiskannya melalui skrip. Anda dapat menggunakan AWS CLI untuk operasi satu kali sesuai kebutuhan. Anda juga dapat menggunakannya untuk menyematkan operasi QLDB Amazon dalam skrip utilitas.
Untuk akses CLI, Anda memerlukan ID kunci akses dan kunci akses rahasia. Gunakan kredensi sementara alih-alih kunci akses jangka panjang jika memungkinkan. Kredensi sementara mencakup ID kunci akses, kunci akses rahasia, dan token keamanan yang menunjukkan kapan kredensialnya kedaluwarsa. Untuk informasi selengkapnya, lihat [Menggunakan kredensil sementara dengan AWS sumber daya](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html) di Panduan Pengguna *IAM*.
[Untuk daftar lengkap dan contoh penggunaan semua perintah yang tersedia untuk QLDB di, lihat AWS CLI Referensi AWS CLI Perintah.](https://docs.aws.amazon.com/cli/latest/reference/qldb/index.html)
**catatan**
AWS CLI Satu-satunya mendukung operasi API `qldb` manajemen yang tercantum dalam[Referensi API QLDB Amazon](api-reference.md). API ini hanya digunakan untuk mengelola sumber daya buku besar dan untuk operasi data non-transaksional.
Untuk menjalankan transaksi data dengan `qldb-session` API menggunakan antarmuka baris perintah, lihat[Mengakses Amazon QLDB menggunakan shell QLDB (hanya API data)](data-shell.md).
**Topics**
+ [Menginstal dan mengkonfigurasi AWS CLI](#Tools.CLI.InstallingAndConfiguring)
+ [Menggunakan AWS CLI dengan QLDB](#Tools.CLI.UsingWithQLDB)
## Menginstal dan mengkonfigurasi AWS CLI
AWS CLI Berjalan di Linux, macOS, atau Windows. Untuk menginstal dan mengonfigurasinya, lihat petunjuk berikut di *Panduan AWS Command Line Interface Pengguna*:
1. [Menginstal atau memperbarui versi terbaru dari AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)
1. [Pengaturan cepat](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-quickstart.html)
## Menggunakan AWS CLI dengan QLDB
Format baris perintah terdiri dari nama operasi Amazon QLDB, diikuti oleh parameter untuk operasi itu. AWS CLI Mendukung sintaks singkatan untuk nilai parameter, selain JSON.
Gunakan `help` untuk mencantumkan semua perintah yang tersedia di QLDB:
```
aws qldb help
```
Anda juga dapat menggunakan `help` untuk mendeskripsikan perintah tertentu dan mempelajari lebih lanjut tentang penggunaannya:
```
aws qldb create-ledger help
```
Misalnya, untuk membuat buku besar:
```
aws qldb create-ledger --name my-example-ledger --permissions-mode STANDARD
```
# Mengakses Amazon QLDB menggunakan shell QLDB (hanya API data)
**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.
Amazon QLDB menyediakan shell baris perintah untuk interaksi dengan API data transaksional. Dengan shell QLDB, Anda dapat menjalankan pernyataan [PartiQL](ql-reference.md) pada data buku besar.
Versi terbaru dari shell ini ditulis dalam Rust dan open source di GitHub repositori [amazon-qldb-shellawslabs/](https://github.com/awslabs/amazon-qldb-shell) di cabang default. `main` Versi Python (v1) juga masih tersedia untuk digunakan di repositori yang sama di cabang. `master`
**catatan**
Shell QLDB Amazon hanya mendukung API data transaksional`qldb-session`. API ini hanya digunakan untuk menjalankan pernyataan PartiQL pada buku besar QLDB.
Untuk berinteraksi dengan operasi API `qldb` manajemen menggunakan antarmuka baris perintah, lihat[Mengakses Amazon QLDB menggunakan (hanya API manajemen AWS CLI )](Tools.CLI.md).
Alat ini tidak dimaksudkan untuk dimasukkan ke dalam aplikasi atau diadopsi untuk tujuan produksi. Tujuan dari alat ini adalah untuk memungkinkan Anda bereksperimen dengan cepat dengan QLDB dan PartiQL.
Bagian berikut menjelaskan cara memulai dengan shell QLDB.
**Topics**
+ [Prasyarat](#data-shell-prerequisites)
+ [Memasang shell](#data-shell-install)
+ [Memanggil shell](#data-shell-invoking)
+ [Parameter shell](#data-shell-params)
+ [Referensi perintah](#data-shell-reference)
+ [Menjalankan pernyataan individu](#data-shell-indiv-statements)
+ [Mengelola transaksi](#data-shell-transactions)
+ [Keluar dari cangkang](#data-shell-exiting)
+ [Contoh](#data-shell-examples)
## Prasyarat
Sebelum Anda memulai dengan shell QLDB, Anda harus melakukan hal berikut:
1. Ikuti instruksi AWS pengaturan di[Mengakses Amazon QLDB](accessing.md). Ini termasuk yang berikut:
1. Mendaftar untuk AWS.
1. Buat pengguna dengan izin QLDB yang sesuai.
1. Memberikan akses terprogram untuk pengembangan.
1. Siapkan AWS kredensil Anda dan default Anda. Wilayah AWS Untuk petunjuk, lihat [Dasar-dasar konfigurasi](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html) di *Panduan AWS Command Line Interface Pengguna*.
Untuk daftar lengkap Wilayah yang tersedia, lihat [titik akhir dan kuota Amazon QLDB](https://docs.aws.amazon.com/general/latest/gr/qldb.html) di bagian. *Referensi Umum AWS*
1. Untuk buku besar apa pun dalam mode `STANDARD` izin, buat kebijakan IAM yang memberi Anda izin untuk menjalankan pernyataan PartiQL pada tabel yang sesuai. Untuk mempelajari cara membuat kebijakan ini, lihat[Memulai dengan mode izin standar di Amazon QLDB](getting-started-standard-mode.md).
## Memasang shell
Untuk menginstal versi terbaru dari shell QLDB, lihat file README.md [di.](https://github.com/awslabs/amazon-qldb-shell/blob/main/README.md#installation) GitHub [QLDB menyediakan file biner pra-bangun untuk Linux, macOS, dan Windows di bagian Rilis repositori.](https://github.com/awslabs/amazon-qldb-shell/releases) GitHub
[Untuk macOS, shell terintegrasi dengan keran Homebrew. `aws/tap`](https://docs.brew.sh/) Untuk menginstal shell di macOS menggunakan Homebrew, jalankan perintah berikut.
```
$ xcode-select --install # Required to use Homebrew
$ brew tap aws/tap # Add AWS as a Homebrew tap
$ brew install qldbshell
```
### Konfigurasi
Setelah instalasi, shell memuat file konfigurasi default yang terletak di `$XDG_CONFIG_HOME/qldbshell/config.ion` selama inisialisasi. Di Linux dan macOS, file ini biasanya di. `~/.config/qldbshell/config.ion` Jika file seperti itu tidak ada, shell berjalan dengan pengaturan default.
Anda dapat membuat `config.ion` file secara manual setelah instalasi. File konfigurasi ini menggunakan format data [Amazon Ion](ion.md). Berikut ini adalah contoh `config.ion` file minimal.
```
{
default_ledger: "my-example-ledger"
}
```
Jika `default_ledger` tidak diatur dalam file konfigurasi Anda, `--ledger` parameter diperlukan saat Anda memanggil shell. Untuk daftar lengkap opsi konfigurasi, lihat file [README.md](https://github.com/awslabs/amazon-qldb-shell/blob/main/README.md#configuration) di. GitHub
## Memanggil shell
Untuk memanggil shell QLDB pada terminal baris perintah Anda untuk buku besar tertentu, jalankan perintah berikut. Ganti *my-example-ledger* dengan nama buku besar Anda.
```
$ qldb --ledger my-example-ledger
```
Perintah ini terhubung ke default Anda Wilayah AWS. Untuk secara eksplisit menentukan Wilayah, Anda dapat menjalankan perintah dengan `--qldb-session-endpoint` parameter `--region` or, seperti yang dijelaskan di bagian berikut.
Setelah menjalankan sesi `qldb` shell, Anda dapat memasukkan jenis input berikut:
+ [Perintah Shell](#data-shell-reference)
+ [Pernyataan PartiQL tunggal dalam transaksi terpisah](#data-shell-indiv-statements)
+ [Beberapa pernyataan PartiQL dalam transaksi](#data-shell-transactions)
## Parameter shell
Untuk daftar lengkap flag dan opsi yang tersedia untuk menjalankan shell, jalankan `qldb` perintah dengan `--help` bendera, sebagai berikut.
```
$ qldb --help
```
Berikut ini adalah beberapa tanda kunci dan opsi untuk `qldb` perintah. Anda dapat menambahkan parameter opsional ini untuk mengganti Wilayah AWS, profil kredensial, titik akhir, format hasil, dan opsi konfigurasi lainnya.
**Penggunaan**
```
$ qldb [FLAGS] [OPTIONS]
```BENDERA
**`-h`, `--help`**
Mencetak informasi bantuan.
**`-v`, `--verbose`**
Mengkonfigurasi verbositas logging. Secara default, shell hanya mencatat kesalahan. Untuk meningkatkan tingkat verbositas, ulangi argumen ini (misalnya,`-vv`). Tingkat tertinggi adalah `-vvv` yang sesuai dengan `trace` verbositas.
**`-V`, `--version`**
Mencetak informasi versi.OPSI
**`-l`, `--ledger` *LEDGER\$1NAME***
Nama buku besar untuk terhubung ke. Ini adalah parameter shell yang diperlukan jika `default_ledger` tidak diatur dalam `config.ion` file Anda. Dalam file ini, Anda dapat mengatur opsi tambahan, seperti Wilayah.
**`-c`, `--config` *CONFIG\$1FILE***
File tempat Anda dapat menentukan opsi konfigurasi shell apa pun. Untuk detail pemformatan dan daftar lengkap opsi konfigurasi, lihat file [README.md](https://github.com/awslabs/amazon-qldb-shell/blob/main/README.md#configuration) aktif. GitHub
**`-f`, `--format` `ion|table`**
Format output hasil kueri Anda. Default-nya adalah `ion`.
**`-p`, `--profile` *PROFILE***
Lokasi profil AWS kredensyal Anda yang akan digunakan untuk otentikasi.
Jika tidak disediakan, shell menggunakan AWS profil default Anda, yang terletak di`~/.aws/credentials`.
**`-r`, `--region` *REGION\$1CODE***
Wilayah AWS Kode buku besar QLDB untuk terhubung ke. Sebagai contoh: `us-east-1`.
Jika tidak disediakan, shell terhubung ke default Anda Wilayah AWS seperti yang ditentukan dalam AWS profil Anda.
**`-s`, `--qldb-session-endpoint` *QLDB\$1SESSION\$1ENDPOINT***
Titik akhir `qldb-session` API untuk terhubung.
Untuk daftar lengkap Wilayah QLDB dan titik akhir yang tersedia, lihat titik akhir dan kuota [QLDB Amazon](https://docs.aws.amazon.com/general/latest/gr/qldb.html) di. *Referensi Umum AWS*
## Referensi perintah
Setelah Anda menjalankan `qldb` sesi, shell mendukung kunci dan perintah database berikut:
**Kunci Shell**
| Kunci | Deskripsi fungsi |
| --- | --- |
| Enter | Menjalankan pernyataan. |
| Escape\$1 Enter (macOS, Linux) Shift\$1 Enter (Windows) | Memulai baris baru untuk memasukkan pernyataan yang mencakup beberapa baris. Anda juga dapat menyalin teks input dengan beberapa baris dan menempelkannya ke shell. Untuk petunjuk tentang pengaturan, Option bukan Escape sebagai kunci Meta di macOS, lihat situs [OS X Daily](https://osxdaily.com/2013/02/01/use-option-as-meta-key-in-mac-os-x-terminal/). |
| Ctrl\$1C | Membatalkan perintah saat ini. |
| Ctrl\$1D | Sinyal akhir file (EOF) dan keluar dari level shell saat ini. Jika tidak dalam transaksi aktif, keluar dari shell. Dalam transaksi aktif, membatalkan transaksi. |
**Perintah basis data Shell**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/qldb/latest/developerguide/data-shell.html)
**catatan**
Semua perintah shell QLDB tidak peka huruf besar/kecil.
## Menjalankan pernyataan individu
Kecuali untuk perintah database dan perintah meta shell yang tercantum dalam [README.md](https://github.com/awslabs/amazon-qldb-shell/blob/main/README.md#command-interface), shell menafsirkan setiap perintah yang Anda masukkan sebagai pernyataan PartiQL terpisah. Secara default, shell mengaktifkan `auto-commit` mode. Mode ini dapat dikonfigurasi.
Dalam `auto-commit` mode, shell secara implisit menjalankan setiap pernyataan dalam transaksinya sendiri dan secara otomatis melakukan transaksi jika tidak ada kesalahan yang ditemukan. Ini berarti bahwa Anda tidak harus menjalankan `start transaction` (atau`begin`) dan `commit` secara manual setiap kali Anda menjalankan pernyataan.
## Mengelola transaksi
Atau, shell QLDB memungkinkan Anda mengontrol transaksi secara manual. Anda dapat menjalankan beberapa pernyataan dalam transaksi secara interaktif, atau non-interaktif dengan mengelompokkan perintah dan pernyataan secara berurutan.
### Transaksi interaktif
Untuk menjalankan transaksi interaktif, lakukan langkah-langkah berikut.
1. Untuk memulai transaksi, masukkan `begin` perintah.
```
qldb> begin
```
Setelah Anda memulai transaksi, shell menampilkan command prompt berikut.
```
qldb *>
```
1. Kemudian, setiap pernyataan yang Anda masukkan berjalan dalam transaksi yang sama.
+ Misalnya, Anda dapat menjalankan satu pernyataan sebagai berikut.
```
qldb *> SELECT * FROM Vehicle WHERE VIN = '1N4AL11D75C109151'
```
Setelah Anda menekanEnter, shell menampilkan hasil pernyataan.
+ Anda juga dapat memasukkan beberapa pernyataan atau perintah yang dipisahkan oleh pembatas titik koma (`;`) sebagai berikut.
```
qldb *> SELECT * FROM Vehicle WHERE VIN = '1N4AL11D75C109151'; commit
```
1. Untuk mengakhiri transaksi, masukkan salah satu perintah berikut.
+ Masukkan `commit` perintah untuk melakukan transaksi Anda ke jurnal buku besar.
```
qldb *> commit
```
+ Masukkan `abort` perintah untuk menghentikan transaksi Anda dan menolak setiap perubahan yang Anda buat.
```
qldb *> abort
transaction was aborted
```
**Batas batas waktu transaksi**
Transaksi interaktif mematuhi batas batas waktu [transaksi](limits.md#limits.fixed) QLDB. Jika Anda tidak melakukan transaksi dalam waktu **30 detik** sejak memulainya, QLDB secara otomatis akan kedaluwarsa transaksi dan menolak setiap perubahan yang dilakukan selama transaksi.
Kemudian, alih-alih menampilkan hasil pernyataan, shell menampilkan pesan kesalahan kedaluwarsa dan kembali ke prompt perintah normal. Untuk mencoba lagi, Anda harus memasukkan `begin` perintah lagi untuk memulai transaksi baru.
```
transaction failed after 1 attempts, last error: communication failure: Transaction 2UMpiJ5hh7WLjVgEiMLOoO has expired
```
### Transaksi non-interaktif
Anda dapat menjalankan transaksi lengkap dengan beberapa pernyataan dengan mengelompokkan perintah dan pernyataan secara berurutan sebagai berikut.
```
qldb> begin; SELECT * FROM Vehicle WHERE VIN = '1N4AL11D75C109151'; SELECT * FROM Person p, DriversLicense l WHERE p.GovId = l.LicenseNumber; commit
```
Anda harus memisahkan setiap perintah dan pernyataan dengan pembatas titik koma ()`;`. Jika ada pernyataan dalam transaksi yang tidak valid, shell secara otomatis menolak transaksi. Shell tidak melanjutkan dengan pernyataan berikutnya yang Anda masukkan.
Anda juga dapat mengatur beberapa transaksi.
```
qldb> begin; statement1; commit; begin; statement2; statement3; commit
```
Mirip dengan contoh sebelumnya, jika transaksi gagal, shell tidak melanjutkan transaksi atau pernyataan berikutnya yang Anda masukkan.
Jika Anda tidak mengakhiri transaksi, shell beralih ke mode interaktif dan meminta Anda untuk perintah atau pernyataan berikutnya.
```
qldb> begin; statement1; commit; begin
qldb *>
```
## Keluar dari cangkang
Untuk keluar dari sesi `qldb` shell saat ini, masukkan `quit` perintah `exit` or, atau gunakan pintasan Ctrl D keyboard\$1saat shell tidak dalam transaksi.
```
qldb> exit
$
```
```
qldb> quit
$
```
## Contoh
Untuk informasi tentang menulis pernyataan PartiQL di QLDB, lihat. [Referensi PartiQL Amazon QLDB](ql-reference.md)
**Example**
Contoh berikut menunjukkan urutan umum perintah dasar.
Shell QLDB menjalankan setiap pernyataan PartiQL dalam contoh ini dalam transaksinya sendiri.
Contoh ini mengasumsikan bahwa buku besar `test-ledger` sudah ada dan aktif.
```
$ qldb --ledger test-ledger --region us-east-1
qldb> CREATE TABLE TestTable
qldb> INSERT INTO TestTable `{"Name": "John Doe"}`
qldb> SELECT * FROM TestTable
qldb> DROP TABLE TestTable
qldb> exit
```
# Mengakses Amazon QLDB menggunakan API
**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.
Anda dapat menggunakan Konsol Manajemen AWS dan AWS Command Line Interface (AWS CLI) untuk bekerja secara interaktif dengan Amazon QLDB. Namun, untuk mendapatkan hasil maksimal dari QLDB, Anda dapat menulis kode aplikasi dengan driver QLDB atau SDK untuk berinteraksi dengan buku besar Anda AWS menggunakan. APIs
Driver memungkinkan aplikasi Anda berinteraksi dengan QLDB menggunakan API data transaksional*.* AWS SDK mendukung interaksi dengan API manajemen sumber daya *QLDB*. Untuk informasi lebih lanjut tentang ini APIs, lihat[Referensi API QLDB Amazon](api-reference.md).
[Driver menyediakan dukungan untuk QLDB [di](https://aws.amazon.com/sdk-for-java) Java[, .NET, Go,](https://aws.amazon.com/sdk-for-net) Node.js[,](https://aws.amazon.com/sdk-for-go) dan [Python](https://aws.amazon.com/sdk-for-node-js).](https://aws.amazon.com/sdk-for-python) Untuk segera memulai dengan bahasa ini, lihat [Memulai dengan driver QLDB Amazon](getting-started-driver.md).
Sebelum Anda dapat menggunakan driver QLDB atau SDK dalam aplikasi Anda, Anda harus AWS memberikan akses terprogram. Lihat informasi yang lebih lengkap di [Memberikan akses programatis](accessing.md#grant-programmatic-access).