Visualização ROW_ACCESS_POLICIES

A visualização INFORMATION_SCHEMA.ROW_ACCESS_POLICIES contém uma linha para cada política de acesso de linha ativa no conjunto de dados ou na região que você especificar. É possível consultar essa visualização para auditar políticas de acesso a linhas e inspecionar predicados de filtro em tabelas no BigQuery. Para mais informações sobre segurança no nível da linha, consulte Introdução à segurança no nível da linha do BigQuery.

Funções exigidas

Para receber as permissões necessárias para consultar a visualização INFORMATION_SCHEMA.ROW_ACCESS_POLICIES, peça ao administrador para conceder a você os seguintes papéis do IAM no conjunto de dados ou projeto:

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esses papéis predefinidos contêm as permissões necessárias para consultar a visualização INFORMATION_SCHEMA.ROW_ACCESS_POLICIES. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As permissões a seguir são necessárias para consultar a visualização INFORMATION_SCHEMA.ROW_ACCESS_POLICIES:

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

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Para mais informações sobre os papéis e as permissões do IAM no BigQuery, consulte Papéis e permissões predefinidos.

Esquema

Quando você consulta a visualização INFORMATION_SCHEMA.ROW_ACCESS_POLICIES, os resultados da consulta contêm uma linha para cada política de acesso de linha ativa no escopo do recurso especificado.

A visualização INFORMATION_SCHEMA.ROW_ACCESS_POLICIES tem o seguinte esquema:

Nome da coluna Tipo de dados Valor
table_catalog STRING O ID do projeto que contém a política de acesso por linha.
table_schema STRING O nome do conjunto de dados que contém a política de acesso por linha.
table_name STRING O nome da tabela que contém a política de acesso de linha.
row_access_policy_name STRING O nome da política de acesso de linha.
filter_predicate STRING A expressão booleana SQL que define quais linhas podem ser acessadas por essa política de acesso de linha.
creation_time TIMESTAMP A hora em que a política de acesso por linha foi criada.
last_modified_time TIMESTAMP A hora em que a política de acesso à linha foi modificada pela última vez.

Para estabilidade, recomendamos que você liste explicitamente as colunas nas consultas do esquema de informações em vez de usar um caractere curinga (SELECT *). Listar explicitamente as colunas evita que as consultas sejam interrompidas se o esquema subjacente mudar.

Escopo e sintaxe

As consultas nessa visualização precisam incluir um conjunto de dados ou um qualificador de região. Para consultas com um qualificador de conjunto de dados, é preciso ter permissões para o conjunto de dados. Para consultas com um qualificador de região, é preciso ter permissões para o projeto. Para mais informações sobre a sintaxe de visualização, consulte Sintaxe. A tabela a seguir explica os escopos de região e recurso dessa visualização:

Nome da visualização Escopo do recurso Escopo da região
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.ROW_ACCESS_POLICIES Nível do projeto REGION
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.ROW_ACCESS_POLICIES Nível do conjunto de dados Local do conjunto de dados
Substitua:
  • Opcional: PROJECT_ID: o ID do seu projeto do Google Cloud . Se não for especificado, o projeto padrão será usado.
  • REGION: qualquer nome da região do conjunto de dados. Por exemplo, `region-us`.
  • DATASET_ID: ID do conjunto de dados. Para mais informações, consulte Qualificador de conjunto de dados.

Limitações

A visualização INFORMATION_SCHEMA.ROW_ACCESS_POLICIES tem as seguintes limitações:

  • A visualização não inclui informações do beneficiário nem uma coluna ddl porque os beneficiários da política de acesso a linhas são armazenados em vinculações de política do IAM, e não em metadados do catálogo do BigQuery. Para ver os principais que receberam acesso por uma política de acesso de linha, consulte Listar políticas de acesso no nível da linha da tabela.
  • Os resultados não incluem políticas de acesso a linhas em conjuntos de dados ocultos ou conjuntos de dados do BigLake.

Exemplos

Nos exemplos a seguir, saiba como consultar a visualização INFORMATION_SCHEMA.ROW_ACCESS_POLICIES.

Consultar políticas de acesso de linha em uma região

O exemplo a seguir recupera metadados de todas as políticas de acesso de linha ativas na região us do projeto padrão:

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;

O resultado será semelhante ao seguinte:

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

Consultar políticas de acesso de linha em um conjunto de dados

O exemplo a seguir recupera metadados de todas as políticas de acesso de linha ativas em um conjunto de dados específico chamado my_dataset:

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

O resultado será semelhante ao seguinte:

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

Contar políticas de acesso de linha em uma tabela

O exemplo a seguir conta o número de políticas de acesso de linha ativas na tabela my_table em 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';

O resultado será semelhante ao seguinte:

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