Vista ROW_ACCESS_POLICIES
La vista INFORMATION_SCHEMA.ROW_ACCESS_POLICIES contiene una riga per ogni policy di accesso alle righe attiva nel set di dati o nella regione che specifichi. Puoi eseguire query su questa vista per controllare le policy di accesso alle righe e ispezionare i predicati dei filtri nelle tabelle di BigQuery. Per saperne di più sulla sicurezza a livello di riga, consulta Introduzione alla sicurezza a livello di riga di BigQuery.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per eseguire query sulla vista INFORMATION_SCHEMA.ROW_ACCESS_POLICIES, chiedi all'amministratore di concederti i seguenti ruoli IAM sul set di dati o sul progetto:
- BigQuery Data Owner (
roles/bigquery.dataOwner) - Amministratore BigQuery (
roles/bigquery.admin) - BigQuery Security Admin (
roles/bigquery.securityAdmin)
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Questi ruoli predefiniti contengono le autorizzazioni necessarie per eseguire query sulla vista INFORMATION_SCHEMA.ROW_ACCESS_POLICIES. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per eseguire query sulla vista INFORMATION_SCHEMA.ROW_ACCESS_POLICIES sono necessarie le seguenti autorizzazioni:
-
bigquery.rowAccessPolicies.get -
bigquery.rowAccessPolicies.list
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Per saperne di più sui ruoli e sulle autorizzazioni IAM in BigQuery, consulta Ruoli e autorizzazioni predefiniti.
Schema
Quando esegui una query sulla vista INFORMATION_SCHEMA.ROW_ACCESS_POLICIES, i risultati della query contengono una riga per ogni policy di accesso alle righe attiva nell'ambito delle risorse che specifichi.
La vista INFORMATION_SCHEMA.ROW_ACCESS_POLICIES ha il seguente schema:
| Nome colonna | Tipo di dati | Valore |
|---|---|---|
table_catalog |
STRING |
L'ID del progetto che contiene la policy di accesso alle righe. |
table_schema |
STRING |
Il nome del set di dati che contiene la policy di accesso alle righe. |
table_name |
STRING |
Il nome della tabella che contiene la policy di accesso alle righe. |
row_access_policy_name |
STRING |
Il nome della policy di accesso alle righe. |
filter_predicate |
STRING |
L'espressione booleana SQL che definisce le righe accessibili da questa policy di accesso alle righe. |
creation_time |
TIMESTAMP |
La data e l'ora in cui è stata creata la policy di accesso alle righe. |
last_modified_time |
TIMESTAMP |
La data e l'ora dell'ultima modifica della policy di accesso riga. |
Per garantire la stabilità, ti consigliamo di elencare esplicitamente le colonne nelle query di Information Schema anziché utilizzare un carattere jolly (SELECT *). L'elenco esplicito delle colonne impedisce l'interruzione delle query se lo schema sottostante cambia.
Ambito e sintassi
Le query su questa vista devono includere un set di dati o un qualificatore di regione. Per le query con un qualificatore del set di dati, devi disporre delle autorizzazioni per il set di dati. Per le query con un qualificatore di regione, devi disporre delle autorizzazioni per il progetto. Per saperne di più sulla sintassi delle visualizzazioni, consulta Sintassi. La tabella seguente spiega gli ambiti delle regioni e delle risorse per questa visualizzazione:
| Nome vista | Ambito risorsa | Ambito della regione |
|---|---|---|
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.ROW_ACCESS_POLICIES |
Livello progetto | REGION |
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.ROW_ACCESS_POLICIES |
Livello del set di dati | Posizione del set di dati |
-
(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`. -
DATASET_ID: l'ID del set di dati. Per saperne di più, consulta Qualificatore del set di dati.
Limitazioni
La vista INFORMATION_SCHEMA.ROW_ACCESS_POLICIES presenta le seguenti limitazioni:
- La vista non include le informazioni sul beneficiario o una colonna
ddlperché i beneficiari della policy di accesso alle righe sono archiviati nelle associazioni delle policy IAM anziché nei metadati del catalogo BigQuery. Per visualizzare le entità a cui è stato concesso l'accesso da una policy di accesso alle righe, consulta Elenca le policy di accesso a livello di riga della tabella. - I risultati non includono le policy di accesso alle righe nei set di dati nascosti o nei set di dati BigLake.
Esempi
Gli esempi seguenti mostrano come eseguire query sulla vista INFORMATION_SCHEMA.ROW_ACCESS_POLICIES.
Esegui query sulle policy di accesso alle righe in una regione
L'esempio seguente recupera i metadati per tutte le policy di accesso alle righe attive nella regione us per il progetto predefinito:
SELECT
table_catalog,
table_schema,
table_name,
row_access_policy_name,
filter_predicate,
creation_time,
last_modified_time
FROM
`region-us`.INFORMATION_SCHEMA.ROW_ACCESS_POLICIES;
Il risultato è simile al seguente:
+---------------+--------------+------------+------------------------+--------------------+-----------------------------+-----------------------------+
| table_catalog | table_schema | table_name | row_access_policy_name | filter_predicate | creation_time | last_modified_time |
+---------------+--------------+------------+------------------------+--------------------+-----------------------------+-----------------------------+
| my_project | my_dataset | my_table | apac_filter | region = 'APAC' | 2026-03-10 14:22:05.123 UTC | 2026-03-10 14:22:05.123 UTC |
| my_project | my_dataset | my_table | us_filter | region = 'US' | 2026-03-10 14:25:18.456 UTC | 2026-03-12 09:15:42.789 UTC |
+---------------+--------------+------------+------------------------+--------------------+-----------------------------+-----------------------------+
Esegui query sulle policy di accesso alle righe in un set di dati
L'esempio seguente recupera i metadati per tutte le policy di accesso alle righe attive in un set di dati specifico denominato my_dataset:
SELECT
table_name,
row_access_policy_name,
filter_predicate,
creation_time,
last_modified_time
FROM
my_dataset.INFORMATION_SCHEMA.ROW_ACCESS_POLICIES;
Il risultato è simile al seguente:
+------------+------------------------+--------------------+-----------------------------+-----------------------------+
| table_name | row_access_policy_name | filter_predicate | creation_time | last_modified_time |
+------------+------------------------+--------------------+-----------------------------+-----------------------------+
| my_table | apac_filter | region = 'APAC' | 2026-03-10 14:22:05.123 UTC | 2026-03-10 14:22:05.123 UTC |
| my_table | us_filter | region = 'US' | 2026-03-10 14:25:18.456 UTC | 2026-03-12 09:15:42.789 UTC |
+------------+------------------------+--------------------+-----------------------------+-----------------------------+
Conta le policy di accesso alle righe di una tabella
L'esempio seguente conteggia il numero di policy di accesso alle righe attive nella tabella my_table in my_project.my_dataset:
SELECT
COUNT(1) AS total_policies
FROM
my_project.my_dataset.INFORMATION_SCHEMA.ROW_ACCESS_POLICIES
WHERE
table_name = 'my_table';
Il risultato è simile al seguente:
+----------------+
| total_policies |
+----------------+
| 2 |
+----------------+