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:

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
Sostituisci quanto segue:
  • (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 ddl perché 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              |
+----------------+