Kueri data dalam kolaborasi

Sebagai anggota yang dapat melakukan query, Anda dapat melakukan salah satu hal berikut:

• Buat kueri SQL secara manual menggunakan editor kode SQL.

• Gunakan UI pembuat Analisis untuk membuat kueri tanpa harus menulis kode SQL.

• Gunakan templat analisis yang disetujui.

Ketika anggota yang dapat melakukan kueri menjalankan kueri SQL pada tabel dalam kolaborasi, AWS Clean Rooms mengasumsikan peran yang relevan untuk mengakses tabel atas nama mereka. AWS Clean Rooms menerapkan aturan analisis yang diperlukan untuk kueri input dan outputnya.

AWS Clean Rooms mendukung query SQL yang dapat berbeda dari mesin query lainnya. Untuk spesifikasi, lihat Referensi AWS Clean Rooms SQL. Jika Anda ingin menjalankan kueri pada tabel data yang dilindungi dengan privasi diferensial, Anda harus memastikan bahwa kueri Anda kompatibel dengan struktur kueri tujuan umum Privasi Diferensial. AWS Clean Rooms

catatan

Saat menggunakan Cryptographic Computing untuk Clean Rooms, tidak semua operasi SQL menghasilkan hasil yang valid. Misalnya, Anda dapat melakukan COUNT pada kolom terenkripsi tetapi melakukan nomor terenkripsi menyebabkan kesalahan. SUM Selain itu, kueri mungkin juga menghasilkan hasil yang salah. Misalnya, kueri yang SUM disegel kolom menghasilkan kesalahan. Namun, GROUP BY kueri di atas kolom yang disegel tampaknya berhasil tetapi menghasilkan grup yang berbeda dari yang dihasilkan oleh GROUP BY kueri di atas cleartext.

Topik berikut menjelaskan cara kueri data dalam kolaborasi menggunakan AWS Clean Rooms konsol.

Untuk informasi tentang cara menanyakan data atau melihat kueri dengan memanggil operasi AWS Clean Rooms StartProtectedQuery API secara langsung atau menggunakan AWS SDK, lihat Referensi AWS Clean Rooms API.

Untuk informasi tentang pencatatan kueri, lihatKueri masuk AWS Clean Rooms.

catatan

Jika Anda menjalankan kueri pada tabel data terenkripsi, hasil dari kolom terenkripsi dienkripsi.

Untuk informasi tentang menerima hasil kueri, lihatMenerima hasil kueri.

Menggunakan editor kode SQL

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 Kueri di konsol. AWS Clean Rooms

Editor kode SQL ditampilkan secara default. Jika Anda ingin menggunakan pembuat analisis untuk membuat kueri, lihatMenggunakan pembangun analisis.

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.

Tip

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

Untuk membangun kueri secara manual menggunakan editor kode SQL

1. Masuk ke AWS Management Console dan buka AWS Clean Rooms konsol dengan Anda Akun AWS (jika Anda belum melakukannya).

2. Di panel navigasi kiri, pilih Kolaborasi.

3. Pilih kolaborasi yang memiliki status Kueri kemampuan anggota Anda.

4. Pada tab Queries, buka bagian Analisis.

   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.

5. Pada tab Kueri, 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.

   • Tabel tidak memiliki aturan analisis yang dikonfigurasi.

6. (Opsional) Untuk melihat skema tabel dan kontrol aturan analisis, perluas tabel dengan memilih ikon tanda plus (+).

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

   (Opsional) Jika Anda ingin menggunakan contoh kueri

   (Opsional) Jika Anda ingin memasukkan nama kolom atau fungsi

   Pilih tiga titik vertikal di sebelah tabel. Di bawah Sisipkan di editor, pilih Contoh kueri. catatan Memasukkan kueri Contoh menambahkan kueri yang sudah ada di editor. Contoh kueri muncul. Semua tabel yang tercantum di bawah Tabel disertakan dalam kueri. Edit nilai placeholder dalam kueri.

   Pilih tiga titik vertikal di sebelah kolom. Di bawah Sisipkan di editor, pilih Nama kolom. Untuk menyisipkan fungsi yang diizinkan secara manual pada kolom, pilih tiga titik vertikal di sebelah kolom, pilih Sisipkan di editor, lalu pilih nama fungsi yang diizinkan (sepertiINNER JOIN,SUM, SUMDISTINCT, atauCOUNT). Tekan Ctrl+Spasi 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. Edit nilai placeholder dalam kueri.

8. Pilih Jalankan.

   catatan

   Anda tidak dapat menjalankan kueri jika anggota yang dapat menerima hasil belum mengonfigurasi setelan hasil kueri.

9. Lanjutkan untuk menyesuaikan parameter dan jalankan kueri Anda lagi, atau pilih tombol + 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.

Menggunakan pembangun analisis

Anda dapat menggunakan pembuat analisis untuk membuat kueri tanpa harus menulis kode SQL. Dengan pembuat analisis, Anda dapat membuat kueri untuk kolaborasi yang memiliki:

• Tabel tunggal yang menggunakan aturan analisis agregasi tanpa diperlukan JOIN

• Dua tabel (satu dari setiap anggota) yang keduanya menggunakan aturan analisis agregasi

• Dua tabel (satu dari setiap anggota) yang keduanya menggunakan aturan analisis daftar

• Dua tabel (satu dari setiap anggota) yang keduanya menggunakan aturan analisis agregasi dan dua tabel (satu dari setiap anggota) yang keduanya menggunakan aturan analisis daftar

Jika Anda ingin menulis kueri SQL secara manual, lihat. Menggunakan editor kode SQL

Pembuat analisis muncul sebagai opsi UI pembuat Analisis di bagian Analisis pada tab Kueri di AWS Clean Rooms konsol.

penting

Jika Anda mengaktifkan UI pembuat Analisis, mulai membuat kueri di pembuat analisis, lalu matikan UI pembuat Analisis, kueri Anda tidak disimpan.

Tip

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

Topik berikut menjelaskan cara menggunakan pembuat analisis.

Topik

• Gunakan pembuat analisis untuk menanyakan satu tabel (agregasi)
• Gunakan pembuat analisis untuk menanyakan dua tabel (agregasi atau daftar)

Gunakan pembuat analisis untuk menanyakan satu tabel (agregasi)

Prosedur ini menunjukkan cara menggunakan UI pembuat Analisis di AWS Clean Rooms konsol untuk membuat kueri. Kueri adalah untuk kolaborasi yang memiliki satu tabel yang menggunakan aturan analisis agregasi tanpa JOIN diperlukan.

Untuk menggunakan pembuat analisis untuk menanyakan satu tabel

1. Masuk ke AWS Management Console dan buka AWS Clean Rooms konsol dengan Anda Akun AWS (jika Anda belum melakukannya).

2. Di panel navigasi kiri, pilih Kolaborasi.

3. Pilih kolaborasi yang memiliki status Kueri kemampuan anggota Anda.

4. Pada tab Kueri, di bawah Tabel, lihat tabel dan jenis aturan analisis terkait. (Jenis aturan analisis harus menjadi aturan analisis Agregasi.)

   catatan

   Jika Anda tidak melihat tabel yang Anda harapkan, mungkin karena alasan berikut:

   • Tabel belum dikaitkan.

   • Tabel tidak memiliki aturan analisis yang dikonfigurasi.

5. Di bawah bagian Analisis, aktifkan UI pembuat Analisis.

6. Bangun kueri.

   Jika Anda ingin melihat semua metrik agregasi, lewati ke langkah 9.

   1. Untuk metrik Pilih, tinjau metrik agregat yang telah dipilih sebelumnya secara default dan hapus metrik apa pun jika diperlukan.

   2. (Opsional) Untuk Tambah segmen - opsional, pilih satu atau beberapa parameter.

      catatan

      Tambahkan segmen - opsional hanya ditampilkan jika dimensi ditentukan untuk tabel.

   3. (Opsional) Untuk Tambahkan filter — opsional, pilih Tambahkan filter, lalu pilih Parameter, operator, dan Nilai.

      Untuk menambahkan lebih banyak filter, pilih Tambahkan filter lain.

      Untuk menghapus filter, pilih Hapus.

      catatan

      ORDER BYtidak didukung untuk kueri agregasi.

      Hanya AND operator yang didukung dalam filter.

   4. (Opsional) Untuk Tambahkan deskripsi — opsional, masukkan deskripsi untuk membantu mengidentifikasi kueri dalam daftar kueri.

7. Perluas kode SQL Pratinjau.

   1. Lihat kode SQL yang dihasilkan dari pembuat analisis.

   2. Untuk menyalin kode SQL, pilih Salin.

   3. Untuk mengedit kode SQL, pilih Edit di editor kode SQL.

8. Pilih Jalankan.

   catatan

   Anda tidak dapat menjalankan kueri jika anggota yang dapat menerima hasil belum mengonfigurasi setelan hasil kueri.

9. Lanjutkan untuk menyesuaikan parameter dan jalankan kueri Anda lagi, atau pilih tombol + 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.

Gunakan pembuat analisis untuk menanyakan dua tabel (agregasi atau daftar)

Prosedur ini menjelaskan cara menggunakan pembuat analisis di AWS Clean Rooms konsol untuk membuat kueri untuk kolaborasi yang memiliki:

• Dua tabel (satu dari setiap anggota) yang keduanya menggunakan aturan analisis agregasi

• Dua tabel (satu dari setiap anggota) yang keduanya menggunakan aturan analisis daftar

• Dua tabel (satu dari setiap anggota) yang keduanya menggunakan aturan analisis agregasi dan dua tabel (satu dari setiap anggota) yang keduanya menggunakan aturan analisis daftar

Untuk menggunakan pembuat analisis untuk menanyakan dua tabel

1. Masuk ke AWS Management Console dan buka AWS Clean Rooms konsol dengan Anda Akun AWS (jika Anda belum melakukannya).

2. Di panel navigasi kiri, pilih Kolaborasi.

3. Pilih kolaborasi yang memiliki status kemampuan anggota Anda Query..

4. Pada tab Kueri, di bawah Tabel, lihat dua tabel dan jenis aturan analisis terkait (Aturan analisis agregasi atau Aturan analisis daftar).

   catatan

   Jika Anda tidak melihat tabel yang Anda harapkan dalam daftar, mungkin karena alasan berikut:

   • Tabel belum dikaitkan.

   • Tabel tidak memiliki aturan analisis yang dikonfigurasi.

5. Di bawah bagian Analisis, aktifkan UI pembuat Analisis.

6. Bangun kueri.

   Jika kolaborasi berisi dua tabel yang menggunakan aturan analisis agregasi dan dua tabel yang menggunakan aturan analisis Daftar, pertama pilih Agregasi atau Daftar, lalu ikuti petunjuk berdasarkan aturan analisis yang dipilih.

   Jika kedua tabel menggunakan aturan analisis agregasi

   Jika kedua tabel menggunakan aturan analisis daftar

   Untuk metrik Pilih, tinjau metrik agregat yang telah dipilih sebelumnya secara default dan hapus metrik apa pun jika diperlukan. Untuk catatan Pertandingan, pilih satu atau beberapa catatan. catatan Saat menggunakan pembuat analisis, Anda hanya dapat mencocokkan pada satu pasang kolom. (Opsional) Untuk Tambah segmen - opsional, pilih satu atau beberapa parameter. catatan Tambahkan segmen - opsional hanya ditampilkan jika dimensi ditentukan untuk tabel. (Opsional) Untuk Tambahkan filter — opsional, pilih Tambahkan filter, lalu pilih parameter, operator, dan nilai. Untuk menambahkan lebih banyak filter, pilih Tambahkan filter lain. Untuk menghapus filter, pilih Hapus. catatan ORDER BYtidak didukung untuk kueri agregasi. Hanya AND operator yang didukung dalam filter. (Opsional) Untuk Tambahkan deskripsi — opsional, masukkan deskripsi untuk membantu mengidentifikasi kueri dalam daftar kueri terbaru.

   Untuk atribut Pilih, tinjau atribut daftar yang telah dipilih sebelumnya secara default dan hapus metrik apa pun jika diperlukan. Untuk catatan Pertandingan, pilih satu atau beberapa catatan. catatan Saat menggunakan pembuat analisis, Anda hanya dapat mencocokkan pada satu pasang kolom. (Opsional) Untuk Tambahkan filter — opsional, pilih Tambahkan filter, lalu pilih parameter, operator, dan nilai. Untuk menambahkan lebih banyak filter, pilih Tambahkan filter lain. Untuk menghapus filter, pilih Hapus. catatan LIMITtidak didukung untuk kueri daftar. Hanya AND operator yang didukung dalam filter. (Opsional) Untuk Tambahkan deskripsi — opsional, masukkan deskripsi untuk membantu mengidentifikasi kueri dalam daftar kueri terbaru.

7. Perluas kode SQL Pratinjau.

   1. Lihat kode SQL yang dihasilkan dari pembuat analisis.

   2. Untuk menyalin kode SQL, pilih Salin.

   3. Untuk mengedit kode SQL, pilih Edit di editor kode SQL.

8. Pilih Jalankan.

   catatan

   Anda tidak dapat menjalankan kueri jika anggota yang dapat menerima hasil belum mengonfigurasi setelan hasil kueri

9. Lanjutkan untuk menyesuaikan parameter dan jalankan kueri Anda lagi, atau pilih tombol + 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.

Meminta data dengan privasi diferensial

Secara umum, menulis dan menjalankan kueri tidak berubah ketika privasi diferensial diaktifkan. Namun, Anda tidak dapat menjalankan kueri jika tidak ada cukup anggaran privasi yang tersisa. Saat Anda menjalankan kueri dan menggunakan anggaran privasi, Anda dapat melihat kira-kira berapa banyak agregasi yang dapat Anda jalankan dan bagaimana hal itu dapat memengaruhi kueri future.

Untuk melihat dampak privasi diferensial dalam kolaborasi

1. Masuk ke AWS Management Console dan buka AWS Clean Rooms konsol dengan Anda Akun AWS (jika Anda belum melakukannya).

2. Di panel navigasi kiri, pilih Kolaborasi.

3. Pilih kolaborasi yang memiliki status detail anggota Anda dari Jalankan kueri.

4. Pada tab Kueri, di bawah Tabel, lihat anggaran privasi yang tersisa. Ini ditampilkan sebagai perkiraan jumlah fungsi agregasi yang tersisa dan Utilitas yang digunakan (diberikan sebagai persentase).

   catatan

   Perkiraan jumlah fungsi agregat yang tersisa dan persentase Utilitas yang digunakan hanya ditampilkan untuk anggota yang dapat melakukan query.

5. Pilih Lihat dampak untuk melihat seberapa banyak noise yang disuntikkan ke hasil dan kira-kira berapa banyak fungsi agregasi yang dapat Anda jalankan.

Melihat kueri terbaru

Anda dapat melihat kueri yang berjalan dalam 90 hari terakhir di tab Kueri terbaru.

catatan

Jika satu-satunya kemampuan anggota Anda adalah Kontribusikan data, dan Anda bukan anggota yang membayar biaya komputasi kueri, tab Kueri tidak akan muncul di konsol.

Untuk melihat pertanyaan terbaru

1. Masuk ke AWS Management Console dan buka AWS Clean Rooms konsol dengan Anda Akun AWS (jika Anda belum melakukannya).

2. Di panel navigasi kiri, pilih Kolaborasi.

3. Pilih kolaborasi.

4. Pada tab Kueri, di bawah Kueri, lihat kueri yang telah dijalankan dalam 90 hari terakhir.

5. Untuk mengurutkan kueri terbaru berdasarkan Status, pilih status dari daftar tarik-turun Semua status.

   Statusnya adalah: Dikirim, Dimulai, Dibatalkan, Sukses, Gagal, dan Timed out.

Melihat detail kueri

Anda dapat melihat detail kueri sebagai anggota yang dapat menjalankan kueri atau sebagai anggota yang dapat menerima hasil.

Untuk melihat detail kueri

1. Masuk ke AWS Management Console dan buka AWS Clean Rooms konsol dengan Anda Akun AWS (jika Anda belum melakukannya).

2. Di panel navigasi kiri, pilih Kolaborasi.

3. Pilih kolaborasi.

4. Pada tab Queries, lakukan salah satu hal berikut:

   • Pilih tombol opsi untuk kueri tertentu yang ingin Anda lihat, lalu pilih Lihat detail.

   • Pilih ID kueri yang dilindungi.

5. Pada halaman Query details,

   • Jika Anda adalah anggota yang dapat menjalankan kueri, lihat detail Kueri, teks SQL, dan Hasil.

     Anda melihat pesan yang mengonfirmasi bahwa hasil kueri dikirimkan ke anggota yang dapat menerima hasil.

   • Jika Anda adalah anggota yang dapat menerima hasil, lihat detail Kueri dan Hasil.