Untuk menggunakan Data Catalog, Anda harus mengaktifkan Data Catalog API di project Google Cloud yang berisi resource yang akan dibuat di Data Catalog atau yang dapat diakses di sistem Google Cloud lainnya dengan API tersebut. Kami menyebut project ini sebagai "project resource" Katalog Data.
Dalam kasus umum, jika hanya memiliki satu project, Anda hanya perlu mengaktifkan Data Catalog API di dalamnya untuk mengakses semua resource yang ada di dalamnya. Panduan memulai Data Catalog adalah contoh pembuatan project yang mengaktifkan Data Catalog API dan berisi tabel BigQuery yang Anda akses serta template dan tag tag Data Catalog.
Menggunakan template tag dalam beberapa project
Segala sesuatu di Google Cloud berada dalam sebuah project, termasuk template tag Anda. Namun, Anda dapat menggunakan template tag dari satu project untuk membuat tag di
project lainnya jika Anda mengizinkan project lain untuk menggunakan template tersebut.
Untuk melakukannya, gunakan peran IAM TagTemplate Owner
, Creator
, User
, dan Viewer
.
Misalnya: Jika project A memberikan peran TagTemplate User
ke akun layanan yang dimiliki oleh project B, project B akan mengizinkan project B membuat tag menggunakan template-nya. Project A juga dapat mengizinkan akun layanan yang sama untuk mengubah tag yang dibuat menggunakan peran Tag Editor
.
Jika project A tidak memberikan otorisasi pada project B, project B tidak dapat memberi tag pada resource datanya sendiri menggunakan template tag project A—project tersebut harus membuat template-nya sendiri.
Praktik terbaik: Buat template di project pusat jika template tersebut relevan untuk lebih dari satu project. Selain itu, tim tata kelola data Anda harus memiliki template tag bersama dan mengelolanya atas nama organisasi.
Mengidentifikasi project resource Data Catalog
Tabel berikut mencantumkan Data Catalog API dan project resource terkait tempat Data Catalog API harus diaktifkan.
API Katalog Data | Project resource | Notes |
---|---|---|
dapatkan/cari/telusuri | project akun layanan | Jika X-Goog-User-Project ditetapkan di Header HTTP/gRPC, aktifkan juga Data Catalog API di project pengguna untuk mengaktifkan kuota dan penagihan terhadap X-Goog-User-Project, bukan akun layanan. |
membuat/memperbarui/menghapus | project yang diidentifikasi oleh /project-id/ dalam parameter resource permintaan API |
Pengecualian: lihat createTag/updateTag/deleteTag di baris berikutnya. |
createTag/updateTag/deleteTag | project penampung template tag | Karena Data Catalog API telah diaktifkan di project penampung template tag saat template dibuat, tidak diperlukan tindakan lebih lanjut untuk memanggil API ini. Catatan: Project yang diidentifikasi oleh parameter parent untuk tag dan template tag yang digunakan untuk membuat tag harus berasal dari organisasi yang sama. |
Catatan:
service account project
: project tempat Anda telah membuat kredensial akun layanan untuk mengautentikasi kode aplikasi Anda.resource parameter
: parameter yang diteruskan dalam permintaan API yang mengidentifikasi resource yang terkait dengan permintaan (misalnya, lihatproject-id
dalam parameterparent
tagTemplates.create).
Langkah selanjutnya
- Ikuti Memulai Data Catalog.