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

# Memulai dengan Aurora DSQL Query Editor
<a name="getting-started-query-editor"></a>

Dengan Aurora DSQL Query Editor, Anda dapat terhubung dengan aman ke cluster Aurora DSQL Anda dan menjalankan kueri SQL langsung dari Konsol Manajemen tanpa menginstal atau mengonfigurasi klien eksternal. AWS Ini menyediakan ruang kerja intuitif dengan penyorotan sintaks bawaan, pelengkapan otomatis, dan bantuan kode cerdas. Anda dapat dengan cepat menjelajahi objek skema, mengembangkan dan menjalankan kueri SQL, dan melihat hasil, semuanya dalam satu antarmuka.

Topik ini memandu Anda melalui langkah-langkah untuk terhubung ke klaster, menjalankan kueri, melihat hasil, dan menjelajahi kemampuan lanjutan seperti rencana eksekusi.

**catatan**  
Editor Kueri tersedia di semua Wilayah di mana Aurora DSQL didukung. Untuk detail selengkapnya tentang ketersediaan regional, lihat [Layanan AWS Regional](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/).

## Prasyarat
<a name="query-editor-prerequisites"></a>

Sebelum Anda memulai, pastikan Anda memenuhi persyaratan berikut:
+ Anda memiliki setidaknya satu cluster Aurora DSQL yang tersedia. Untuk detail selengkapnya tentang membuat cluster, lihat[Langkah 1: Buat cluster Aurora DSQL Single-region](getting-started.md#getting-started-create-cluster).
+ Titik akhir cluster Anda dapat diakses oleh publik. Editor Kueri tidak mendukung klaster yang memiliki akses publik yang diblokir oleh kebijakan berbasis sumber daya atau kluster yang dikelola melalui titik akhir VPC. Untuk detail selengkapnya tentang pembatasan akses, lihat [Memblokir akses publik dengan kebijakan berbasis sumber daya di Aurora DSQL](rbp-block-public-access.md) dan[Mengelola dan menghubungkan ke cluster DSQL Amazon Aurora menggunakan AWS PrivateLink](privatelink-managing-clusters.md).
+ Pengguna atau peran IAM Anda memiliki izin yang diperlukan untuk mengakses dan terhubung ke cluster. Untuk detail selengkapnya tentang izin, lihat[Menggunakan peran database dan otentikasi IAM](using-database-and-iam-roles.md).

## Bekerja dengan Query Editor
<a name="query-editor-working"></a>

### Buka Editor Kueri
<a name="query-editor-open"></a>

**Untuk membuka Query Editor**

1. Buka konsol [Aurora DSQL](https://console.aws.amazon.com/dsql).

1. Di panel navigasi, pilih **Editor Kueri**.

Atau, dari halaman **Clusters**, pilih cluster yang ingin Anda kueri dan pilih **Connect with Query editor** untuk meluncurkan editor secara langsung.

**catatan**  
Status kerja dan koneksi tidak disimpan. Jika Anda menavigasi jauh dari konsol Aurora DSQL, menutup tab browser, atau keluar, koneksi, teks kueri, dan hasil Anda akan hilang.

### Connect ke sebuah cluster
<a name="query-editor-connect"></a>

**Untuk terhubung ke cluster**

1. Jika tidak ada koneksi cluster, editor akan menampilkan **Tidak ada cluster yang terhubung**. Pilih **Connect** atau pilih **\$1** (Add) di panel **Cluster Explorer** untuk terhubung ke cluster yang ada.

1. (Opsional) Hubungkan ke beberapa cluster atau ke cluster yang sama dengan menggunakan peran yang berbeda.

### Jelajahi objek cluster
<a name="query-editor-explore"></a>

Cluster Explorer menampilkan semua koneksi cluster yang tersedia dan memungkinkan Anda menelusuri objek seperti database, skema, tabel, dan tampilan. Ini juga menyediakan tindakan umum seperti **Refresh**, **Create table**, dan opsi khusus konteks lainnya.

### Jalankan kueri
<a name="query-editor-run-queries"></a>

**Untuk menjalankan kueri**

1. Di panel tab editor kueri, masukkan pernyataan SQL Anda. Contoh:

   ```
   SELECT * FROM public.orders LIMIT 10;
   ```

1. Verifikasi **Konteks Cluster Aktif** yang ditampilkan di kanan atas tab kueri. Ini menunjukkan koneksi cluster yang terkait dengan tab kueri saat ini.

1. (Opsional) Gunakan dropdown **koneksi** untuk meninjau semua koneksi yang tersedia atau beralih ke cluster yang berbeda. Mengubah pembaruan koneksi tempat kueri Anda di tab itu dijalankan.

1. Pilih **Jalankan** untuk menjalankan kueri.

**catatan**  
Setiap kueri dapat mengembalikan hingga 10.000 baris di panel hasil. Untuk kumpulan data yang lebih besar, perbaiki kueri Anda dengan filter atau batas.

### Meninjau hasil dan rencana eksekusi
<a name="query-editor-view-results"></a>

Setelah kueri berjalan, tinjau output di **panel Results** di bagian bawah editor. Secara default, setiap eksekusi kueri menampilkan tab **Hasil (Tabel)**, menampilkan keluaran kueri tabular.

Untuk mendapatkan rencana eksekusi kueri, jalankan `EXPLAIN ANALYZE` atau `EXPLAIN ANALYZE VERBOSE` dapatkan wawasan tambahan tentang kinerja kueri. Untuk detail selengkapnya tentang rencana eksekusi, lihat[Membaca Aurora DSQL JELASKAN rencana](reading-dsql-explain-plans.md).

**Tip**  
`EXPLAIN ANALYZE VERBOSE`Perintah tersebut menampilkan perkiraan penggunaan DPU termasuk nilai Compute, Read, Write, dan Total DPU, memberikan visibilitas langsung ke sumber daya yang dikonsumsi oleh pernyataan SQL individual.