Kueri masuk AWS Clean Rooms

Pencatatan kueri adalah fitur di AWS Clean Rooms. Saat Anda membuat kolaborasi dan mengaktifkan pencatatan Kueri, anggota dapat menyimpan log kueri yang relevan dengannya di CloudWatch Log Amazon.

Dengan log kueri, anggota dapat menentukan apakah kueri mematuhi aturan analisis dan menyelaraskan dengan perjanjian kolaborasi. Selain itu, log kueri membantu mendukung audit.

Saat opsi Pencatatan kueri diaktifkan di AWS Clean Rooms konsol, log kueri menyertakan yang berikut:

• analysisRule— Aturan analisis untuk tabel yang dikonfigurasi.

• analysisTemplateArn— Template analisis yang dijalankan (muncul tergantung pada aturan analisis).

• collaborationId— Pengidentifikasi unik untuk kolaborasi di mana kueri dijalankan.

• configuredTableID— Pengidentifikasi unik untuk tabel yang dikonfigurasi direferensikan dalam kueri.

• directQueryAnalysisRulePolicy.custom.allowedAnalysis— Template analisis diizinkan untuk berjalan pada tabel yang dikonfigurasi (muncul tergantung pada aturan analisis).

• directQueryAnalysisRulePolicy.v1.custom.allowedAnalysisProviders— Penyedia kueri diizinkan untuk membuat kueri (muncul tergantung pada aturan analisis).

• eventID— Pengidentifikasi unik untuk menjalankan kueri. Setelah 31 Agustus 2023, pengidentifikasi unik sama dengan. protectedQueryID

• eventTimestamp— Query run time.

• parameters.parametervalue— Nilai parameter (muncul tergantung pada teks kueri).

• queryText— Definisi SQL dari query run. Jika ada parameter, mereka diberi label sebagai. :parametervalue

• queryValidationErrors— Kesalahan kueri pada validasi kueri.

• schemaName— Nama asosiasi tabel yang dikonfigurasi direferensikan dalam kueri.

Menerima log kueri

Anda tidak perlu melakukan tindakan apa pun di luar AWS Clean Rooms untuk menyiapkan log kueri. AWS Clean Rooms membuat grup log untuk kolaborasi setelah setiap anggota kolaborasi membuat keanggotaan.

Anggota yang dapat melakukan kueri, anggota yang dapat menerima hasil, dan anggota yang tabel konfigurasinya direferensikan dalam kueri akan menerima log kueri.

Anggota yang dapat melakukan kueri dan anggota yang dapat menerima hasil akan menerima log kueri untuk setiap tabel yang dikonfigurasi yang direferensikan dalam kueri. Jika mereka tidak memiliki tabel yang dikonfigurasi, mereka tidak akan dapat melihat ID tabel yang dikonfigurasi (configuredTableID).

Jika anggota memiliki beberapa asosiasi tabel dikonfigurasi yang direferensikan dalam kueri, mereka akan menerima log kueri untuk setiap tabel yang dikonfigurasi.

Log dibuat untuk kueri yang berisi SQL yang tidak didukung dan didukung di. AWS Clean Rooms Untuk detail selengkapnya, lihat Referensi AWS Clean Rooms SQL.

Log juga dibuat ketika referensi kueri dikonfigurasi tabel yang tidak terkait dengan kolaborasi.

Log tidak dibuat untuk SQL yang salah di AWS Clean Rooms.

Log kueri tidak menunjukkan bahwa kueri berhasil dan keluaran kueri dikirimkan. Mereka mengkonfirmasi bahwa kueri telah dikirimkan oleh anggota yang dapat menanyakan. Log kueri juga mengonfirmasi bahwa kueri berisi SQL yang didukung AWS Clean Rooms dan referensi tabel yang dikonfigurasi terkait dengan kolaborasi.

Misalnya, log tidak dihasilkan jika kueri dibatalkan setelah AWS Clean Rooms memvalidasi kepatuhannya dengan aturan analisis dan selama pemrosesan kueri.

Jika Anda menghapus grup log, Anda harus membuat ulang grup log secara manual dengan nama grup log yang sama (ID kolaborasi kolaborasi). Atau, Anda dapat mematikan dan mengaktifkan log dalam keanggotaan Anda.

Untuk informasi selengkapnya tentang cara mengaktifkan pencatatan kueri, lihatMenciptakan kolaborasi di AWS Clean Rooms.

Untuk informasi selengkapnya tentang CloudWatch Log Amazon, lihat Panduan Pengguna CloudWatch Log Amazon.

Menggunakan log kueri

Kami menyarankan agar anggota secara berkala mengambil tindakan berikut:

• Untuk memverifikasi bahwa kueri cocok dengan kasus penggunaan atau kueri yang disepakati untuk kolaborasi, tinjau kueri yang dijalankan dalam kolaborasi.

  Untuk informasi selengkapnya tentang cara melihat kueri terbaru, lihat Melihat kueri terbaru.

• Untuk memverifikasi bahwa kolom tabel yang dikonfigurasi cocok dengan apa yang telah disepakati untuk kolaborasi, tinjau kolom tabel yang dikonfigurasi yang digunakan dalam aturan analisis anggota kolaborasi dan dalam kueri.

  Untuk informasi selengkapnya tentang cara melihat kolom yang dikonfigurasi, lihat Melihat tabel dan aturan analisis.