Menggunakan template kueri

Template kueri ruang bersih data BigQuery mempercepat waktu untuk mendapatkan insight dan memberikan lapisan keamanan dan kontrol tambahan untuk meminimalkan masalah ekstraksi data. Dengan telah menentukan dan membatasi kueri yang dapat dijalankan di ruang bersih data, Anda dapat melakukan hal berikut:

• Membantu mencegah kebocoran data sensitif. Saat pelanggan ruang bersih data menjalankan kueri di ruang bersih, fleksibilitas yang lebih besar untuk menjelajahi data dapat meningkatkan risiko pemaparan informasi sensitif secara tidak sengaja atau disengaja bagi pemilik data.

• Menyederhanakan orientasi dan penggunaan bagi pengguna yang kurang paham teknologi. Banyak penyedia data mengharapkan pelanggan ruang bersih data memiliki kemahiran teknis yang lebih rendah, terutama dalam menulis kueri SQL yang berfokus pada privasi dan mengalokasikan anggaran privasi.

• Menjamin hasil analisis yang konsisten bagi pelanggan ruang bersih data. Tanpa mengontrol kueri yang dijalankan di ruang bersih data, akan lebih sulit untuk menerapkan aturan analisis data tertentu dan memverifikasi kepatuhan terhadap peraturan privasi.

Dengan template kueri, pemilik dan kontributor data dapat membuat kueri yang telah ditentukan dan disetujui yang disesuaikan dengan kasus penggunaan ruang bersih data. Mereka juga dapat memublikasikan kueri ini agar dapat digunakan oleh pelanggan. Kueri yang telah ditentukan menggunakan fungsi bernilai tabel (TVF) di BigQuery untuk meneruskan seluruh tabel atau kolom tertentu sebagai parameter input dan menampilkan tabel sebagai output.

Batasan

• Template kueri hanya mendukung maksimal dua referensi data—yaitu, data yang digunakan untuk menentukan kueri TVF dan input parameter data yang diterima TVF.
  • Beberapa tabel atau tampilan dapat dirujuk dalam definisi kueri TVF, tetapi semuanya harus dimiliki oleh pemilik atau pihak data yang sama.
• TVF template kueri hanya mendukung jenis tetap TABLE dan VIEW.
• Definisi template kueri tunduk pada batasan yang sama seperti TVF.

Sebelum memulai

Aktifkan Analytics Hub API untuk project Google Cloud Anda dengan mengikuti langkah-langkah berikut:

gcloud services enable analyticshub.googleapis.com

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk melakukan tugas dalam dokumen ini, minta administrator Anda untuk memberikan peran IAM berikut:

• Membuat atau menghapus TVF di ruang bersih data:
  • Publisher Analytics Hub (roles/analyticshub.publisher) di project
  • Pelanggan Analytics Hub (roles/analyticshub.subscriber) di project
• Memberi otorisasi TVF: BigQuery Data Owner (roles/bigquery.dataOwner) di project
• Menambahkan, memperbarui, atau menghapus listingan TVF di ruang bersih data:
  • Publisher Analytics Hub (roles/analyticshub.publisher) di project
  • Pelanggan Analytics Hub (roles/analyticshub.subscriber) di project
• Buat template kueri:
  • Publisher Analytics Hub (roles/analyticshub.publisher) di project
  • Pelanggan Analytics Hub (roles/analyticshub.subscriber) di project
• Menyetujui template kueri:
  • Publisher Analytics Hub (roles/analyticshub.publisher) di project
  • BigQuery Data Owner (roles/bigquery.dataOwner) di project
• Berlangganan ruang bersih data dengan template kueri:
  • Pelanggan Analytics Hub (roles/analyticshub.subscriber) di project
  • Pemilik Langganan Analytics Hub (roles/analyticshub.subscriptionOwner) di project tempat Anda ingin berlangganan ruang bersih data
• Jalankan kueri yang ditentukan dalam template kueri:
  • BigQuery Data Viewer (roles/bigquery.dataViewer) di project
  • Pengguna BigQuery (roles/bigquery.user) di project

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk melakukan tugas dalam dokumen ini. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Menambahkan TVF yang ada ke ruang bersih data

Anda dapat menambahkan TVF yang ada ke ruang bersih data menggunakan Analytics Hub API.

Gunakan metode projects.locations.dataExchanges.listings.create.

Contoh berikut menunjukkan cara memanggil metode projects.locations.dataExchanges.listings.create menggunakan perintah curl:

    curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" -H 'x-goog-user-project:DCR_PROJECT_ID' -X POST https://analyticshub.googleapis.com/v1/projects/DCR_PROJECT_ID/locations/LOCATION/dataExchanges/CLEAN_ROOM_ID/listings?listingId=LISTING_ID -d
    '{"bigqueryDataset":{"dataset":"projects/PROJECT_ID/datasets/DATASET_ID","selectedResources";:[{"routine":"projects/PROJECT_ID/datasets/DATASET_ID/tables/ROUTINE_ID"}],},"displayName":LISTING_NAME"}'

Ganti kode berikut:

• DCR_PROJECT_ID: project ID project tempat ruang bersih data dibuat.
• PROJECT_ID: project ID project tempat set data sumber berada.
• DATASET_ID: ID set data sumber.
• LOCATION: lokasi ruang bersih data.
• CLEAN_ROOM_ID: ID ruang bersih data.
• LISTING_ID: ID listingan.
• LISTING_NAME: nama listingan.
• ROUTINE_ID: ID rutinitas.

Peran template kueri

Ada tiga peran utama untuk menggunakan template kueri ruang bersih data. Setiap peran memiliki alur kerja tertentu, yang dijelaskan di bagian selanjutnya dalam dokumen ini.

• Pembuat template: pengguna yang menentukan kueri yang akan dijalankan dalam ruang bersih. Peran ini setara dengan salah satu peran IAM berikut: Admin Analytics Hub, Penayang Analytics Hub, atau Admin Listingan Analytics Hub. Untuk mengetahui informasi selengkapnya, lihat Alur kerja pembuat template.

• Penyetuju template: pemilik data yang harus menyetujui referensi template kueri sebelum template tersedia untuk digunakan. Peran ini setara dengan salah satu peran IAM berikut: Admin Analytics Hub, Penayang Analytics Hub, atau Admin Listingan Analytics Hub. Untuk mengetahui informasi selengkapnya, lihat Alur kerja pemberi persetujuan template.

• Pelanggan template: pengguna yang berlangganan ruang bersih dan hanya dapat menjalankan kueri yang disetujui dalam template. Peran ini setara dengan peran IAM Pelanggan Analytics Hub. Untuk mengetahui informasi selengkapnya, lihat Alur kerja pelanggan template.

Alur kerja pembuat template

Sebagai pembuat template kueri, Anda dapat melakukan hal berikut:

• Buat template kueri.
• Perbarui template kueri.
• Kirimkan template kueri untuk ditinjau.
• Hapus template kueri.

Menambahkan listingan ke ruang bersih data

Sebelum membuat template kueri, Anda harus menambahkan data ke ruang bersih data. Untuk membuat listingan di ruang bersih data, ikuti langkah-langkah berikut:

1. Buka halaman Berbagi (Analytics Hub).

   Buka Berbagi (Analytics Hub)

2. Klik nama tampilan ruang bersih data tempat Anda ingin membuat template kueri.

3. Klik Tambahkan data dan ikuti langkah-langkah untuk membuat tampilan dengan aturan analisis yang dikonfigurasi. Untuk mengetahui petunjuk selengkapnya, lihat Membuat listingan (menambahkan data).

   1. Untuk menambahkan data dari pihak lain, bagikan ruang bersih kepada kontributor tepercaya lain. Kontributor data ini juga harus menambahkan data ke ruang bersih agar memenuhi syarat untuk digunakan dalam template kueri.

4. Tetapkan kontrol traffic keluar data untuk listingan.

5. Tetapkan kontrol metadata untuk listingan. Jika Anda hanya ingin membagikan skema dan deskripsi data yang ditambahkan pada langkah sebelumnya (dan bukan data yang dibagikan itu sendiri), pilih Kecualikan akses ke listingan dari set data tertaut.

6. Tinjau detail listingan.

7. Klik Tambahkan data. Metadata tampilan yang dibuat untuk data Anda kini ditambahkan ke ruang bersih.

Membuat template kueri

Pilih salah satu opsi berikut:

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" -H 'x-goog-user-project:DCR_PROJECT_ID' -X POST https://analyticshub.googleapis.com/v1/projects/DCR_PROJECT_ID/locations/LOCATION/dataExchanges/CLEAN_ROOM_ID/queryTemplates?queryTemplateId=QUERY_TEMPLATE_ID -d
  'query_template {
  display_name: "DISPLAY_NAME",
  routine {
    definition_body: "QUERY_TEMPLATE_ID(TVF arguments) AS (TVF_DEFINITION)"
  }
}'

  query_template1(t1 TABLE<year INT64>) AS (SELECT * FROM `project_id.dataset_id.table_id` WHERE year = table_id.year)

  CREATE OR REPLACE TABLE FUNCTION <approvers_dataset>.query_template1(t1 TABLE, y INT64)
  AS (SELECT * FROM t1 WHERE year > y)

Memperbarui template kueri

Anda hanya dapat memperbarui template kueri jika statusnya DRAF. Jika template kueri telah dikirim untuk ditinjau, Anda tidak dapat lagi mengubahnya.

Untuk memperbarui template kueri, pilih salah satu opsi berikut: