Vue ROW_ACCESS_POLICIES

La vue INFORMATION_SCHEMA.ROW_ACCESS_POLICIES contient une ligne pour chaque règle d'accès aux lignes active dans l'ensemble de données ou la région que vous spécifiez. Vous pouvez interroger cette vue pour auditer les règles d'accès aux lignes et inspecter les prédicats de filtre dans les tables BigQuery. Pour en savoir plus sur la sécurité au niveau des lignes, consultez Présentation de la sécurité au niveau des lignes de BigQuery.

Rôles requis

Pour obtenir les autorisations nécessaires pour interroger la vue INFORMATION_SCHEMA.ROW_ACCESS_POLICIES, demandez à votre administrateur de vous accorder les rôles IAM suivants sur l'ensemble de données ou le projet :

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ces rôles prédéfinis contiennent les autorisations requises pour interroger la vue INFORMATION_SCHEMA.ROW_ACCESS_POLICIES. Pour afficher les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour interroger la vue INFORMATION_SCHEMA.ROW_ACCESS_POLICIES :

  • bigquery.rowAccessPolicies.get
  • bigquery.rowAccessPolicies.list

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Pour en savoir plus sur les rôles et les autorisations IAM dans BigQuery, consultez la page Rôles prédéfinis et autorisations.

Schéma

Lorsque vous interrogez la vue INFORMATION_SCHEMA.ROW_ACCESS_POLICIES, les résultats de la requête contiennent une ligne pour chaque règle d'accès aux lignes active dans le champ d'application de la ressource que vous spécifiez.

La vue INFORMATION_SCHEMA.ROW_ACCESS_POLICIES présente le schéma suivant :

Nom de la colonne Type de données Valeur
table_catalog STRING ID du projet contenant la règle d'accès au niveau des lignes.
table_schema STRING Nom de l'ensemble de données contenant la règle d'accès au niveau des lignes.
table_name STRING Nom de la table contenant la règle d'accès aux lignes.
row_access_policy_name STRING Nom de la règle d'accès aux lignes.
filter_predicate STRING Expression booléenne SQL qui définit les lignes accessibles par cette stratégie d'accès aux lignes.
creation_time TIMESTAMP Heure de création de la règle d'accès au niveau des lignes.
last_modified_time TIMESTAMP Heure de la dernière modification de la règle d'accès aux lignes.

Pour plus de stabilité, nous vous recommandons de lister explicitement les colonnes dans vos requêtes de schéma d'informations au lieu d'utiliser un caractère générique (SELECT *). Lister explicitement les colonnes empêche les requêtes de s'interrompre en cas de modification du schéma sous-jacent.

Champ d'application et syntaxe

Les requêtes exécutées sur cette vue doivent inclure un ensemble de données ou un qualificatif de région. Pour les requêtes avec un qualificatif d'ensemble de données, vous devez disposer d'autorisations pour l'ensemble de données. Pour les requêtes avec un qualificatif de région, vous devez disposer des autorisations nécessaires sur le projet. Pour en savoir plus sur la syntaxe des vues, consultez Syntaxe. Le tableau suivant explique la portée des régions et des ressources pour cette vue :

Nom de la vue Champ d'application de la ressource Champ d'application de la région
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.ROW_ACCESS_POLICIES Niveau Projet REGION
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.ROW_ACCESS_POLICIES Niveau de l'ensemble de données Emplacement de l'ensemble de données
Remplacez les éléments suivants :
  • PROJECT_ID (facultatif) : ID de votre projet Google Cloud . Si non spécifié, le projet par défaut est utilisé.
  • REGION : tout nom de région d'ensemble de données. Exemple : `region-us`.
  • DATASET_ID : ID de votre ensemble de données. Pour en savoir plus, consultez la section Qualificatif d'ensemble de données.

Limites

La vue INFORMATION_SCHEMA.ROW_ACCESS_POLICIES présente les limites suivantes :

  • La vue n'inclut pas d'informations sur les bénéficiaires ni de colonne ddl, car les bénéficiaires de règles d'accès au niveau des lignes sont stockés dans des liaisons de stratégie IAM plutôt que dans les métadonnées du catalogue BigQuery. Pour afficher les comptes principaux autorisés à accéder à une règle d'accès aux lignes, consultez Répertorier les règles d'accès au niveau des lignes d'une table.
  • Les résultats n'incluent pas les règles d'accès aux lignes dans les ensembles de données masqués ni dans les ensembles de données BigLake.

Exemples

Les exemples suivants montrent comment interroger la vue INFORMATION_SCHEMA.ROW_ACCESS_POLICIES.

Interroger les règles d'accès aux lignes dans une région

L'exemple suivant récupère les métadonnées de toutes les règles d'accès au niveau des lignes actives dans la région us pour votre projet par défaut :

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;

Le résultat ressemble à ce qui suit :

+---------------+--------------+------------+------------------------+--------------------+-----------------------------+-----------------------------+
| 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 |
+---------------+--------------+------------+------------------------+--------------------+-----------------------------+-----------------------------+

Interroger les règles d'accès aux lignes dans un ensemble de données

L'exemple suivant récupère les métadonnées de toutes les règles d'accès au niveau des lignes actives dans un ensemble de données spécifique nommé my_dataset :

SELECT
  table_name,
  row_access_policy_name,
  filter_predicate,
  creation_time,
  last_modified_time
FROM
  my_dataset.INFORMATION_SCHEMA.ROW_ACCESS_POLICIES;

Le résultat ressemble à ce qui suit :

+------------+------------------------+--------------------+-----------------------------+-----------------------------+
| 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 |
+------------+------------------------+--------------------+-----------------------------+-----------------------------+

Compter les règles d'accès aux lignes d'une table

L'exemple suivant compte le nombre de règles d'accès aux lignes actives sur la table my_table dans 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';

Le résultat ressemble à ce qui suit :

+----------------+
| total_policies |
+----------------+
| 2              |
+----------------+