

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

# Menggunakan editor kueri Aurora
<a name="query-editor"></a><a name="query_editor"></a>

 Editor kueri Aurora memungkinkan Anda menjalankan pernyataan SQL pada cluster Aurora DB Anda melalui file. Konsol Manajemen AWS Anda dapat menjalankan query SQL, pernyataan manipulasi data (DHTML), dan pernyataan definisi data (DDL). Menggunakan antarmuka konsol memungkinkan Anda melakukan pemeliharaan database, menghasilkan laporan, dan melakukan eksperimen SQL. Anda dapat menghindari pengaturan konfigurasi jaringan untuk terhubung ke cluster DB Anda dari sistem klien terpisah seperti EC2 instance atau komputer laptop. 

Editor kueri memerlukan cluster Aurora DB dengan RDS Data API (Data API) diaktifkan. Untuk informasi tentang cluster DB yang mendukung Data API dan cara mengaktifkannya, lihat[Menggunakan Amazon RDS Data API](data-api.md). SQL yang dapat Anda jalankan tunduk pada batasan Data API. Untuk informasi selengkapnya, lihat [Batasan untuk Amazon RDS Data API](data-api.limitations.md). 

## Ketersediaan editor kueri
<a name="query-editor.regions"></a>

Editor kueri tersedia untuk cluster Aurora DB menggunakan versi mesin Aurora MySQL dan Aurora PostgreSQL yang mendukung API Data, dan di mana Data API tersedia. Wilayah AWS Untuk informasi selengkapnya, lihat [Daerah yang Didukung dan engine Aurora DB untuk RDS Data API](Concepts.Aurora_Fea_Regions_DB-eng.Feature.Data_API.md).

## Mengotorisasi akses ke editor kueri
<a name="query-editor.access"></a>

Pengguna harus diotorisasi untuk menjalankan kueri di editor kueri. Anda dapat mengotorisasi pengguna untuk menjalankan kueri di editor kueri dengan menambahkan `AmazonRDSDataFullAccess` kebijakan, kebijakan yang telah ditentukan AWS Identity and Access Management (IAM), ke pengguna tersebut.

**catatan**  
Pastikan untuk menggunakan nama pengguna dan kata sandi yang sama saat Anda membuat pengguna IAM seperti yang Anda lakukan untuk pengguna database, seperti nama pengguna administratif dan kata sandi. Untuk informasi selengkapnya, lihat [Membuat Pengguna IAM di Akun AWS Anda](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html) dalam *Panduan Pengguna AWS Identity and Access Management*.

Anda juga dapat membuat kebijakan IAM yang memberikan akses ke editor kueri. Setelah Anda membuat kebijakan, tambahkan ke setiap pengguna yang membutuhkan akses ke editor kueri.

Kebijakan berikut memberikan izin minimum yang diperlukan bagi pengguna untuk mengakses editor kueri.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "QueryEditor0",
            "Effect": "Allow",
            "Action": [
                "secretsmanager:GetSecretValue",
                "secretsmanager:PutResourcePolicy",
                "secretsmanager:PutSecretValue",
                "secretsmanager:DeleteSecret",
                "secretsmanager:DescribeSecret",
                "secretsmanager:TagResource"
            ],
            "Resource": "arn:aws:secretsmanager:*:*:secret:rds-db-credentials/*"
        },
        {
            "Sid": "QueryEditor1",
            "Effect": "Allow",
            "Action": [
                "secretsmanager:GetRandomPassword",
                "tag:GetResources",
                "secretsmanager:CreateSecret",
                "secretsmanager:ListSecrets",
                "dbqms:CreateFavoriteQuery",
                "dbqms:DescribeFavoriteQueries",
                "dbqms:UpdateFavoriteQuery",
                "dbqms:DeleteFavoriteQueries",
                "dbqms:GetQueryString",
                "dbqms:CreateQueryHistory",
                "dbqms:UpdateQueryHistory",
                "dbqms:DeleteQueryHistory",
                "dbqms:DescribeQueryHistory",
                "rds-data:BatchExecuteStatement",
                "rds-data:BeginTransaction",
                "rds-data:CommitTransaction",
                "rds-data:ExecuteStatement",
                "rds-data:RollbackTransaction"
            ],
            "Resource": "*"
        }
    ]
}
```

------

Untuk informasi tentang pembuatan kebijakan IAM, lihat [Membuat kebijakan IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) di *Panduan Pengguna AWS Identity and Access Management*.

Untuk informasi tentang cara menambahkan kebijakan IAM ke pengguna, lihat [Menambahkan dan menghapus izin identitas IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) di *Panduan Pengguna AWS Identity and Access Management*.

## Menjalankan kueri di editor kueri
<a name="query-editor.running"></a>

Anda dapat menjalankan pernyataan SQL pada cluster Aurora DB di editor kueri. SQL yang dapat Anda jalankan tunduk pada batasan Data API. Untuk informasi selengkapnya, lihat [Batasan untuk Amazon RDS Data API](data-api.limitations.md).

**Untuk menjalankan kueri di editor kueri**

1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon RDS di [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Di sudut kanan atasKonsol Manajemen AWS, pilih Wilayah AWS di mana Anda membuat cluster Aurora DB yang ingin Anda kueri.

1. Di panel navigasi, pilih **Basis data**.

1. Pilih cluster Aurora DB tempat Anda ingin menjalankan kueri SQL.

1. Untuk **Tindakan**, pilih **Kueri**. Jika Anda belum tersambung ke basis data sebelumnya, halaman **Hubungkan ke basis data** akan terbuka.  
![\[Halaman Hubungkan ke basis data di editor kueri\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/AuroraUserGuide/images/query-editor-connect.png)

1. Masukkan informasi berikut:

   1. Untuk **instance atau cluster Database**, pilih cluster Aurora DB tempat Anda ingin menjalankan kueri SQL.

   1. Untuk **Nama pengguna basis data**, pilih nama pengguna dari pengguna basis data yang akan dihubungkan, atau pilih **Tambahkan kredensial basis data baru**. Jika Anda memilih **Tambahkan kredensial basis data baru**, masukkan nama pengguna untuk kredensial basis data baru di **Masukkan nama pengguna basis data**.

   1. Untuk **Masukkan kata sandi basis data**, masukkan kata sandi untuk pengguna basis data yang Anda pilih.

   1. Di kotak terakhir, masukkan nama basis data atau skema yang ingin digunakan untuk klaster DB Aurora.

   1. Pilih **Hubungkan ke basis data**.
**catatan**  
Jika koneksi berhasil, informasi koneksi dan autentikasi Anda akan disimpan di AWS Secrets Manager. Anda tidak perlu memasukkan informasi koneksi lagi.

1. Di editor kueri, masukkan kueri SQL yang ingin dijalankan di basis data.  
![\[Editor kueri dengan pernyataan SQL di area teks\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/AuroraUserGuide/images/query-editor.png)

   Setiap pernyataan SQL dapat dilakukan secara otomatis, atau Anda dapat menjalankan pernyataan SQL dalam skrip sebagai bagian dari transaksi. Untuk mengontrol perilaku ini, pilih ikon roda gigi di atas jendela kueri.   
![\[Ikon roda gigi di Editor kueri\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/AuroraUserGuide/images/query-editor-gear.png)

   Jendela **Pengaturan Editor Kueri** muncul.  
![\[Pengaturan Editor Kueri\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/AuroraUserGuide/images/query-editor-settings.png)

   Jika Anda memilih **Lakukan otomatis**, setiap pernyataan SQL akan dilakukan secara otomatis. Jika Anda memilih **Transaksi**, Anda dapat menjalankan grup pernyataan dalam skrip. Pernyataan secara otomatis dilakukan di akhir skrip kecuali secara eksplisit dilakukan atau dibatalkan sebelum itu. Selain itu, Anda dapat memilih untuk menghentikan skrip yang sedang berjalan jika terjadi kesalahan dengan mengaktifkan **Hentikan saat terjadi kesalahan**.
**catatan**  
Dalam grup pernyataan, pernyataan bahasa definisi data (DDL) dapat menyebabkan pernyataan bahasa manipulasi data (DML) sebelumnya dilakukan. Anda juga dapat memasukkan pernyataan `COMMIT` dan `ROLLBACK` dalam grup pernyataan dalam skrip.

   Setelah Anda menentukan pilihan di jendela **Pengaturan Editor Kueri**, pilih **Simpan**.

1. Pilih **Jalankan** atau tekan Ctrl\$1Enter, dan editor kueri akan menampilkan hasil kueri Anda.

   Setelah menjalankan kueri, simpan ke **Kueri tersimpan** dengan memilih **Simpan**.

   Ekspor hasil kueri ke format spreadsheet dengan memilih **Ekspor ke csv**.

Anda dapat menemukan, mengedit, dan menjalankan kembali kueri sebelumnya. Untuk melakukannya, pilih tab **Baru** atau tab **Kueri tersimpan**, pilih teks kueri, lalu pilih **Jalankan**.

Untuk mengubah basis data, pilih **Ubah basis data**.

# Referensi Layanan Metadata Kueri Database () DBQMS API
<a name="dbqms-api"></a>

Layanan Metadata Kueri Basis Data (`dbqms`) adalah layanan khusus internal. Ini menyediakan kueri terbaru dan tersimpan Anda untuk editor kueri di Konsol Manajemen AWS untuk beberapa AWS layanan, termasuk AmazonRDS.

**Topics**
+ [CreateFavoriteQuery](#CreateFavoriteQuery)
+ [CreateQueryHistory](#CreateQueryHistory)
+ [CreateTab](#CreateTab)
+ [DeleteFavoriteQueries](#DeleteFavoriteQueries)
+ [DeleteQueryHistory](#DeleteQueryHistory)
+ [DeleteTab](#DeleteTab)
+ [DescribeFavoriteQueries](#DescribeFavoriteQueries)
+ [DescribeQueryHistory](#DescribeQueryHistory)
+ [DescribeTabs](#DescribeTabs)
+ [GetQueryString](#GetQueryString)
+ [UpdateFavoriteQuery](#UpdateFavoriteQuery)
+ [UpdateQueryHistory](#UpdateQueryHistory)
+ [UpdateTab](#UpdateTab)

## CreateFavoriteQuery
<a name="CreateFavoriteQuery"></a>

Menyimpan kueri favorit baru. Setiap pengguna dapat membuat hingga 1.000 kueri yang disimpan. Batas ini dapat berubah di masa mendatang.

## CreateQueryHistory
<a name="CreateQueryHistory"></a>

Simpan entri riwayat kueri baru.

## CreateTab
<a name="CreateTab"></a>

Menyimpan tab kueri baru. Setiap pengguna dapat membuat hingga 10 tab kueri.

## DeleteFavoriteQueries
<a name="DeleteFavoriteQueries"></a>

Hapus satu atau beberapa kueri tersimpan.

## DeleteQueryHistory
<a name="DeleteQueryHistory"></a>

Hapus entri riwayat kueri.

## DeleteTab
<a name="DeleteTab"></a>

Hapus entri tab kueri.

## DescribeFavoriteQueries
<a name="DescribeFavoriteQueries"></a>

Mencantumkan kueri disimpan yang dibuat oleh pengguna dalam akun tertentu.

## DescribeQueryHistory
<a name="DescribeQueryHistory"></a>

Mencantumkan entri riwayat kueri.

## DescribeTabs
<a name="DescribeTabs"></a>

Mencantumkan tab kueri yang dibuat oleh pengguna dalam akun tertentu.

## GetQueryString
<a name="GetQueryString"></a>

Mengambil teks kueri penuh dari ID kueri.

## UpdateFavoriteQuery
<a name="UpdateFavoriteQuery"></a>

Memperbarui string, deskripsi, nama, atau tanggal kedaluwarsa kueri.

## UpdateQueryHistory
<a name="UpdateQueryHistory"></a>

Memperbarui status riwayat kueri.

## UpdateTab
<a name="UpdateTab"></a>

Memperbarui nama tab kueri dan string kueri.