

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

# Menanyakan tabel yang dikonfigurasi menggunakan editor kode SQL
<a name="use-sql-editor"></a>

Sebagai anggota yang dapat melakukan kueri, Anda dapat membuat kueri secara manual dengan menulis kode SQL di editor kode SQL. Editor kode SQL terletak di bagian **Analisis** pada tab **Analisis** di AWS Clean Rooms konsol. 

Editor kode SQL ditampilkan secara default. Jika Anda ingin menggunakan pembuat analisis untuk membuat kueri, lihat[Menanyakan dengan pembuat analisis](query-data-analysis-builder.md). 

**penting**  
Jika Anda mulai menulis kueri SQL di editor kode dan kemudian mengaktifkan **UI pembuat Analisis**, kueri Anda tidak disimpan.

AWS Clean Rooms mendukung banyak perintah, fungsi, dan kondisi SQL. Untuk informasi selengkapnya, lihat [Referensi AWS Clean Rooms SQL](https://docs.aws.amazon.com/clean-rooms/latest/sql-reference/sql-reference.html). 

**Tip**  
Jika pemeliharaan terjadwal terjadi saat kueri sedang berjalan, kueri dihentikan dan digulung kembali. Anda harus memulai ulang kueri. 

**Untuk menanyakan tabel yang dikonfigurasi menggunakan editor kode SQL**

1. Masuk ke Konsol Manajemen AWS dan buka AWS Clean Rooms konsol di [https://console.aws.amazon.com/cleanrooms](https://console.aws.amazon.com/cleanrooms/home).

1. Di panel navigasi kiri, pilih **Kolaborasi**.

1. Pilih kolaborasi yang memiliki status **kemampuan anggota Anda** dari **Menjalankan kueri.**

1. Pada tab **Analisis**, di bawah **Tabel**, lihat daftar tabel dan jenis aturan analisis terkait (Aturan analisis **agregasi, Aturan analisis** **daftar, atau Aturan** **analisis kustom**).
**catatan**  
Jika Anda tidak melihat tabel yang Anda harapkan dalam daftar, mungkin karena alasan berikut:  
Tabel belum [dikaitkan](associate-configured-table.md).
Tabel tidak memiliki [aturan analisis yang dikonfigurasi](add-analysis-rule.md).

1. (Opsional) Untuk melihat skema tabel dan kontrol aturan analisis, perluas tabel dengan memilih ikon tanda plus (**\$1**).

1. Di bawah bagian **Analisis**, untuk **mode Analisis**, pilih **Tulis kode SQL**.
**catatan**  
Bagian **Analisis** hanya ditampilkan jika anggota yang dapat menerima hasil dan anggota yang bertanggung jawab untuk membayar biaya komputasi kueri telah bergabung dengan kolaborasi sebagai anggota aktif.

1. Bangun kueri dengan mengetikkan kueri ke editor kode SQL.

   Untuk informasi selengkapnya tentang perintah dan fungsi SQL yang didukung, lihat Referensi [AWS Clean Rooms SQL](https://docs.aws.amazon.com/clean-rooms/latest/sql-reference/sql-reference.html). 

   Anda juga dapat menggunakan opsi berikut untuk membuat kueri Anda.

------
#### [ Use an example query ]

   Untuk menggunakan contoh kueri

   1. Pilih tiga titik vertikal di sebelah tabel.

   1. Di bawah **Sisipkan di editor**, pilih **Contoh kueri**.
**catatan**  
Memasukkan **kueri Contoh menambahkannya** ke kueri yang sudah ada di editor.

      Contoh kueri muncul. Semua tabel yang tercantum di bawah **Tabel** disertakan dalam kueri. 

   1. Edit nilai placeholder dalam kueri.

------
#### [ Insert column names or functions ]

   Untuk menyisipkan nama kolom atau fungsi

   1. Pilih tiga titik vertikal di sebelah kolom.

   1. Di bawah **Sisipkan di editor**, pilih **Nama kolom**.

   1. Untuk menyisipkan fungsi yang diizinkan secara manual pada kolom, 

      1. Pilih tiga titik vertikal di sebelah kolom.

      1. Pilih **Sisipkan di editor**.

      1. Pilih nama fungsi yang diizinkan (sepertiINNER JOIN,, SUMSUM DISTINCT, atauCOUNT).

   1. Tekan ****Ctrl\$1Spasi**** untuk melihat skema tabel di editor kode.
**catatan**  
Anggota yang dapat query dapat melihat dan menggunakan kolom partisi di setiap asosiasi tabel dikonfigurasi. Pastikan kolom partisi diberi label sebagai kolom partisi dalam tabel yang mendasari AWS Glue tabel yang dikonfigurasi.

   1. Edit nilai placeholder dalam kueri.

------

1. Tentukan **jenis Pekerja** yang didukung dan **Jumlah pekerja**. 

   Anda dapat memilih jenis instans dan jumlah instance (pekerja) untuk menjalankan kueri SQL Anda. 

   Untuk CR.1X, Anda dapat memilih hingga 128 pekerja atau minimal 4 pekerja. 

   Untuk CR.4X, Anda dapat memilih hingga 32 pekerja atau minimal 4 pekerja. 

   Gunakan tabel berikut untuk menentukan jenis dan nomor atau pekerja yang Anda butuhkan untuk kasus penggunaan Anda.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/clean-rooms/latest/userguide/use-sql-editor.html)
**catatan**  
Jenis pekerja yang berbeda dan jumlah pekerja memiliki biaya terkait. Untuk mempelajari lebih lanjut tentang harga, lihat [AWS Clean Rooms harga](https://aws.amazon.com/clean-rooms/pricing/).

1. Untuk **Kirim hasil ke**, tentukan siapa yang dapat menerima hasil. 
**catatan**  
Untuk menerima hasil, anggota kolaborasi harus dikonfigurasi sebagai penerima hasil dan harus menjadi peserta aktif dalam kolaborasi (**Status: Aktif**)

1. (Anggota yang hanya dapat melakukan kueri) Kotak centang **Gunakan pengaturan hasil default Anda** dipilih secara default. Tetap pilih ini jika Anda ingin mempertahankan pengaturan hasil default Anda.

   Jika Anda ingin menentukan pengaturan hasil yang berbeda untuk kueri ini, kosongkan kotak centang **Gunakan pengaturan hasil default Anda**, lalu pilih yang berikut ini. 

   1. **Format hasil** (**CSV** atau **PARQUET**)

   1. **File hasil** (**Tunggal** atau **Ganda**)

   1. **Tujuan hasil di Amazon S3**

   Setiap anggota yang dapat menerima hasil dapat menentukan **format Hasil**, **file Hasil**, dan **tujuan Hasil yang berbeda di Amazon S3**.

1. Untuk menentukan **properti Spark**:

   1. Perluas **properti Spark**.

   1. Pilih **Tambahkan properti Spark**.

   1. **Pada kotak dialog **properti Spark**, pilih **nama Properti** dari daftar dropdown dan masukkan Nilai.**

   Tabel berikut memberikan definisi untuk setiap properti.

   Untuk informasi selengkapnya tentang properti Spark, lihat [Spark Properties](https://spark.apache.org/docs/latest/configuration.html#spark-properties) di dokumentasi Apache Spark.     
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/clean-rooms/latest/userguide/use-sql-editor.html)

1. Pilih **Jalankan**.
**catatan**  
Anda tidak dapat menjalankan kueri jika anggota yang dapat menerima hasil belum mengonfigurasi setelan hasil kueri.

1. Lihat **Hasilnya**. 

   Untuk informasi selengkapnya, lihat [Menerima dan menggunakan hasil analisis](receive-query-results.md).

1. Lanjutkan untuk menyesuaikan parameter dan jalankan kueri Anda lagi, atau pilih tombol **\$1** untuk memulai kueri baru di tab baru.

**catatan**  
AWS Clean Rooms bertujuan untuk memberikan pesan kesalahan yang jelas. Jika pesan kesalahan tidak memiliki detail yang cukup untuk membantu Anda memecahkan masalah, hubungi tim akun. Berikan mereka deskripsi tentang bagaimana kesalahan terjadi dan pesan kesalahan (termasuk pengidentifikasi apa pun). Untuk informasi selengkapnya, lihat [Pemecahan masalah AWS Clean Rooms](troubleshooting.md).