Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memulai dengan Aurora DSQL
Amazon Aurora DSQL adalah database relasional tanpa server, dikelola sepenuhnya, dan terdistribusi yang dioptimalkan untuk beban kerja transaksional. Di bagian berikut, Anda akan belajar cara membuat kluster DSQL Aurora wilayah tunggal dan Multi-wilayah, menghubungkannya, dan membuat serta memuat skema sampel. Anda akan mengakses cluster dengan AWS Konsol dan secara opsional berinteraksi dengan database Anda menggunakan klien PostgreSQL lainnya. Pada akhirnya, Anda akan memiliki cluster Aurora DSQL yang berfungsi yang siap digunakan untuk beban kerja pengujian atau produksi.
**Topics**
+ [Prasyarat](#getting-started-prereqs)
+ [Langkah 1: Buat cluster Aurora DSQL Single-region](#getting-started-create-cluster)
+ [Langkah 2: Connect ke cluster Aurora DSQL Anda](#connect-dsql-cluster)
+ [Langkah 3: Jalankan contoh perintah SQL di Aurora DSQL](#getting-started-sql)
+ [Langkah 4 (Opsional): Buat cluster Multi-region](#getting-started-multi-region)
+ [Pemecahan masalah](#getting-started-sql-troubleshooting)
## Prasyarat
Sebelum Anda dapat mulai menggunakan Aurora DSQL, pastikan Anda memenuhi prasyarat berikut:
+ Identitas IAM Anda harus memiliki izin untuk [masuk ke konsol](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html).
+ Identitas IAM Anda harus memenuhi kriteria berikut:
+ Akses untuk melakukan tindakan apa pun pada sumber daya apa pun di Akun AWS
+ `AmazonAuroraDSQLConsoleFullAccess` AWS kebijakan terkelola [terlampir](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonAuroraDSQLConsoleFullAccess.html).
## Langkah 1: Buat cluster Aurora DSQL Single-region
Unit dasar Aurora DSQL adalah cluster, yang merupakan tempat Anda menyimpan data Anda. Dalam tugas ini, Anda membuat cluster dalam satu Wilayah AWS.
**Untuk membuat cluster Single-region di Aurora DSQL**
1. Masuk ke Konsol Manajemen AWS dan buka konsol Aurora DSQL di. [https://console.aws.amazon.com/dsql](https://console.aws.amazon.com/dsql)
1. Pilih **Buat cluster** dan kemudian **Single-Region**.
1. (Opsional) mengubah nilai tag **Nama** default.
1. (Opsional) Tambahkan **Tag** tambahan untuk cluster ini.
1. (Opsional) Dalam **pengaturan Cluster**, pilih salah satu opsi berikut:
+ Pilih **Sesuaikan pengaturan enkripsi (lanjutan)** untuk memilih atau membuat AWS KMS key. Jika Anda menggunakan kunci yang dikelola pelanggan, pastikan bahwa kebijakan kunci memberikan Aurora DSQL izin yang diperlukan. Untuk informasi selengkapnya, lihat [Kebijakan kunci untuk kunci yang dikelola pelanggan](data-encryption.md#key-policy-customer-managed-key).
+ Pilih **Aktifkan perlindungan penghapusan** untuk mencegah operasi penghapusan klaster Anda. Secara default, perlindungan penghapusan dipilih.
+ Pilih **Kebijakan berbasis sumber daya (lanjutan) untuk menentukan kebijakan** kontrol akses untuk klaster ini.
1. Pilih **Buat klaster**.
1. Konsol mengembalikan Anda ke halaman **Clusters**. Spanduk notifikasi muncul yang menunjukkan bahwa cluster sedang dibuat. Pilih **ID Cluster** untuk membuka tampilan detail cluster.
## Langkah 2: Connect ke cluster Aurora DSQL Anda
Aurora DSQL mendukung beberapa cara untuk terhubung ke cluster Anda, termasuk DSQL Query Editor, klien psql lokal AWS CloudShell, dan alat lain yang kompatibel dengan PostgreSQL. Pada langkah ini, Anda terhubung menggunakan [Aurora DSQL Query Editor](https://docs.aws.amazon.com/aurora-dsql/latest/userguide/getting-started-query-editor.html), yang menyediakan cara cepat untuk mulai berinteraksi dengan cluster baru Anda.
**Untuk terhubung menggunakan Query Editor**
1. Di Aurora DSQL Console ([https://console.aws.amazon.com/dsql](https://console.aws.amazon.com/dsql)), buka halaman **Clusters** dan konfirmasikan bahwa pembuatan cluster Anda telah selesai dan statusnya Aktif.
1. Pilih klaster Anda dari daftar, atau pilih **ID Cluster** untuk membuka halaman detail Cluster.
1. Pilih **Connect with Query editor**.
1. Pilih Connect sebagai **admin** untuk cluster yang baru saja dibuat.
+ Secara opsional Anda dapat terhubung dengan peran khusus, lihat[Menggunakan peran database dan otentikasi IAM](using-database-and-iam-roles.md).
## Langkah 3: Jalankan contoh perintah SQL di Aurora DSQL
Uji cluster Aurora DSQL Anda dengan menjalankan pernyataan SQL. Setelah membuka cluster di Query Editor, pilih dan jalankan setiap contoh query langkah demi langkah.
**Jalankan contoh perintah SQL di Aurora DSQL**
1. Buat skema bernama`test`.
```
CREATE SCHEMA IF NOT EXISTS test;
```
1. Buat tabel hello\$1world yang menggunakan UUID yang dihasilkan secara otomatis sebagai kunci utama.
```
CREATE TABLE IF NOT EXISTS test.hello_world (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
message VARCHAR(255) NOT NULL,
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
```
1. Masukkan baris sampel.
```
INSERT INTO test.hello_world (message)
VALUES ('Hello, World!!');
```
1. Baca nilai yang dimasukkan.
```
SELECT * FROM test.hello_world;
```
1. Bersihkan secara opsional
```
DROP TABLE test.hello_world;
DROP SCHEMA test;
```
## Langkah 4 (Opsional): Buat cluster Multi-region
Saat Anda membuat cluster Multi-region, Anda menentukan Wilayah berikut:
**Wilayah Terpencil**
Ini adalah Wilayah tempat Anda membuat cluster kedua. Anda membuat cluster kedua di Region ini dan mengintip ke cluster awal Anda. Aurora DSQL mereplikasi semua penulisan pada cluster awal ke cluster jarak jauh. Anda dapat membaca dan menulis di cluster mana pun.
**Wilayah Saksi**
Wilayah ini menerima semua data yang ditulis ke cluster Multi-region. Namun, Wilayah saksi tidak meng-host titik akhir klien dan tidak menyediakan akses data pengguna. Jendela terbatas dari log transaksi terenkripsi dipertahankan di Wilayah saksi. Log ini memfasilitasi pemulihan dan mendukung kuorum transaksional jika suatu Wilayah menjadi tidak tersedia.
Gunakan prosedur berikut untuk membuat cluster awal, membuat cluster kedua di Region yang berbeda, dan kemudian mengintip dua cluster untuk membuat cluster Multi-region. Ini juga menunjukkan replikasi penulisan lintas wilayah dan pembacaan yang konsisten dari kedua titik akhir Regional.
**Untuk membuat cluster Multi-region**
1. Masuk ke konsol [Aurora DSQL](https://console.aws.amazon.com/dsql).
1. Pada panel navigasi, silakan pilih **Klaster**.
1. Pilih **Buat cluster** dan kemudian **Multi-Region**.
1. (Opsional) mengubah nilai tag **Nama** default.
1. (Opsional) Tambahkan **Tag** tambahan untuk cluster ini.
1. Di **pengaturan Multi-Region**, pilih opsi berikut untuk klaster awal Anda:
+ Di **Wilayah Saksi**, pilih Wilayah. Saat ini, hanya Wilayah yang berbasis di AS yang didukung untuk menyaksikan Wilayah di klaster Multi-wilayah.
+ (Opsional) Di **ARN cluster Remote Region**, masukkan ARN untuk cluster yang ada di Wilayah lain. Jika tidak ada klaster yang berfungsi sebagai klaster kedua di klaster Multi-region Anda, selesaikan penyiapan setelah Anda membuat klaster awal.
1. (Opsional) Dalam **pengaturan Cluster**, pilih salah satu opsi berikut untuk klaster awal Anda:
+ Pilih **Sesuaikan pengaturan enkripsi (lanjutan)** untuk memilih atau membuat AWS KMS key. Jika Anda menggunakan kunci yang dikelola pelanggan, pastikan bahwa kebijakan kunci memberikan Aurora DSQL izin yang diperlukan. Untuk informasi selengkapnya, lihat [Kebijakan kunci untuk kunci yang dikelola pelanggan](data-encryption.md#key-policy-customer-managed-key).
+ Pilih **Aktifkan perlindungan penghapusan** untuk mencegah operasi penghapusan klaster Anda. Secara default, perlindungan penghapusan dipilih.
+ Pilih **Kebijakan berbasis sumber daya (lanjutan) untuk menentukan kebijakan** kontrol akses untuk klaster ini.
1. Pilih **Buat cluster** untuk membuat klaster awal Anda. Jika Anda tidak memasukkan ARN pada langkah sebelumnya, konsol akan menampilkan pemberitahuan **tertunda pengaturan Cluster**.
1. Dalam pemberitahuan **tertunda penyiapan klaster**, pilih **Selesaikan pengaturan klaster Multi-wilayah**. Tindakan ini memulai pembuatan cluster kedua di Wilayah lain.
1. Pilih salah satu opsi berikut untuk cluster kedua Anda:
+ **Tambahkan ARN cluster Region jarak jauh** — Pilih opsi ini jika ada cluster, dan Anda ingin itu menjadi cluster kedua di cluster Multi-region Anda.
+ **Buat cluster di Wilayah lain** - Pilih opsi ini untuk membuat cluster kedua. Di **Remote Region**, pilih Region untuk cluster kedua ini.
1. Pilih **Buat cluster di *your-second-region***, di *your-second-region* mana lokasi cluster kedua Anda. Konsol terbuka di Wilayah kedua Anda.
1. (Opsional) Pilih pengaturan cluster untuk cluster kedua Anda. Misalnya, Anda dapat memilih AWS KMS key. Jika Anda menggunakan kunci yang dikelola pelanggan, pastikan bahwa kebijakan kunci memberikan Aurora DSQL izin yang diperlukan. Untuk informasi selengkapnya, lihat [Kebijakan kunci untuk kunci yang dikelola pelanggan](data-encryption.md#key-policy-customer-managed-key).
1. Pilih **Buat cluster** untuk membuat cluster kedua Anda.
1. Pilih **Peer in *initial-cluster-region***, di mana *initial-cluster-region* adalah Region yang menghosting cluster pertama yang Anda buat.
1. Saat diminta, pilih **Konfirmasi**. Langkah ini melengkapi pembuatan cluster Multi-region Anda.
**Untuk terhubung ke cluster kedua Anda**
1. Buka konsol Aurora DSQL dan pilih Region untuk cluster kedua Anda.
1. Pilih **Klaster**.
1. Pilih baris untuk cluster kedua di cluster Multi-region Anda.
1. Pilih **Connect with Query editor**.
1. Pilih **Connect sebagai admin**.
1. Buat skema dan tabel sampel, dan masukkan data dengan mengikuti langkah-langkahnya. [Langkah 3: Jalankan contoh perintah SQL di Aurora DSQL](#getting-started-sql)
**Untuk melakukan kueri data di klaster kedua dari Region yang menghosting klaster awal Anda**
1. Di konsol Aurora DSQL, pilih Region untuk cluster awal Anda.
1. Pilih **Klaster**.
1. Pilih baris untuk cluster kedua di cluster Multi-region Anda.
1. Pilih **Connect with Query editor**.
1. Pilih **Connect sebagai admin**.
1. Kueri data yang Anda masukkan ke dalam cluster kedua.
**Example**
```
SELECT * FROM test.hello_world;
```
## Pemecahan masalah
Lihat bagian [Pemecahan Masalah](https://docs.aws.amazon.com/aurora-dsql/latest/userguide/troubleshooting.html) pada dokumentasi Aurora DSQL.