Mengonfigurasi dan menggunakan resolusi entity di BigQuery

Dokumen ini menunjukkan cara menerapkan resolusi entitas untuk pengguna akhir resolusi entity (selanjutnya disebut sebagai pengguna akhir) dan penyedia identitas.

Pengguna akhir dapat menggunakan dokumen ini untuk terhubung dengan penyedia identitas dan menggunakan layanan penyedia untuk mencocokkan kumpulan data. Penyedia identitas dapat menggunakan dokumen ini untuk menyiapkan dan mengonfigurasi layanan untuk dibagikan kepada pengguna akhir di Google Cloud Marketplace.

Alur kerja untuk pengguna akhir

Bagian berikut menunjukkan cara mengonfigurasi resolusi entity di BigQuery kepada pengguna akhir. Untuk representasi visual penyiapan lengkap, lihat arsitektur untuk resolusi entity.

Sebelum memulai

1. Hubungi dan jalin hubungan dengan penyedia identitas. BigQuery mendukung resolusi entity dengan LiveRamp.
2. Dapatkan item berikut dari penyedia identitas:
   • Kredensial akun layanan
   • Tanda tangan fungsi jarak jauh
3. Buat dua set data di project Anda:
   • Set data input
   • Set data output

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan guna menjalankan tugas resolusi entitas, minta administrator Anda untuk memberi Anda peran IAM berikut:

• Agar akun layanan penyedia identitas dapat membaca set data input dan menulis ke set data output:
  • BigQuery Data Viewer (roles/bigquery.dataViewer) pada set data input
  • BigQuery Data Editor (roles/bigquery.dataEditor) pada set data output

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Menerjemahkan atau me-resolve entitas

Untuk mengetahui petunjuk penyedia identitas tertentu, lihat bagian berikut.

LiveRamp

Prasyarat

• Mengonfigurasi Identitas Tersemat LiveRamp di BigQuery. Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan Identitas Tersemat LiveRamp di BigQuery.
• Bekerjasamalah dengan LiveRamp untuk mengaktifkan kredensial API agar dapat digunakan dengan Embedded Identity. Untuk mengetahui informasi selengkapnya, lihat Autentikasi.

Penyiapan

Langkah-langkah berikut diperlukan saat Anda menggunakan Identitas Tersemat LiveRamp untuk pertama kalinya. Setelah penyiapan selesai, hanya tabel input dan tabel metadata yang perlu diubah di antara sesi.

Membuat tabel input

Buat tabel di set data input. Isi tabel dengan RampID, domain target, dan jenis target. Untuk mengetahui detail dan contohnya, lihat Kolom dan Deskripsi Tabel Input.

Membuat tabel metadata

Tabel metadata digunakan untuk mengontrol eksekusi LiveRamp Embedded Identity di BigQuery. Buat tabel metadata di set data input. Isi tabel metadata dengan client ID, mode eksekusi, domain target, dan jenis target. Untuk mengetahui detail dan contohnya, lihat Kolom dan Deskripsi Tabel Metadata.

Berbagi tabel dengan LiveRamp

Beri akun layanan Google Cloud LiveRamp akses untuk melihat dan memproses data dalam set data input Anda. Untuk mengetahui detail dan contohnya, lihat Membagikan Tabel dan Set Data dengan LiveRamp.

Menjalankan tugas identitas tersemat

Untuk menjalankan tugas identitas tersemat dengan LiveRamp di BigQuery, lakukan hal berikut:

1. Pastikan semua RampID yang dienkode di domain Anda ada di tabel input.
2. Pastikan tabel metadata Anda masih akurat sebelum menjalankan tugas.
3. Hubungi [e-mail] dengan permintaan proses tugas. Sertakan project ID, ID set data, dan ID tabel (jika ada) untuk tabel input, tabel metadata, dan set data output Anda. Untuk informasi selengkapnya, lihat Memberi tahu LiveRamp untuk Memulai Transcoding.

Hasil biasanya dikirim ke set data output Anda dalam waktu tiga hari kerja.

Dukungan LiveRamp

Untuk masalah dukungan, hubungi Dukungan Identitas LiveRamp.

Penagihan LiveRamp

LiveRamp menangani penagihan untuk resolusi entity.

Alur kerja untuk penyedia identitas

Bagian berikut menunjukkan cara mengonfigurasi resolusi entity di BigQuery kepada penyedia identitas. Untuk representasi visual penyiapan lengkap, lihat arsitektur untuk resolusi entity.

Sebelum memulai

1. Buat tugas Cloud Run atau Cloud Function untuk diintegrasikan dengan fungsi jarak jauh. Kedua opsi tersebut cocok untuk tujuan ini.

2. Perhatikan nama akun layanan yang terkait dengan Cloud Run atau Cloud Function:

   1. Di konsol Google Cloud, buka halaman Cloud Functions.

      Buka Cloud Functions

   2. Klik nama fungsi, lalu klik tab Details.

   3. Di panel General Information, temukan dan catat nama akun layanan untuk fungsi jarak jauh.

3. Buat fungsi jarak jauh.

4. Mengumpulkan akun utama pengguna akhir dari pengguna akhir.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan guna menjalankan tugas resolusi entitas, minta administrator Anda untuk memberi Anda peran IAM berikut:

• Untuk akun layanan yang terkait dengan fungsi Anda guna melakukan pembacaan dan penulisan pada set data terkait dan meluncurkan tugas:
  • BigQuery Data Editor (roles/bigquery.dataEditor) pada project
  • BigQuery Job User (roles/bigquery.jobUser) pada project
• Agar akun utama pengguna akhir dapat melihat dan terhubung ke fungsi jarak jauh:
  • BigQuery Connection User (roles/bigquery.connectionUser) yang terhubung ke internet
  • BigQuery Data Viewer (roles/bigquery.dataViewer) pada set data bidang kontrol dengan fungsi jarak jauh

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Membagikan fungsi jarak jauh resolusi entitas

Ubah dan bagikan kode antarmuka jarak jauh berikut kepada pengguna akhir. Pengguna akhir memerlukan kode ini untuk memulai tugas resolusi entity.

`PARTNER_PROJECT_ID.DATASET_ID`.match`(LIST_OF_PARAMETERS)

Ganti LIST_OF_PARAMETERS dengan daftar parameter yang diteruskan ke fungsi jarak jauh.

Opsional: Memberikan metadata tugas

Secara opsional, Anda dapat memberikan metadata tugas menggunakan fungsi jarak jauh terpisah atau dengan menulis tabel status baru di set data output pengguna. Contoh metadata mencakup status dan metrik tugas.

Penagihan untuk penyedia identitas

Untuk menyederhanakan penagihan dan orientasi pelanggan, sebaiknya Anda mengintegrasikan layanan resolusi entity dengan Google Cloud Marketplace. Hal ini memungkinkan Anda menyiapkan model harga berdasarkan penggunaan tugas penyelesaian entity, dan Google akan menangani penagihan untuk Anda. Untuk informasi selengkapnya, lihat Menawarkan produk software as a service (SaaS).