Menelusuri referensi

Gunakan penelusuran Katalog Universal Dataplex untuk menemukan Google Cloud resource dari dalam BigQuery, seperti set data dan tabel BigQuery.

Penelusuran Katalog Universal Dataplex mendukung kueri penelusuran bahasa alami (juga dikenal sebagai kueri penelusuran semantik), yang memungkinkan Anda menelusuri resource menggunakan bahasa sehari-hari.

Serupa dengan penelusuran kata kunci, penelusuran bahasa alami menekankan penemuan resource dengan menganalisis metadata yang terkait dengan resource dalam organisasi Anda. Penelusuran mempertimbangkan berbagai metadata yang menjelaskan resource, termasuk metadata yang Anda buat.

Penelusuran natural language berfokus pada peningkatan perolehan, bukan presisi.

Untuk mengetahui informasi selengkapnya tentang cara menelusuri data tabel di BigQuery, lihat Pengantar penelusuran di BigQuery.

Daftar untuk Pratinjau

Untuk mendaftar ke Pratinjau, perwakilan Akun Google Anda harus mengirimkan permintaan dengan mengisi formulir pendaftaran. Setelah Anda mengirimkan formulir, tim BigQuery akan menghubungi Anda untuk memberitahukan langkah berikutnya.

Sebelum memulai

Sebelum menggunakan penelusuran bahasa alami di BigQuery untuk menelusuri resourceGoogle Cloud , selesaikan tugas di bagian ini.

Peran yang diperlukan

Untuk menelusuri resource, Anda memerlukan setidaknya salah satu dari peran IAM Katalog Universal Dataplex berikut di project yang digunakan untuk penelusuran: Dataplex Catalog Admin, Dataplex Catalog Editor, atau Dataplex Catalog Viewer. Izin pada hasil penelusuran diperiksa secara terpisah dari project yang dipilih.

Hasil penelusuran di BigQuery dicakup sesuai dengan izin IAM Anda atas resource yang mendasarinya. Untuk menelusuri resource di BigQuery, Anda harus memiliki izin untuk mengakses resource yang sesuai. Untuk informasi selengkapnya, lihat bagian Cakupan penelusuran dalam dokumen ini.

Misalnya, untuk menelusuri set data, tabel, tampilan, dan model BigQuery, Anda memerlukan izin masing-masing untuk mengakses resource tersebut. Untuk informasi selengkapnya, lihat Izin BigQuery. Daftar berikut menjelaskan izin minimum yang diperlukan:

  • Untuk menelusuri tabel, Anda memerlukan izin bigquery.tables.get untuk tabel tersebut.
  • Untuk menelusuri set data, Anda memerlukan izin bigquery.datasets.get untuk set data tersebut.

Peran BigQuery Metadata Viewer (roles/bigquery.metadataViewer) mencakup izin bigquery.tables.get dan bigquery.datasets.get, dan memungkinkan Anda menelusuri resource BigQuery apa pun.

Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.

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

Mengaktifkan API

Untuk menggunakan penelusuran, pastikan Anda telah mengaktifkan Dataplex API. Dataplex API otomatis diaktifkan untuk semua project Google Cloud baru dengan BigQuery. Jika Dataplex API tidak diaktifkan di project Anda, lihat Mengaktifkan Katalog Universal Dataplex.

  1. Di Google Cloud konsol, buka halaman Penelusuran BigQuery.

    Buka Penelusuran

  2. Di kolom penelusuran, masukkan kueri dalam bahasa alami, lalu tekan Enter. Berikut adalah beberapa contoh kueri:

    • Show me the datasets that contain taxi information
    • Find data on vaccine distribution across different countries
    • Get tables with historical temperature data for major world cities
    • Search for hurricane tracking and storm activity datasets
    • Population data by country

  3. Untuk memfilter penelusuran, klik Filter. Filter berikut tersedia:

    • Cakupan: menelusuri seluruh organisasi (default), project saat ini, atau hanya untuk resource berbintang. Untuk informasi selengkapnya, lihat bagian Cakupan penelusuran dalam dokumen ini.
    • Sistem: Google Cloud layanan tempat resource berada, seperti BigQuery. Sistem Katalog Universal Dataplex berisi grup entri.
    • Projects: project yang akan ditelusuri.
    • Jenis: jenis resource, seperti koneksi BigQuery, bucket Cloud Storage, atau database. Bergantung pada jenis resource, Anda juga dapat memfilter menurut subjenis, seperti jenis koneksi atau dialek SQL.
    • Pilih lokasi: lokasi yang akan ditelusuri.
    • Select datasets: opsi ini membatasi hasil penelusuran ke resource BigQuery yang termasuk dalam set data BigQuery yang dipilih. Di kolom Jenis untuk difilter, masukkan nama set data.
    • Anotasi: Jenis aspek Katalog Universal Dataplex yang terkait dengan resource yang Anda telusuri. Untuk memfilter menurut nilai aspek, klik Filter berdasarkan nilai anotasi, lalu pilih nilai.

    Untuk menghapus filter, klik Hapus di samping filter tertentu yang ingin Anda hapus. Atau, untuk menghapus semua filter, klik Hapus Filter.

    Untuk mengetahui informasi selengkapnya tentang cara filter dievaluasi, lihat bagian Filter dalam dokumen ini.

  4. Opsional: Untuk melihat informasi selengkapnya tentang resource, di hasil penelusuran, klik nama resource.

    Tindakan ini akan membuka ringkasan resource di panel terpisah. Lakukan salah satu tindakan berikut:

    • Untuk membuka resource di layanan tempat resource tersebut berada, klik Buka di PRODUCT_NAME untuk resource tersebut. Misalnya, untuk membuka set data BigQuery di BigQuery Studio, klik Open in Studio. Opsi yang tersedia bergantung pada resource.
    • Untuk melihat metadata Katalog Universal Dataplex yang terkait dengan resource, klik Buka di Katalog Dataplex untuk resource tersebut.
    • Jika memiliki hasil penelusuran penting yang ingin Anda bookmark, Anda dapat memberinya bintang. Klik Bintang untuk resource. Anda dapat melihat resource berbintang di BigQuery Studio.
    • Untuk menutup ringkasan resource di panel terpisah, klik Close.

Filter

Filter memungkinkan Anda mempersempit hasil penelusuran.

Jika Anda memberikan filter di beberapa bagian, filter akan dievaluasi menggunakan operator logika AND. Hasil penelusuran berisi resource yang cocok dengan setidaknya satu kondisi dari setiap bagian yang dipilih. Misalnya, jika Anda memilih sistem BigQuery dan jenis resource dataset, hasil penelusuran akan menyertakan set data BigQuery, tetapi tidak menyertakan set data Vertex AI.

Jika Anda memilih beberapa filter dalam satu bagian, filter tersebut akan dievaluasi menggunakan operator logika OR. Misalnya, jika Anda memilih jenis resource dataset dan jenis resource table, hasil penelusuran akan menyertakan set data dan tabel.

Cakupan penelusuran

Untuk project yang termasuk dalam Google Cloud organisasi, penelusuran beroperasi dalam cakupan organisasi tersebut.

Hasil penelusuran mengikuti izin yang Anda miliki atas resource. Misalnya, jika Anda memiliki akses baca metadata BigQuery ke resource, resource tersebut akan muncul di hasil penelusuran Anda. Jika Anda memiliki akses ke tabel BigQuery, tetapi tidak memiliki akses ke set data yang berisi tabel tersebut, tabel tersebut masih akan muncul seperti yang diharapkan dalam hasil penelusuran.

Hasil penelusuran hanya menyertakan resource yang termasuk dalam perimeter Kontrol Layanan VPC yang sama dengan project tempat penelusuran dilakukan. Saat menggunakan konsol Google Cloud , ini adalah project yang dipilih di konsol.

Langkah berikutnya