Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Untuk menggunakan Data Catalog, Anda harus
mengaktifkan Data Catalog API
dalam Google Cloud
project
yang berisi resource yang akan Anda buat di Data Catalog atau
akses di sistem Google Cloud lain 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
Semua yang ada 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 referensi Data Catalog
Tabel berikut mencantumkan Data Catalog API dan project resource terkait tempat Data Catalog API harus diaktifkan.
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.
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 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, lihat project-id dalam
parameter tagTemplates.createparent).
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-02-01 UTC."],[[["\u003cp\u003eThe Data Catalog API must be enabled in a Google Cloud project, referred to as the "resource project," to create resources in Data Catalog or access them in other Google Cloud systems.\u003c/p\u003e\n"],["\u003cp\u003eTag templates, although created within a specific project, can be used to create tags in other projects if the appropriate IAM roles (\u003ccode\u003eTagTemplate Owner\u003c/code\u003e, \u003ccode\u003eCreator\u003c/code\u003e, \u003ccode\u003eUser\u003c/code\u003e, and \u003ccode\u003eViewer\u003c/code\u003e) are granted.\u003c/p\u003e\n"],["\u003cp\u003eThe project hosting the tag template is responsible for billing, even if the tags are utilized by other projects.\u003c/p\u003e\n"],["\u003cp\u003eFor optimal management, it's a best practice to create tag templates in a centralized project if they're intended for use across multiple projects, and a data governance team should manage them.\u003c/p\u003e\n"],["\u003cp\u003eThe necessary project in which the Data Catalog API must be enabled varies according to which Data Catalog APIs are being utilized, such as \u003ccode\u003eget/lookup/search\u003c/code\u003e vs.\u003ccode\u003ecreate/update/delete\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Data Catalog resource projects\n\nTo use Data Catalog, you must\n[enable the Data Catalog API](/apis/docs/enable-disable-apis#enable_an_api)\nin a Google Cloud\n[project](/resource-manager/docs/cloud-platform-resource-hierarchy#projects)\nthat contains the resources you will create in Data Catalog or\naccess in other Google Cloud systems with the API. We refer\nto this project as the Data Catalog \"resource project\".\n\nIn the common case, if you have only one project, you only need to enable\nthe Data Catalog API in it to access all the resources it contains.\nThe [Data Catalog quickstart](/data-catalog/docs/quickstarts/quickstart-search-tag)\nis an example of the creation of a project that has the Data Catalog\nAPI enabled and contains a BigQuery table you access as well as a\nData Catalog tag template and tag.\n\n### Using tag templates in multiple projects\n\nEverything in Google Cloud lives in a project, including your tag\ntemplates. However, you can use tag templates from one project to create tags in\nanother if you authorize the other project to use the templates.\nTo do this, use the `TagTemplate Owner`, `Creator`, `User`, and `Viewer` IAM\nroles.\n\nFor example: If project A grants the `TagTemplate User` role to a service\naccount owned by project B, this authorizes project B to create tags using its\ntemplates. Project A can also authorize the same service account to modify the\ncreated tags using the `Tag Editor` role.\n\nIf project A does not authorize project B, project B cannot tag its own data\nresources using project A's tag templates---it must create its own templates.\n| **Important:** The project that hosts your tag template is billed for tags created from it, even if they are used by other projects.\n\n**Best practice:** Create templates in a central project\nif they are relevant to more than one project. Also, your data governance team\nshould own the shared tag templates and maintain them on behalf of the\norganization.\n\n### Identifying the Data Catalog resource project\n\nThe following table lists Data Catalog APIs and the\nassociated resource project(s) where Data Catalog\nAPI must be enabled.\n\n**Notes:**\n\n- `service account project`: the project in which you have generated\n [service account credentials](/iam/docs/service-account-overview#what-are-service-accounts)\n to authenticate your application code.\n\n- `resource parameter`: the parameter passed in the API request that\n identifies the resource associated with the request (for example, see `project-id` in the\n [tagTemplates.create](/data-catalog/docs/reference/rest/v1beta1/projects.locations.tagTemplates/create)\n `parent` parameter).\n\nWhat's next\n-----------\n\n- Follow [Getting started with Data Catalog](/data-catalog/docs/quickstarts/quickstart-search-tag)."]]
