Questo documento descrive i ruoli IAM (Identity and Access Management) che consentono di utilizzare Data Catalog per cercare e taggare Google Cloud Google Cloud.
Terminologia IAM
- Autorizzazioni
- Opzione selezionata in fase di runtime per consentirti di eseguire un'operazione o eseguire l'accesso è una risorsa Google Cloud. Non ti vengono concesse le autorizzazioni direttamente, vengono invece concessi ruoli che contengono autorizzazioni.
- Ruoli
- Un ruolo è una raccolta predefinita di autorizzazioni. Ruoli personalizzati costituiti di autorizzazioni di un insieme personalizzato.
Visualizza i ruoli di Data Catalog
Nella console Google Cloud, esegui questi passaggi:
Vai alla sezione IAM e Pagina Amministratore > Ruoli.
Nel campo Filtro, seleziona Utilizzato in, digita
Data Catalog
oData Lineage
e fai clic su Invio.Fai clic su un ruolo per visualizzarne le autorizzazioni nel riquadro a destra.
Ad esempio, il ruolo Amministratore Data Catalog ha accesso completo a tutti Risorse di Data Catalog.
Ruoli predefiniti di Data Catalog
Alcuni ruoli predefiniti di Data Catalog includono Data Catalog Amministratore, Visualizzatore Data Catalog e Creatore TagTemplate Data Catalog. Alcuni di questi sono descritti nelle sezioni successive.
Per un elenco e una descrizione dei ruoli predefiniti di Data Catalog e le autorizzazioni associate a ogni ruolo, consulta Ruoli di Data Catalog.
Ruolo Amministratore Data Catalog
Il ruolo roles/datacatalog.admin
ha accesso a tutti
Risorse di Data Catalog. Un amministratore di Data Catalog può
aggiungere diversi tipi di utenti a un progetto Data Catalog.
Ruolo Gestore dati di Data Catalog
Il ruolo roles/datacatalog.dataSteward
ti consente di aggiungere, modificare o
elimina i gestori dati e la panoramica RTF di una voce di dati come
Tabella BigQuery.
Ruolo Visualizzatore Data Catalog
Per semplificare l'accesso alle risorse Google Cloud,
Data Catalog offre il ruolo roles/datacatalog.viewer
autorizzazione di lettura dei metadati per tutte le risorse Google Cloud catalogate.
Questo ruolo concede anche le autorizzazioni per visualizzare il tag Data Catalog modelli e tag.
Concedi il ruolo di Visualizzatore Data Catalog sul tuo progetto per visualizzare Google Cloud in Data Catalog.
Ruolo Creatore TagTemplate Data Catalog
Il ruolo roles/datacatalog.tagTemplateCreator
ti consente di creare modelli di tag.
Ruolo Amministratore ricerca in Data Catalog
Il ruolo roles/datacatalog.searchAdmin
ti consente di recuperare, tramite la ricerca,
a tutte le risorse Google Cloud catalogate all'interno di un progetto o di un'organizzazione.
Ruolo Amministratore configurazione migrazione Data Catalog
Il ruolo roles/datacatalog.migrationConfigAdmin
ti consente di impostare e recuperare
configurazione correlata alla migrazione delle risorse
da Data Catalog a Dataplex Catalog.
Ruoli predefiniti per la derivazione dei dati
Per accedere alla derivazione per qualsiasi voce di Data Catalog, devi
alla voce in Data Catalog. Per accedere al
Voce di Data Catalog, devi disporre di un ruolo Visualizzatore nella
risorsa di sistema o
Visualizzatore Data Catalog
(roles/datacatalog.viewer
) sul progetto in cui è archiviata la
Voce Data Catalog. Questa sezione descrive i ruoli necessari per
per visualizzare la derivazione.
Ruolo Visualizzatore derivazione
Il visualizzatore Data Lineage
Il ruolo (roles/datalineage.viewer
) ti consente di visualizzare Dataplex
la derivazione nella console Google Cloud e leggere le informazioni di derivazione utilizzando
l'API Data Lineage. La
e gli eventi di un determinato processo vengono tutti archiviati nello stesso progetto
e il processo di sviluppo. Nel caso della derivazione automatica,
il processo, le esecuzioni e gli eventi
vengono archiviati nel progetto in cui il job che ha generato la derivazione
in esecuzione. Potrebbe essere, ad esempio, il progetto in cui è stato eseguito
in esecuzione.
Devi avere ruoli diversi per visualizzare la derivazione tra le risorse e per visualizzare i metadati
delle risorse. Nel primo caso, hai bisogno del Visualizzatore della derivazione dei dati (roles/datalineage.viewer
).
Il secondo, richiede gli stessi ruoli utilizzati per accedere alle voci di metadati.
in Data Catalog. Le due sottosezioni seguenti forniscono ulteriori
dettaglio.
Ruoli per visualizzare la derivazione tra due risorse
Per visualizzare la derivazione tra gli asset, devi disporre del ruolo Visualizzatore della derivazione dei dati (roles/datalineage.viewer
)
per i seguenti progetti:
- Il progetto in cui stai visualizzando la derivazione (noto come progetto attivo), cioè il progetto nel menu a discesa nella parte superiore della console Google Cloud oppure il progetto da cui vengono effettuate le chiamate API. Normalmente si tratta Progetto di risorsa di Data Catalog.
- I progetti in cui viene registrata la derivazione (noti come progetto di computing). La derivazione è archiviata nel progetto in cui era eseguito, come descritto sopra. Questo progetto può essere diverso dal progetto che memorizza l'asset per cui stai visualizzando la derivazione.
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso. Potresti anche riuscire a ottenere le autorizzazioni richieste ruoli personalizzati o altri ruoli predefiniti.
A seconda del caso d'uso, concedi il Visualizzatore della derivazione dei dati (roles/datalineage.viewer
)
a livello di cartella o organizzazione per garantire l'accesso alla derivazione (vedi Concedere o revocare un singolo ruolo).
I ruoli richiesti per la derivazione dei dati possono essere concessi solo tramite
con Google Cloud CLI.
Ruoli per visualizzare i metadati delle risorse durante la visualizzazione della derivazione
Quando i metadati relativi a un asset vengono archiviati in Data Catalog,
puoi visualizzare quei metadati se hai un ruolo Visualizzatore per la risorsa di sistema corrispondente
o Visualizzatore Data Catalog (roles/datacatalog.viewer
)
nel progetto in cui è archiviata
la voce di Data Catalog. Tu
potrebbe avere accesso alle risorse presenti nel grafico o nell'elenco della derivazione tramite
ruoli visualizzatore, ma non accesso alla derivazione tra loro. Questo è il caso
Non disponi del ruolo Visualizzatore derivazione dati (roles/datalineage.viewer
)
del progetto in cui è stata registrata la derivazione. In questo caso,
L'API Data Lineage e la console Google Cloud non mostrano la derivazione
non restituisca un errore, per evitare la divulgazione di informazioni sull'esistenza di
la derivazione. Pertanto, l'assenza di una derivazione per una risorsa non significa che ci sia
nessuna derivazione per l'asset, ma potresti non avere accesso a quella derivazione.
Ruolo Producer eventi di derivazione dati
Il ruolo roles/datalineage.producer
consente agli utenti di registrare manualmente la derivazione
utilizzando l'API Data Lineage.
Ruolo di Editor di Data Lineage
Il ruolo roles/datalineage.editor
consente agli utenti di modificare manualmente la derivazione
utilizzando l'API Data Lineage.
Ruolo Amministratore di derivazione dei dati
Il ruolo roles/datalineage.admin
consente agli utenti di eseguire tutte le operazioni di derivazione
elencati in questa sezione.
Ruoli per visualizzare i tag pubblici e privati
Puoi cercare tag pubblici mediante una semplice ricerca. Puoi visualizzare una voce di dati, inclusi i tag pubblici, purché tu disponga delle autorizzazioni necessarie per visualizzare l'immissione dei dati. Non sono richieste autorizzazioni aggiuntive per il modello di tag. Per autorizzazioni necessarie per visualizzare la voce di dati, consultare la tabella in questa sezione.
Tuttavia, ti consigliamo di concedere anche la datacatalog.tagTemplates.get
per gli utenti che devono cercare questi tag pubblici. Questo
consente agli utenti di usare anche il predicato di ricerca tag:
il facet di ricerca del modello di tag nella pagina di ricerca di Data Catalog.
Per i tag privati, devi disporre delle autorizzazioni di visualizzazione sia sul modello di tag che sulla dati per cercare il tag e visualizzarlo nella pagina dei dettagli della voce. Gli utenti devono utilizzare il predicato di ricerca tag: o il facet di ricerca del modello di tag per trovare i tag; la semplice ricerca di tag privati non è supportata.
Note:
L'autorizzazione di visualizzazione necessaria per il modello di tag privato è
datacatalog.tagTemplates.getTag
.Le autorizzazioni di visualizzazione per la voce di dati per i tag pubblici e privati è incluso nella tabella seguente.
Risorsa | Autorizzazione | Ruolo |
---|---|---|
Set di dati, tabelle, modelli, routine e connessioni BigQuery | bigquery.datasets.get bigquery.tables.get bigquery.models.getMetadata bigquery.routines.get bigquery.connections.get |
roles/datacatalog.tagTemplateViewer roles/bigquery.metadataViewer roles/bigquery.connectionUser |
Argomenti Pub/Sub | pubsub.topics.get |
roles/datacatalog.tagTemplateViewer roles/pubsub.viewer |
Istanze, database, tabelle e viste Spanner | Instance: spanner.instances.get Database:spanner.databases.get Table: spanner.databases.get Views: spanner.databases.get datacatalog.tagTemplates.getTag |
Nessun ruolo predefinito disponibile. |
Istanze e tabelle Bigtable | bigtable.instances.get bigtable.tables.get datacatalog.tagTemplates.getTag |
roles/datacatalog.tagTemplateViewer roles/bigtable.viewer |
Servizi, database e tabelle Dataproc Metastore | metastore.tables.get metastore.databases.get metastore.services.get |
roles/datacatalog.tagTemplateViewer roles/metastore.metadataViewer |
Voci personalizzate | datacatalog.entries.get |
Nessun ruolo predefinito disponibile. |
Ruoli per cercare risorse Google Cloud
Prima di cercare, scoprire o visualizzare le risorse Google Cloud, Data Catalog controlla che ti sia stata concessa ruolo IAM con le autorizzazioni di lettura dei metadati richieste da BigQuery, Pub/Sub, Dataproc Metastore o un altro sistema di origine per accedere alla risorsa.
Esempio: controlli di Data Catalog che ti sono stati concessi
un ruolo con bigquery.tables.get permission
prima di visualizzare
Metadati della tabella BigQuery.
La tabella seguente elenca le autorizzazioni e i ruoli associati necessari per: utilizzare Data Catalog per eseguire ricerche nel Google Cloud elencato Google Cloud.
Risorsa | Autorizzazione | Ruolo |
---|---|---|
Set di dati, tabelle, modelli, routine e connessioni BigQuery | bigquery.datasets.get bigquery.tables.get bigquery.models.getMetadata bigquery.routines.get bigquery.connections.get |
roles/bigquery.metadataViewer roles/bigquery.connectionUser Vedi anche il ruolo Visualizzatore Data Catalog |
Argomenti Pub/Sub | pubsub.topics.get |
roles/pubsub.viewer Vedi anche il ruolo Visualizzatore Data Catalog |
Database e tabelle Spanner | Istanza: spanner.instances.get Database: spanner.databases.get Visualizzazioni: spanner.databases.get |
Nessun ruolo predefinito disponibile. |
Istanze e tabelle Bigtable | bigtable.instances.get bigtable.tables.get |
roles/bigtable.viewer Vedi anche il ruolo Visualizzatore Data Catalog |
Lake, zone, tabelle e set di file Dataplex | dataplex.lakes.get dataplex.zones.get dataplex.entities.get dataplex.entities.get |
Nessun ruolo predefinito disponibile. |
Servizi, database e tabelle Dataproc Metastore | metastore.tables.get metastore.databases.get metastore.services.get |
roles/metastore.metadataViewer |
Ruoli per collegare i tag alle risorse Google Cloud
Per collegare tag pubblici e privati alle risorse Google Cloud, sono necessarie le stesse autorizzazioni.
Data Catalog consente agli utenti di estendere i metadati su Google Cloud risorse collegando i tag. Sono definiti uno o più tag che possono essere associati a una risorsa in un modello di tag.
Quando un utente tenta di utilizzare il modello di tag per collegare un tag a un risorsa Google Cloud, Data Catalog controlla le autorizzazioni necessarie per utilizzare il modello di tag e aggiornare la risorsa metadati. Le autorizzazioni vengono concesse tramite i ruoli IAM, come illustrato di seguito .
La tabella seguente elenca le autorizzazioni e i ruoli associati necessari per un di utilizzare Data Catalog per collegare tag pubblici e privati alle risorse Google Cloud elencate.
Ogni riga nella tabella seguente elenca le autorizzazioni necessarie per taggare le risorse. I ruoli corrispondenti possono concedere autorizzazioni aggiuntive. Fai clic su ciascun ruolo per visualizzare tutte le autorizzazioni associate.
Note:
Il proprietario di una voce di dati dispone dell'autorizzazione
datacatalog.entries.updateTag
per impostazione predefinita. A tutti gli altri utenti deve essere concesso l'uso di datacatalog.tagEditor. ruolo.L'autorizzazione
datacatalog.tagTemplates.use
è obbligatoria anche per tutti risorse elencate nella tabella.
Risorsa | Autorizzazioni | Ruolo |
---|---|---|
Set di dati, tabelle, modelli, routine e connessioni BigQuery |
bigquery.datasets.updateTag bigquery.tables.updateTag bigquery.models.updateTag bigquery.routines.updateTag bigquery.connections.updateTag |
roles/datacatalog.tagTemplateUser roles/datacatalog.tagEditor roles/bigquery.dataEditor |
Argomenti Pub/Sub | pubsub.topics.updateTag |
roles/datacatalog.tagTemplateUser roles/datacatalog.tagEditor roles/pubsub.editor |
database e tabelle Spanner. | Istanza: spanner.instances.UpdateTag Database: spanner.databases.UpdateTag Tabella: spanner.databases.UpdateTag Visualizzazioni: spanner.databases.UpdateTag |
Nessun ruolo predefinito disponibile. |
Istanze e tabelle Bigtable | bigtable.instances.update bigtable.tables.update |
roles/datacatalog.tagTemplateUser roles/datacatalog.tagEditor roles/bigtable.admin |
Lake, zone, tabelle e set di file Dataplex | dataplex.lakes.update dataplex.zones.update dataplex.entities.update dataplex.entities.update |
Nessun ruolo predefinito disponibile. |
Servizi, database e tabelle Dataproc Metastore | metastore.tables.update metastore.databases.update metastore.services.update |
roles/datacatalog.tagTemplateUser roles/datacatalog.tagEditor roles/metastore.editor roles/metastore.metadataEditor |
Ruoli personalizzati per le risorse Google Cloud
Ruoli editor predefiniti per voci di dati di altri sistemi Google Cloud
potrebbe fornire un accesso in scrittura più ampio di quello richiesto. Utilizza le funzionalità di
ruoli personalizzati per specificare
*.updateTag
solo su una risorsa Google Cloud.
Ruoli per modificare la panoramica rich text e i gestori dati in Data Catalog
Gli utenti devono disporre dei seguenti ruoli per allegare la panoramica rich text e assegnare i dati alle voci in Data Catalog:
Risorsa | Autorizzazioni | Ruolo |
---|---|---|
Progetti Google Cloud | datacatalog.entries.updateOverview datacatalog.entries.updateContacts |
roles/datacatalog.dataSteward |
Ruoli per modificare la configurazione della migrazione in Data Catalog
Gli utenti devono disporre dei seguenti ruoli per impostare e recuperare la configurazione relativa migrazione da Data Catalog a Dataplex:
Risorsa | Autorizzazioni | Ruolo |
---|---|---|
Organizzazioni e progetti Google Cloud | datacatalog.migrationConfig.set datacatalog.migrationConfig.get |
roles/datacatalog.migrationConfigAdmin |
Federazione delle identità in Data Catalog
La federazione delle identità consente di utilizzare un provider di identità (IdP) esterno per di autenticare e autorizzare gli utenti ai servizi Google Cloud con o IAM.
Data Catalog supporta la federazione delle identità con limitazioni:
- API Data Catalog SearchCatalog e StarEntry supportano solo la Federazione delle identità per la forza lavoro e non sono disponibili per la federazione delle identità per i carichi di lavoro
- Dataplex non supporta la console Google Cloud per gli utenti della federazione delle identità
Per ulteriori informazioni
- Ruoli Dataplex
- Ruoli di Data Catalog
- Controllo dell'accesso a BigQuery
- Controllo accesso Pub/Sub
- Controllo dell'accesso a Dataproc Metastore