Questo documento fornisce un riferimento alle autorizzazioni di Identity and Access Management (IAM) per le risorse di Knowledge Catalog. Utilizza queste autorizzazioni per creare ruoli personalizzati o per verificare l'accesso granulare richiesto per la gestione dei metadati, le scansioni dei dati, le operazioni sui lake, le attività e gli ambienti.
Autorizzazioni e ruoli
Non concedi direttamente le autorizzazioni agli utenti. Devi invece concedere loro dei ruoli, che contengono una o più autorizzazioni. Questo approccio è in linea con il principio del privilegio minimo, che ti incoraggia a concedere solo l'accesso necessario a un utente o a un account di servizio per svolgere le proprie attività.
IAM offre ruoli predefiniti per i casi d'uso comuni. Se questi ruoli predefiniti non soddisfano le tue esigenze specifiche, puoi creare ruoli personalizzati contenenti solo le autorizzazioni specifiche richieste.
Per saperne di più sui ruoli predefiniti di Knowledge Catalog e sulle autorizzazioni che contengono, consulta Ruoli IAM di Knowledge Catalog.
Per una descrizione dettagliata di IAM e delle sue funzionalità, consulta la documentazione di IAM.
Autorizzazioni di impostazione e recupero delle policy IAM
La tabella seguente elenca le autorizzazioni necessarie per ottenere e impostare le autorizzazioni IAM:
| Risorsa | Metodo API | Autorizzazioni IAM |
|---|---|---|
| Tipi di aspetto | GetIamPolicy |
dataplex.aspectTypes.getIamPolicy |
| Tipi di aspetto | SetIamPolicy |
dataplex.aspectTypes.setIamPolicy |
| Gruppi di voci | GetIamPolicy |
dataplex.entryGroups.getIamPolicy |
| Gruppi di voci | SetIamPolicy |
dataplex.entryGroups.setIamPolicy |
| Tipi di voci | GetIamPolicy |
dataplex.entryTypes.getIamPolicy |
| Tipi di voci | SetIamPolicy |
dataplex.entryTypes.setIamPolicy |
| Lake | GetIamPolicy |
dataplex.lakes.getIamPolicy |
| Lake | SetIamPolicy |
dataplex.lakes.setIamPolicy |
Autorizzazioni di gestione dei metadati
L'insieme di autorizzazioni necessarie per eseguire operazioni su tipi di voci, tipi di link di voci, tipi di aspetti, gruppi di voci, voci e link di voci dipende dal fatto che le risorse siano di sistema o personalizzate. Le risorse di sistema sono definite da Knowledge Catalog, mentre le risorse personalizzate sono definite da te o dalla tua organizzazione.
Per arricchire le voci e i link alle voci con informazioni aggiuntive, puoi allegare aspetti.
Per eseguire operazioni correlate a più risorse (ad esempio, la creazione di una voce di un tipo di voce specifico o l'aggiunta di un aspetto di un tipo di aspetto specifico a una voce o a un link alla voce), potresti aver bisogno di più autorizzazioni associate alle risorse.
Tipi di voci
Per creare e gestire i tipi di voci, devi disporre almeno delle autorizzazioni standard create, get, list, update e delete.
Quando crei un tipo di voce, devi disporre delle autorizzazioni per utilizzare ogni tipo di aspetto che vuoi contrassegnare come obbligatorio per quel tipo di voce.
Per utilizzare un tipo di voce (ad esempio, per creare voci di un tipo di voce), devi disporre dell'autorizzazione use per il tipo di voce.
La tabella seguente elenca le autorizzazioni necessarie per operare sui tipi di voci:
| Operazione | Autorizzazioni IAM |
|---|---|
Create entry types |
|
Delete entry types |
|
Get entry types |
dataplex.entryTypes.get |
List entry types |
dataplex.entryTypes.list |
Update entry types |
|
|
Utilizza i tipi di voci (durante la creazione di voci, l'aggiornamento dei campi delle voci di primo livello e dei valori dei tipi di aspetti obbligatori) |
|
Tipi di aspetto
Per creare e gestire i tipi di aspetto, devi disporre delle autorizzazioni standard create,
get, list, update e delete.
Per utilizzare un tipo di aspetto (ad esempio, per collegarlo come aspetto facoltativo a una voce o aggiornare l'aspetto obbligatorio sul link della voce), devi disporre dell'autorizzazione use per il tipo di aspetto.
I tipi di aspetto sono suddivisi in tipi di aspetto di sistema e tipi di aspetto personalizzati. I tipi di aspetto di sistema vengono creati da Knowledge Catalog, mentre i tipi di aspetto personalizzati vengono creati da te o dalla tua organizzazione. I tipi di aspetti di sistema sono ulteriormente classificati in utilizzabili e di sola lettura. Per saperne di più, consulta Categorie di tipi di aspetto.
La tabella seguente elenca le autorizzazioni necessarie per operare sui tipi di aspetti personalizzati e di sistema:
| Operazione | Autorizzazioni richieste per i tipi di aspetto personalizzati | Autorizzazioni richieste per i tipi di aspetto di sistema utilizzabili | Autorizzazioni richieste per i tipi di aspetto di sistema di sola lettura |
|---|---|---|---|
Create aspect types |
dataplex.aspectTypes.create |
Non applicabile | Non applicabile |
Delete aspect types |
dataplex.aspectTypes.delete |
Non applicabile | Non applicabile |
Get aspect types |
dataplex.aspectTypes.get |
Concessa a allUsers |
Concessa a allUsers |
List aspect types |
dataplex.aspectTypes.list |
Non applicabile | Non applicabile |
| Quando crei o aggiorni le voci, imposta i valori facoltativi del tipo di aspetto |
|
|
Non applicabile |
| Quando crei o aggiorni le voci, imposta i valori dei tipi di aspetto richiesti |
|
|
Non applicabile |
Update aspect types |
dataplex.aspectTypes.update |
N/D | N/D |
| Imposta i valori dei tipi di aspetto richiesti durante la creazione o l'aggiornamento del link di voce | N/D |
|
N/D |
Gruppi di voci
Per creare e gestire i gruppi di voci, devi disporre delle autorizzazioni standard create,
get, list, update e delete.
I gruppi di voci sono suddivisi in gruppi di voci di sistema, creati da Knowledge Catalog, e gruppi di voci personalizzati, creati da te o dalla tua organizzazione. Per saperne di più, consulta Categorie di gruppi di voci.
La tabella seguente elenca le autorizzazioni necessarie per operare sui gruppi di voci:
| Operazione | Autorizzazioni richieste per i gruppi di voci personalizzati | Autorizzazioni richieste per i gruppi di voci di sistema (che iniziano con @) |
|---|---|---|
Create entry groups |
dataplex.entryGroups.create |
Non applicabile |
Delete entry groups |
dataplex.entryGroups.delete |
Non applicabile |
Get entry groups |
dataplex.entryGroups.get |
dataplex.entryGroups.get |
List entry groups |
dataplex.entryGroups.list |
dataplex.entryGroups.list |
Update entry groups |
dataplex.entryGroups.update |
Non applicabile |
Voci
Per creare e gestire le voci, devi disporre delle autorizzazioni standard create, get,
list, update e delete.
Tieni presente quanto segue:
- Per i metodi di ricerca (
<code>LookupEntry</code>) e ricerca (<code>SearchEntries</code>), è richiesta l'autorizzazione del sistema di origine originale per la voce. Ad esempio, se l'origine è una tabella BigQuery, devi disporre dell'autorizzazionebigquery.tables.getper visualizzare i metadati e dell'autorizzazionebigquery.tables.getDataper visualizzare gli aspetti dei dati. - Se l'autorizzazione per visualizzare gli aspetti dei dati non è presente, le voci sono comunque visibili, ma i contenuti degli aspetti dei dati sono nascosti.
- Quando crei una voce o aggiorni i campi di primo livello di una voce, devi disporre dell'autorizzazione
useper il tipo di voce. - Quando crei o aggiorni un aspetto obbligatorio, devi disporre dell'autorizzazione
usesul tipo di voce di una voce, nonché sul tipo di aspetto sottostante. Questo perché gli aspetti obbligatori vengono applicati dal tipo di voce. - Quando crei, aggiorni o elimini un aspetto facoltativo, devi disporre dell'autorizzazione
usesul tipo di aspetto. - Quando applichi l'upsert a una voce (
<code>UpdateEntry</code>con<code>allow_missing = True</code>), devi disporre dell'autorizzazionecreate.
Per saperne di più sui tipi di voci su cui si basano le voci, consulta Categorie di tipi di voci.
La tabella seguente elenca le autorizzazioni necessarie per operare sulle voci:
| Operazione | Voce basata sul tipo di voce personalizzata | Voce basata sul tipo di voce di sistema utilizzabile | Voce basata sul tipo di voce di sistema di sola lettura |
|---|---|---|---|
Create entries |
|
|
Non applicabile |
Get entries |
Per visualizzare gli aspetti dei dati, è necessario anche |
Per visualizzare gli aspetti dei dati, è necessario anche |
Per visualizzare gli aspetti dei dati, è necessario anche |
List entries |
dataplex.entries.list |
dataplex.entries.list |
dataplex.entries.list |
Lookup entries |
Richiede l'autorizzazione in lettura dei metadati del sistema di origine. Per visualizzare gli aspetti dei dati, è necessaria l'autorizzazione per leggere i dati dal sistema di origine. Per le voci personalizzate, in cui Knowledge Catalog viene considerato il sistema di origine, queste autorizzazioni sono rispettivamente |
Richiede l'autorizzazione in lettura dei metadati del sistema di origine. Per visualizzare gli aspetti dei dati, è necessaria l'autorizzazione per leggere i dati dal sistema di origine. Per le voci personalizzate, in cui Knowledge Catalog viene considerato il sistema di origine, queste autorizzazioni sono rispettivamente |
Richiede l'autorizzazione in lettura dei metadati del sistema di origine. Per visualizzare gli aspetti dei dati, è necessaria l'autorizzazione per leggere i dati dal sistema di origine. Per le voci personalizzate, in cui Knowledge Catalog viene considerato il sistema di origine, queste autorizzazioni sono rispettivamente |
Search entries |
Autorizzazione in lettura del sistema di origine originale. Per le voci personalizzate, questo valore è |
Autorizzazione in lettura del sistema di origine originale. Per le voci personalizzate, questo valore è |
Autorizzazione in lettura del sistema di origine originale. Per le voci personalizzate, questo valore è |
Update entries |
|
|
I campi di primo livello e gli aspetti obbligatori non possono essere modificati. |
Link alle voci
Per creare e gestire i link di ingresso, devi disporre delle autorizzazioni create, get, list
e delete su dataplex.entryLinks.
Tieni presente quanto segue:
- La creazione di link di voci (
CreateEntryLink) richiede anche le autorizzazioni per il tipo di link di voce e per le voci specifiche del link. - Quando crei un link di voce con un aspetto obbligatorio, devi disporre delle autorizzazioni per utilizzare il tipo di aspetto.
- Quando applichi l'upsert a un link di ingresso (
UpdateEntryLinkconallow_missing = True), devi anche disporre delle stesse autorizzazioni richieste perCreateEntryLink.
La tabella seguente elenca le autorizzazioni necessarie per operare sui link di entrata:
| Operazione | Autorizzazioni IAM |
|---|---|
| Crea link di accesso |
Autorizzazioni richieste in base al tipo di link di ingresso:
Autorizzazione per utilizzare il tipo di link di voce:
Autorizzazioni per tutti gli aspetti obbligatori specificati dal tipo di link della voce:
|
| Elimina i link di accesso | dataplex.entryLinks.delete (sul gruppo di voci) |
| Ottieni i link di accesso |
|
| Link alle voci di ricerca |
Richiede l'autorizzazione in lettura dei metadati del sistema di origine per la voce per cui vengono cercati i link. Per le voci personalizzate collegate, in cui Knowledge Catalog è considerato il sistema di origine, l'autorizzazione è Per le voci di sistema collegate, l'autorizzazione è l'autorizzazione in lettura del sistema di origine della voce collegata. |
| Aggiorna il link di accesso |
Autorizzazione per utilizzare il tipo di link di voce:
Autorizzazioni per tutti gli aspetti obbligatori specificati dal tipo di link della voce:
Se |
Limitazioni per gli aspetti sui link di ingresso
Le seguenti limitazioni si applicano all'utilizzo degli aspetti con i link di ingresso.
Set di contesti
I set di contesto sono container delimitati di asset di dati e metadati di destinazione utilizzati per basare i modelli di AI sulla tua logica di business proprietaria. Sebbene possano contenere informazioni specifiche del database, come modelli di query SQL o query di ricerca di valori per strumenti text-to-SQL come QueryData, Knowledge Studio utilizza i set di contesto anche per ospitare glossari terminologici, panoramiche di tabelle strutturate e mappature dei dati aziendali.
Per saperne di più su come vengono utilizzati i set di contesto in Google Cloud, consulta la panoramica dei set di contesto per Knowledge Studio, AlloyDB per PostgreSQL, Cloud SQL per MySQL, Cloud SQL per PostgreSQL o Spanner.
Per creare e gestire i set di contesto per il grounding dell'AI, devi disporre dei seguenti ruoli IAM:
- Dataplex Catalog Viewer (
roles/dataplex.catalogViewer): accesso di sola lettura per visualizzare, elencare e scaricare set di contesto e per visualizzare le località. - Dataplex Catalog Editor (
roles/dataplex.catalogEditor): accesso per aggiornare, eliminare, caricare e scaricare set di contesto. - Dataplex Catalog Admin (
roles/dataplex.catalogAdmin) o Dataplex Entry Group Owner (roles/dataplex.entryGroupOwner): accesso amministrativo completo ai set di contesto, inclusa l'autorizzazionedataplex.entryGroups.setIamPolicynecessaria per creare set di contesto.
La tabella seguente elenca le autorizzazioni IAM necessarie per operare sui set di contesto:
| Operazione | Autorizzazioni IAM |
|---|---|
| Crea set di contesti | dataplex.entryGroups.createContextSet |
| Elimina set di contesti | dataplex.entryGroups.deleteContextSet |
| Leggi i set di contesti | dataplex.entryGroups.getContextSet |
| Aggiorna set di contesti | dataplex.entryGroups.updateContextSet |
| Modifiche al contesto della richiesta | dataplex.entryGroups.requestContextChanges |
| Crea voci di contesto | dataplex.entries.createContext |
| Elimina le voci di contesto | dataplex.entries.deleteContext |
| Lettura delle voci contesto | dataplex.entries.getContext |
| Elenca le voci di contesto | dataplex.entries.listContext |
| Aggiorna le voci di contesto | dataplex.entries.updateContext |
Per saperne di più, consulta Ruoli IAM di Knowledge Catalog.
Autorizzazioni per i job di metadati
La tabella seguente elenca le autorizzazioni necessarie per lavorare con i job di importazione dei metadati e i job di esportazione dei metadati.
| Operazione | Autorizzazioni IAM |
|---|---|
| Accedi ai risultati esportati dai job di esportazione dei metadati |
|
Cancel metadata jobs |
|
Create metadata export jobs |
|
Create metadata import jobs |
|
Get metadata jobs |
|
List metadata jobs |
|
Tipi di aspetti, tipi di voci e tipi di link di voci di sistema
Ogni tipo di aspetto, tipo di voce e tipo di link alla voce definito dal sistema ha le proprie autorizzazioni IAM. Queste autorizzazioni utilizzano un formato come dataplex.entryGroups.useASPECT_TYPE, dataplex.entryGroups.useENTRY_TYPE o dataplex.entryGroups.useENTRY_LINK_TYPE. Ad esempio, l'autorizzazione per il tipo di aspetto di sistema overview è dataplex.entryGroups.useOverviewAspect.
La tabella seguente elenca le autorizzazioni che si applicano ai tipi di aspetto, ai tipi di voci e ai tipi di link alle voci definiti dal sistema.
| Risorsa | Autorizzazioni IAM |
|---|---|
contacts (tipo di aspetto di sistema) |
dataplex.entryGroups.useContactsAspect |
data-profile (tipo di aspetto di sistema) |
dataplex.entryGroups.useDataProfileAspect |
data-quality-rule-template (tipo di aspetto di sistema) |
dataplex.entryGroups.useDataQualityRuleTemplateAspect |
data-quality-scorecard (tipo di aspetto di sistema) |
dataplex.entryGroups.useDataQualityScorecardAspect |
data-rules (tipo di aspetto di sistema) |
dataplex.entryGroups.useDataRulesAspect |
generic (tipo di aspetto di sistema) |
dataplex.entryGroups.useGenericAspect |
guidelines (tipo di aspetto di sistema) |
dataplex.entryGroups.useGuidelinesAspect |
overview (tipo di aspetto di sistema) |
dataplex.entryGroups.useOverviewAspect |
schema (tipo di aspetto di sistema) |
dataplex.entryGroups.useSchemaAspect |
schema-join (tipo di aspetto di sistema) |
dataplex.entryGroups.useSchemaJoinAspect |
generic (tipo di voce di sistema) |
dataplex.entryGroups.useGenericEntry |
definition (tipo di link della voce di sistema) |
dataplex.entryGroups.useDefinitionEntryLink |
related (tipo di link della voce di sistema) |
dataplex.entryGroups.useRelatedEntryLink |
synonym (tipo di link della voce di sistema) |
dataplex.entryGroups.useSynonymEntryLink |
schema-join (tipo di link della voce di sistema) |
dataplex.entryGroups.useSchemaJoinEntryLink |
Autorizzazioni per lake, zone e asset
La tabella seguente elenca le autorizzazioni necessarie per operare su lake, zone e asset:
| Metodo API | Autorizzazioni 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 |
Autorizzazioni per le attività
La tabella seguente elenca le autorizzazioni necessarie per operare sulle attività:
| Metodo API | Autorizzazioni 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 |
Autorizzazioni per i metadati
La tabella seguente elenca le autorizzazioni necessarie per operare su entità e partizioni:
| Metodo API | Autorizzazioni 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 |
Autorizzazioni per l'analisi dei dati
La tabella seguente elenca le autorizzazioni necessarie per operare sulle scansioni dei dati:
| Metodo API | Autorizzazioni IAM |
|---|---|
CancelDataScanJob |
dataplex.datascans.cancel |
CreateDataScan |
dataplex.datascans.create |
DeleteDataScan |
dataplex.datascans.delete |
GetDataScan (visualizzazione di base) |
dataplex.datascans.get |
GetDataScan (visualizzazione completa) |
dataplex.datascans.getData |
GetDataScanJob (visualizzazione di base) |
dataplex.datascans.get |
GetDataScanJob (visualizzazione completa) |
dataplex.datascans.getData |
ListDataScanJobs |
dataplex.datascans.get |
ListDataScans |
dataplex.datascans.list |
RunDataScan |
dataplex.datascans.run |
UpdateDataScan |
dataplex.datascans.update |
Attività di arricchimento di Knowledge Studio
Per creare e gestire le attività di arricchimento di Knowledge Studio sono necessarie le seguenti autorizzazioni:
| Operazione | Autorizzazioni IAM |
|---|---|
| Crea attività di arricchimento | dataplex.agentTasks.create |
| Elimina le attività di arricchimento | dataplex.agentTasks.delete |
| Leggi i dettagli dell'attività di arricchimento | dataplex.agentTasks.get |
| Leggere e recuperare i risultati dei dati sottostanti | dataplex.agentTasks.getData |
| Elenca le attività di arricchimento | dataplex.agentTasks.list |
| Aggiorna le attività di arricchimento | dataplex.agentTasks.update |
| Esegui attività di arricchimento | dataplex.agentTasks.run |
| Richiedere modifiche ai gruppi di voci (proposte) | dataplex.entryGroups.requestChanges |
| Approva le richieste di modifica dei metadati | dataplex.changeRequests.use |
| Annulla le esecuzioni delle attività di arricchimento | dataplex.agentTasks.cancel |
Autorizzazioni dei provider di autenticazione di terze parti
Quando configuri i connettori esterni, per gestire i provider di autenticazione sono necessarie le seguenti autorizzazioni Agent Identity:
| Operazione | Autorizzazioni IAM |
|---|---|
| Crea provider di autenticazione | agentidentity.authProviders.create |
| Visualizza i dettagli del provider di autenticazione | agentidentity.authProviders.get |
| Elimina provider di autenticazione | agentidentity.authProviders.delete |
| Aggiorna i provider di autenticazione | agentidentity.authProviders.update |
Autorizzazioni di profilazione di BigQuery
Per consentire all'agente di arricchimento di eseguire la profilazione dei dati BigQuery e leggere la cronologia delle query della tabella, devi concedere i ruoli BigQuery Data Viewer (roles/bigquery.dataViewer) e BigQuery Resource Viewer (roles/bigquery.resourceViewer) all'agente di servizio Knowledge Catalog (service-<var>PROJECT_NUMBER</var>@gcp-sa-dataplex.iam.gserviceaccount.com) del progetto di destinazione.