Untuk menggunakan Data Catalog, Anda harus mengaktifkan Data Catalog API di project Google Cloud yang berisi resource yang akan Anda buat di Data Catalog atau akses di sistem Google Cloud lainnya dengan API. Kami menyebut project ini sebagai "project resource" Katalog Data.
Pada umumnya, 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 Data Catalog.
Menggunakan template tag di beberapa project
Semuanya di Google Cloud berada dalam project, termasuk template tag Anda. Namun, Anda dapat menggunakan template tag dari satu project untuk membuat tag di project lain jika Anda memberikan otorisasi kepada 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, hal ini akan memberi otorisasi project B untuk membuat tag menggunakan template-nya. Project A juga dapat memberi otorisasi pada akun layanan yang sama untuk mengubah tag yang dibuat menggunakan peran Tag Editor
.
Jika project A tidak memberikan otorisasi ke project B, project B tidak dapat memberi tag pada resource datanya sendiri menggunakan template tag project A—project B harus membuat templatenya sendiri.
Praktik terbaik: Buat template dalam project terpusat jika template tersebut relevan dengan 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.
Data Catalog API | Project resource | Catatan |
---|---|---|
get/lookup/search | project akun layanan | Jika X-Goog-User-Project ditentukan 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. |
create/update/delete | 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 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 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 parameter tagTemplates.createparent
).
Langkah selanjutnya
- Ikuti Memulai Data Catalog.