Dokumen ini memberikan referensi izin Identity and Access Management (IAM) untuk resource Knowledge Catalog. Gunakan izin ini untuk membuat peran khusus atau untuk memverifikasi akses terperinci yang diperlukan untuk pengelolaan metadata, pemindaian data, operasi lake, tugas, dan lingkungan.
Izin dan peran
Anda tidak memberikan izin kepada pengguna secara langsung. Sebagai gantinya, Anda memberi mereka peran, yang memiliki satu atau beberapa izin di dalamnya. Pendekatan ini selaras dengan prinsip hak istimewa terendah, yang mendorong Anda untuk hanya memberikan akses yang diperlukan bagi pengguna atau akun layanan untuk melakukan tugasnya.
IAM menawarkan peran bawaan untuk kasus penggunaan umum. Jika peran yang telah ditetapkan ini tidak memenuhi kebutuhan spesifik Anda, Anda dapat membuat peran khusus sendiri yang hanya berisi izin spesifik yang diperlukan.
Untuk mengetahui informasi selengkapnya tentang peran Knowledge Catalog yang telah ditetapkan dan izin yang dimilikinya, lihat Peran IAM Knowledge Catalog.
Untuk mengetahui deskripsi mendetail tentang IAM dan fitur-fiturnya, lihat dokumentasi IAM.
Izin Set dan Get kebijakan IAM
Tabel berikut mencantumkan izin yang diperlukan untuk mendapatkan dan menetapkan izin IAM:
| Resource | Metode API | Izin IAM |
|---|---|---|
| Jenis aspek | GetIamPolicy |
dataplex.aspectTypes.getIamPolicy |
| Jenis aspek | SetIamPolicy |
dataplex.aspectTypes.setIamPolicy |
| Grup entri | GetIamPolicy |
dataplex.entryGroups.getIamPolicy |
| Grup entri | SetIamPolicy |
dataplex.entryGroups.setIamPolicy |
| Jenis entri | GetIamPolicy |
dataplex.entryTypes.getIamPolicy |
| Jenis entri | SetIamPolicy |
dataplex.entryTypes.setIamPolicy |
| Danau | GetIamPolicy |
dataplex.lakes.getIamPolicy |
| Danau | SetIamPolicy |
dataplex.lakes.setIamPolicy |
Izin pengelolaan metadata
Kumpulan izin yang diperlukan untuk melakukan operasi pada jenis entri, jenis link entri, jenis aspek, grup entri, entri, dan link entri bergantung pada apakah resource tersebut merupakan resource sistem atau resource kustom. Resource sistem ditentukan oleh Knowledge Catalog, dan resource kustom ditentukan oleh Anda atau organisasi Anda.
Untuk memperkaya entri dan link entri dengan informasi tambahan, Anda dapat melampirkan aspek.
Untuk melakukan operasi yang terkait dengan beberapa resource (misalnya, membuat entri dari jenis entri tertentu, atau menambahkan aspek dari jenis aspek tertentu ke entri atau link entri), Anda mungkin memerlukan beberapa izin yang terkait dengan resource tersebut.
Jenis entri
Untuk membuat dan mengelola jenis entri, Anda harus diberi setidaknya izin standar
create, get, list, update, dan delete.
Saat membuat jenis entri, Anda harus diberi izin untuk menggunakan setiap jenis aspek yang ingin Anda tandai sebagai wajib untuk jenis entri tersebut.
Untuk menggunakan jenis entri (misalnya, untuk membuat entri dari jenis entri), Anda harus
diberi izin use pada jenis entri.
Tabel berikut mencantumkan izin yang diperlukan untuk beroperasi pada jenis entri:
| Operasi | Izin IAM |
|---|---|
Create entry types |
|
Delete entry types |
|
Get entry types |
dataplex.entryTypes.get |
List entry types |
dataplex.entryTypes.list |
Update entry types |
|
|
Menggunakan jenis entri (saat membuat entri, memperbarui kolom entri tingkat atas, dan nilai jenis aspek yang diperlukan) |
|
Jenis aspek
Untuk membuat dan mengelola jenis aspek, Anda harus diberi izin standar create,
get, list, update, dan delete.
Untuk menggunakan jenis aspek (misalnya, untuk melampirkannya sebagai aspek opsional pada
entri atau memperbarui aspek yang diperlukan pada link entri), Anda harus diberi
izin use pada jenis aspek.
Jenis aspek dikategorikan menjadi jenis aspek sistem dan jenis aspek kustom. Jenis aspek sistem dibuat oleh Knowledge Catalog dan jenis aspek kustom dibuat oleh Anda atau organisasi Anda. Jenis aspek sistem selanjutnya dikategorikan menjadi dapat digunakan dan hanya baca. Untuk mengetahui informasi selengkapnya, lihat Kategori jenis aspek.
Tabel berikut mencantumkan izin yang diperlukan untuk beroperasi pada jenis aspek kustom dan sistem:
| Operasi | Izin yang diperlukan untuk jenis aspek kustom | Izin yang diperlukan untuk jenis aspek sistem yang dapat digunakan | Izin yang diperlukan untuk jenis aspek sistem hanya baca |
|---|---|---|---|
Create aspect types |
dataplex.aspectTypes.create |
Tidak berlaku | Tidak berlaku |
Delete aspect types |
dataplex.aspectTypes.delete |
Tidak berlaku | Tidak berlaku |
Get aspect types |
dataplex.aspectTypes.get |
Diberikan kepada allUsers |
Diberikan kepada allUsers |
List aspect types |
dataplex.aspectTypes.list |
Tidak berlaku | Tidak berlaku |
| Saat membuat atau memperbarui entri, tetapkan nilai jenis aspek opsional |
|
|
Tidak berlaku |
| Saat membuat atau memperbarui entri, tetapkan nilai jenis aspek yang diperlukan |
|
|
Tidak berlaku |
Update aspect types |
dataplex.aspectTypes.update |
T/A | T/A |
| Menetapkan nilai jenis aspek yang diperlukan saat membuat atau memperbarui link entri | T/A |
|
T/A |
Grup entri
Untuk membuat dan mengelola grup entri, Anda harus diberi izin create,
get, list, update, dan delete standar.
Grup entri dikategorikan ke dalam grup entri sistem, yang dibuat oleh Knowledge Catalog, dan grup entri kustom, yang dibuat oleh Anda atau organisasi Anda. Untuk mengetahui informasi selengkapnya, lihat Kategori grup entri.
Tabel berikut mencantumkan izin yang diperlukan untuk beroperasi pada grup entri:
| Operasi | Izin yang diperlukan untuk grup entri kustom | Izin yang diperlukan untuk grup entri sistem (dimulai dengan @) |
|---|---|---|
Create entry groups |
dataplex.entryGroups.create |
Tidak berlaku |
Delete entry groups |
dataplex.entryGroups.delete |
Tidak berlaku |
Get entry groups |
dataplex.entryGroups.get |
dataplex.entryGroups.get |
List entry groups |
dataplex.entryGroups.list |
dataplex.entryGroups.list |
Update entry groups |
dataplex.entryGroups.update |
Tidak berlaku |
Entri
Untuk membuat dan mengelola entri, Anda harus diberi izin create, get, list, update, dan delete standar.
Perhatikan hal berikut:
- Untuk metode pencarian (
<code>LookupEntry</code>) dan penelusuran (<code>SearchEntries</code>), izin dari sistem sumber asli diperlukan pada entri. Misalnya, jika sumbernya adalah tabel BigQuery, Anda memerlukan izinbigquery.tables.getuntuk melihat metadata, danbigquery.tables.getDatauntuk melihat aspek data. - Jika izin untuk melihat aspek data tidak ada, entri masih terlihat, tetapi konten aspek data disembunyikan.
- Saat membuat entri atau memperbarui kolom level teratas entri, Anda harus diberi izin
usepada jenis entri. - Saat membuat atau memperbarui aspek yang diperlukan, Anda harus diberi izin
usepada jenis entri dari suatu entri, serta pada jenis aspek yang mendasarinya. Hal ini karena aspek yang diperlukan diterapkan oleh jenis entri. - Saat membuat, memperbarui, atau menghapus aspek opsional, Anda harus diberi
izin
usepada jenis aspek dari suatu aspek. - Saat Anda meng-upsert entri (
<code>UpdateEntry</code>dengan<code>allow_missing = True</code>), Anda harus diberi izincreate.
Untuk mengetahui informasi selengkapnya tentang jenis entri yang menjadi dasar entri, lihat Kategori jenis entri.
Tabel berikut mencantumkan izin yang diperlukan untuk mengoperasikan entri:
| Operasi | Entri berdasarkan jenis entri kustom | Entri berdasarkan jenis entri sistem yang dapat digunakan | Entri berdasarkan jenis entri sistem hanya baca |
|---|---|---|---|
Create entries |
|
|
Tidak berlaku |
Get entries |
Untuk melihat aspek data,
|
Untuk melihat aspek data,
|
Untuk melihat aspek data,
|
List entries |
dataplex.entries.list |
dataplex.entries.list |
dataplex.entries.list |
Lookup entries |
Memerlukan izin baca metadata sistem sumber. Izin untuk membaca data dari sistem sumber diperlukan untuk melihat aspek data. Untuk entri kustom, dengan Knowledge Catalog diperlakukan sebagai sistem sumber, izin ini masing-masing adalah |
Memerlukan izin baca metadata sistem sumber. Izin untuk membaca data dari sistem sumber diperlukan untuk melihat aspek data. Untuk entri kustom, dengan Knowledge Catalog diperlakukan sebagai sistem sumber, izin ini masing-masing adalah |
Memerlukan izin baca metadata sistem sumber. Izin untuk membaca data dari sistem sumber diperlukan untuk melihat aspek data. Untuk entri kustom, dengan Knowledge Catalog diperlakukan sebagai sistem sumber, izin ini masing-masing adalah |
Search entries |
Izin baca sistem sumber asli. Untuk entri kustom, ini adalah |
Izin baca sistem sumber asli. Untuk entri kustom, ini adalah |
Izin baca sistem sumber asli. Untuk entri kustom, ini adalah |
Update entries |
|
|
Kolom tingkat teratas dan aspek yang diperlukan tidak dapat diedit. |
Link Entri
Untuk membuat dan mengelola link entri, Anda harus diberi izin create, get, list,
dan delete di dataplex.entryLinks.
Perhatikan hal berikut:
- Membuat link entri (
CreateEntryLink) juga memerlukan izin pada jenis link entri dan izin ke entri tertentu link. - Saat membuat link entri dengan aspek wajib, Anda memerlukan izin untuk menggunakan jenis aspek.
- Saat melakukan upsert link entri (
UpdateEntryLinkdenganallow_missing = True), Anda juga harus memiliki izin yang sama dengan yang diperlukan untukCreateEntryLink.
Tabel berikut mencantumkan izin yang diperlukan untuk beroperasi pada link entri:
| Operasi | Izin IAM |
|---|---|
| Membuat link entri |
Izin yang diperlukan berdasarkan Jenis Link Entri:
Izin untuk menggunakan jenis link entri:
Izin untuk aspek yang diperlukan yang ditentukan oleh jenis link entri:
|
| Menghapus link entri | dataplex.entryLinks.delete (di grup entri) |
| Mendapatkan link entri |
|
| Mencari link entri |
Memerlukan izin baca metadata sistem sumber pada entri yang link entrinya dicari. Untuk entri kustom tertaut, dengan Knowledge Catalog diperlakukan sebagai sistem sumber, izinnya adalah Untuk entri sistem tertaut, izinnya adalah izin baca sistem sumber entri tertaut. |
| Perbarui link entri |
Izin untuk menggunakan jenis link entri:
Izin untuk aspek yang diperlukan yang ditentukan oleh jenis link entri:
Jika |
Batasan untuk Aspek pada Link Entri
Batasan berikut berlaku untuk penggunaan aspek dengan link entri.
Set data konteks
Set konteks adalah container terbatas dari aset data target dan metadata yang digunakan untuk mendasarkan model AI pada logika bisnis eksklusif Anda. Meskipun dapat berisi informasi khusus database, seperti template kueri SQL atau kueri penelusuran nilai untuk alat text-to-SQL seperti QueryData, Knowledge Studio juga menggunakan set konteks untuk menampung glosarium terminologi, ringkasan tabel terstruktur, dan pemetaan data perusahaan.
Untuk mengetahui informasi selengkapnya tentang cara penggunaan set konteks di seluruh Google Cloud, lihat ringkasan set konteks untuk Knowledge Studio, AlloyDB untuk PostgreSQL, Cloud SQL untuk MySQL, Cloud SQL untuk PostgreSQL, atau Spanner.
Untuk membuat dan mengelola set konteks untuk grounding AI, Anda harus diberi peran IAM berikut:
- Dataplex Catalog Viewer (
roles/dataplex.catalogViewer): Akses hanya baca untuk melihat, mencantumkan, dan mendownload set konteks, serta untuk melihat lokasi. - Dataplex Catalog Editor (
roles/dataplex.catalogEditor): Akses untuk memperbarui, menghapus, mengupload, dan mendownload set konteks. - Dataplex Catalog Admin (
roles/dataplex.catalogAdmin) atau Dataplex Entry Group Owner (roles/dataplex.entryGroupOwner): Akses administratif penuh ke set konteks, termasuk izindataplex.entryGroups.setIamPolicyyang diperlukan untuk membuat set konteks.
Tabel berikut mencantumkan izin IAM yang diperlukan untuk beroperasi pada set konteks:
| Operasi | Izin IAM |
|---|---|
| Membuat set data konteks | dataplex.entryGroups.createContextSet |
| Menghapus set konteks | dataplex.entryGroups.deleteContextSet |
| Membaca set data konteks | dataplex.entryGroups.getContextSet |
| Memperbarui set data konteks | dataplex.entryGroups.updateContextSet |
| Meminta perubahan konteks | dataplex.entryGroups.requestContextChanges |
| Membuat entri konteks | dataplex.entries.createContext |
| Menghapus entri konteks | dataplex.entries.deleteContext |
| Membaca entri konteks | dataplex.entries.getContext |
| Mencantumkan entri konteks | dataplex.entries.listContext |
| Memperbarui entri konteks | dataplex.entries.updateContext |
Untuk mengetahui informasi selengkapnya, lihat Peran IAM Knowledge Catalog.
Izin tugas metadata
Tabel berikut mencantumkan izin yang diperlukan untuk menggunakan tugas impor metadata dan tugas ekspor metadata.
| Operasi | Izin IAM |
|---|---|
| Mengakses hasil yang diekspor dari tugas ekspor metadata |
|
Cancel metadata jobs |
|
Create metadata export jobs |
|
Create metadata import jobs |
|
Get metadata jobs |
|
List metadata jobs |
|
Jenis aspek sistem, jenis entri, dan jenis link entri
Setiap jenis aspek yang ditentukan sistem, jenis entri yang ditentukan sistem, dan jenis link entri yang ditentukan sistem memiliki izin IAM-nya sendiri. Izin ini
menggunakan format seperti dataplex.entryGroups.useASPECT_TYPE,
dataplex.entryGroups.useENTRY_TYPE, atau
dataplex.entryGroups.useENTRY_LINK_TYPE. Misalnya,
izin untuk jenis aspek sistem overview adalah
dataplex.entryGroups.useOverviewAspect.
Tabel berikut mencantumkan izin yang berlaku untuk jenis aspek, jenis entri, dan jenis link entri yang ditentukan sistem.
| Resource | Izin IAM |
|---|---|
contacts (jenis aspek sistem) |
dataplex.entryGroups.useContactsAspect |
data-profile (jenis aspek sistem) |
dataplex.entryGroups.useDataProfileAspect |
data-quality-rule-template (jenis aspek sistem) |
dataplex.entryGroups.useDataQualityRuleTemplateAspect |
data-quality-scorecard (jenis aspek sistem) |
dataplex.entryGroups.useDataQualityScorecardAspect |
data-rules (jenis aspek sistem) |
dataplex.entryGroups.useDataRulesAspect |
generic (jenis aspek sistem) |
dataplex.entryGroups.useGenericAspect |
guidelines (jenis aspek sistem) |
dataplex.entryGroups.useGuidelinesAspect |
overview (jenis aspek sistem) |
dataplex.entryGroups.useOverviewAspect |
schema (jenis aspek sistem) |
dataplex.entryGroups.useSchemaAspect |
schema-join (jenis aspek sistem) |
dataplex.entryGroups.useSchemaJoinAspect |
generic (jenis entri sistem) |
dataplex.entryGroups.useGenericEntry |
definition (jenis link entri sistem) |
dataplex.entryGroups.useDefinitionEntryLink |
related (jenis link entri sistem) |
dataplex.entryGroups.useRelatedEntryLink |
synonym (jenis link entri sistem) |
dataplex.entryGroups.useSynonymEntryLink |
schema-join (jenis link entri sistem) |
dataplex.entryGroups.useSchemaJoinEntryLink |
Izin data lake, zona, dan aset
Tabel berikut mencantumkan izin yang diperlukan untuk beroperasi di lake, zona, dan aset:
| Metode API | Izin IAM |
|---|---|
CreateAsset |
dataplex.assets.create |
CreateLake |
dataplex.lakes.create |
CreateZone |
dataplex.zones.create |
DeleteAsset |
dataplex.assets.delete |
DeleteLake |
dataplex.lakes.delete |
DeleteZone |
dataplex.zones.delete |
GetAsset |
dataplex.assets.get |
GetLake |
dataplex.lakes.get |
GetZone |
dataplex.zones.get |
ListAssetActions |
dataplex.assetActions.list |
ListAssets |
dataplex.assets.list |
ListLakeActions |
dataplex.lakeActions.list |
ListLakes |
dataplex.lakes.list |
ListZoneActions |
dataplex.zoneActions.list |
ListZones |
dataplex.zones.list |
UpdateAsset |
dataplex.assets.update |
UpdateLake |
dataplex.lakes.update |
UpdateZone |
dataplex.zones.update |
Izin tugas
Tabel berikut mencantumkan izin yang diperlukan untuk mengoperasikan tugas:
| Metode API | Izin IAM |
|---|---|
CancelJob |
dataplex.tasks.cancel |
CreateTask |
dataplex.tasks.create |
DeleteTask |
dataplex.tasks.delete |
GetJob |
dataplex.tasks.get |
GetTask |
dataplex.tasks.get |
ListJobs |
dataplex.tasks.get |
ListTasks |
dataplex.tasks.list |
UpdateTask |
dataplex.tasks.update |
Izin metadata
Tabel berikut mencantumkan izin yang diperlukan untuk beroperasi pada entity dan partisi:
| Metode API | Izin IAM |
|---|---|
CreateEntity |
dataplex.entities.create |
CreatePartition |
dataplex.partitions.create |
DeleteEntity |
dataplex.entities.delete |
DeletePartition |
dataplex.partitions.delete |
GetEntity |
dataplex.entities.get |
GetPartition |
dataplex.partitions.get |
ListEntities |
dataplex.entities.list |
ListPartitions |
dataplex.partitions.list |
Izin pemindaian data
Tabel berikut mencantumkan izin yang diperlukan untuk mengoperasikan pemindaian data:
| Metode API | Izin IAM |
|---|---|
CancelDataScanJob |
dataplex.datascans.cancel |
CreateDataScan |
dataplex.datascans.create |
DeleteDataScan |
dataplex.datascans.delete |
GetDataScan (tampilan dasar) |
dataplex.datascans.get |
GetDataScan (tampilan penuh) |
dataplex.datascans.getData |
GetDataScanJob (tampilan dasar) |
dataplex.datascans.get |
GetDataScanJob (tampilan penuh) |
dataplex.datascans.getData |
ListDataScanJobs |
dataplex.datascans.get |
ListDataScans |
dataplex.datascans.list |
RunDataScan |
dataplex.datascans.run |
UpdateDataScan |
dataplex.datascans.update |
Tugas pengayaan Knowledge Studio
Izin berikut diperlukan untuk membuat dan mengelola tugas pengayaan Knowledge Studio:
| Operasi | Izin IAM |
|---|---|
| Membuat tugas pengayaan | dataplex.agentTasks.create |
| Menghapus tugas pengayaan | dataplex.agentTasks.delete |
| Membaca detail tugas pengayaan | dataplex.agentTasks.get |
| Membaca dan mengambil hasil data pokok | dataplex.agentTasks.getData |
| Mencantumkan tugas pengayaan | dataplex.agentTasks.list |
| Memperbarui tugas pengayaan | dataplex.agentTasks.update |
| Menjalankan tugas pengayaan | dataplex.agentTasks.run |
| Meminta perubahan pada grup entri (proposal) | dataplex.entryGroups.requestChanges |
| Menyetujui permintaan perubahan metadata | dataplex.changeRequests.use |
| Membatalkan eksekusi tugas pengayaan | dataplex.agentTasks.cancel |
Izin penyedia autentikasi pihak ketiga
Saat mengonfigurasi konektor eksternal, izin Identitas Agen berikut diperlukan untuk mengelola Penyedia Auth:
| Operasi | Izin IAM |
|---|---|
| Membuat Penyedia Auth | agentidentity.authProviders.create |
| Melihat detail Penyedia Autentikasi | agentidentity.authProviders.get |
| Menghapus Penyedia Autentikasi | agentidentity.authProviders.delete |
| Memperbarui Penyedia Autentikasi | agentidentity.authProviders.update |
Izin pembuatan profil BigQuery
Agar agen pengayaan dapat melakukan pembuatan profil data BigQuery
dan membaca histori kueri tabel, Anda harus memberikan peran BigQuery Data Viewer
(roles/bigquery.dataViewer) dan BigQuery Resource Viewer
(roles/bigquery.resourceViewer) ke Knowledge Catalog Service Agent
(service-<var>PROJECT_NUMBER</var>@gcp-sa-dataplex.iam.gserviceaccount.com) project target.