Visualizzazione OBJECT_PRIVILEGES
La vista INFORMATION_SCHEMA.OBJECT_PRIVILEGES
contiene i metadati sulle associazioni di controllo dell'accesso impostate esplicitamente sugli oggetti BigQuery.
Questa visualizzazione non contiene metadati sulle associazioni di controllo dell'accesso dell'accesso ereditate.
Autorizzazioni obbligatorie
Per eseguire una query sulla vista INFORMATION_SCHEMA.OBJECT_PRIVILEGES
, devi disporre delle seguenti autorizzazioni IAM (Identity and Access Management):
bigquery.datasets.get
per i set di dati.bigquery.tables.getIamPolicy
per tabelle e visualizzazioni.
Per maggiori informazioni sulle autorizzazioni BigQuery, consulta Controllo dell'accesso con IAM.
Schema
Quando esegui una query sulla vista INFORMATION_SCHEMA.OBJECT_PRIVILEGES
, i risultati della query contengono una riga per ogni associazione di controllo dell'accesso dell'accesso per una risorsa.
La vista INFORMATION_SCHEMA.OBJECT_PRIVILEGES
ha il seguente schema:
Nome colonna | Tipo di dati | Valore |
---|---|---|
OBJECT_CATALOG |
STRING |
L'ID del progetto che contiene la risorsa. |
OBJECT_SCHEMA |
STRING |
Il nome del set di dati che contiene la risorsa. Il valore è null per i tipi di risorse del set di dati. |
OBJECT_NAME |
STRING |
Il nome della tabella, della visualizzazione o del set di dati a cui si applica il criterio. |
OBJECT_TYPE |
STRING |
Il tipo di risorsa, come SCHEMA (set di dati), TABLE , VIEW e EXTERNAL .
|
PRIVLEGE_TYPE |
STRING |
L'ID ruolo, ad esempio roles/bigquery.dataEditor . |
GRANTEE |
STRING |
Il tipo e l'utente a cui viene concesso il ruolo. |
Ambito e sintassi
Le query in questa vista devono includere un qualificatore regione. L'ID progetto è facoltativo. Se non viene specificato alcun ID progetto, viene utilizzato il progetto in cui viene eseguita la query. La tabella seguente spiega l'ambito della regione per questa visualizzazione:
Nome vista | Ambito risorsa | Ambito regione |
---|---|---|
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.OBJECT_PRIVILEGES |
A livello di progetto | REGION |
- (Facoltativo)
PROJECT_ID
: l'ID del tuo progetto Google Cloud. Se non specificato, viene utilizzato il progetto predefinito. REGION
: qualsiasi nome della regione del set di dati. Ad esempio:region-us
.
Esempio
-- Returns metadata for the access control bindings for mydataset.
SELECT * FROM myproject.`region-us`.INFORMATION_SCHEMA.OBJECT_PRIVILEGES
WHERE object_name = "mydataset";
Limitazioni
- Le query
OBJECT_PRIVILEGES
devono contenere una clausola WHERE che limita le query a un singolo set di dati, tabella o vista. - Le query per recuperare i metadati di controllo dell'accesso per un set di dati devono specificare
object_name
. - Le query per recuperare i metadati di controllo dell'accesso per una tabella o una vista devono specificare sia
object_name
cheobject_schema
.
Esempi
L'esempio seguente recupera tutte le colonne dalla visualizzazione INFORMATION_SCHEMA.OBJECT_PRIVILEGES
.
Per eseguire la query su un progetto diverso da quello in cui è in esecuzione la query, aggiungi l'ID progetto alla regione nel seguente formato: `project_id`.`region_id`.INFORMATION_SCHEMA.OBJECT_PRIVILEGES
.
L'esempio seguente recupera tutti i metadati di controllo dell'accesso per il set di dati mydataset
nel progetto mycompany
:
SELECT *
FROM mycompany.`region-us`.INFORMATION_SCHEMA.OBJECT_PRIVILEGES
WHERE object_name = "mydataset"
I risultati dovrebbero essere simili ai seguenti:
+----------------+---------------+-------------+-------------+---------------------------+-----------------------------------+ | object_catalog | object_schema | object_name | object_type | privilege_type | grantee | +----------------+---------------+-------------+-------------+---------------------------+-----------------------------------+ | mycompany | NULL | mydataset | SCHEMA | roles/bigquery.dataEditor | projectEditor:mycompany | +----------------+---------------+-------------+-------------+---------------------------+-----------------------------------+ | mycompany | NULL | mydataset | SCHEMA | roles/bigquery.dataOwner | projectOwner:mycompany | +----------------+---------------+-------------+-------------+---------------------------+-----------------------------------+ | mycompany | NULL | mydataset | SCHEMA | roles/bigquery.dataOwner | user:cloudysanfrancisco@gmail.com | +----------------+---------------+-------------+-------------+---------------------------+-----------------------------------+ | mycompany | NULL | mydataset | SCHEMA | roles/bigquery.dataViwer | projectViewer:mycompany | +----------------+---------------+-------------+-------------+---------------------------+-----------------------------------+
L'esempio seguente recupera tutte le informazioni di controllo dell'accesso per la tabella testdata
nel set di dati mydataset
:
SELECT *
FROM mycompany.`region-us`.INFORMATION_SCHEMA.OBJECT_PRIVILEGES
WHERE object_schema = "mydataset" AND object_name = "testdata"
I risultati dovrebbero essere simili ai seguenti:
+----------------+---------------+--------------+-------------+----------------------+------------------------------------+ | object_catalog | object_schema | object_name | object_type | privilege_type | grantee | +----------------+---------------+--------------+-------------+----------------------+------------------------------------+ | mycompany | mydataset | testdata | TABLE | roles/bigquery.admin | user:baklavainthebalkans@gmail.com | +----------------+---------------+--------------+-------------+----------------------+------------------------------------+