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:
- Proprietário de dados do BigQuery (
roles/bigquery.dataOwner) - Administrador do BigQuery (
roles/bigquery.admin) - Administrador de segurança do BigQuery (
roles/bigquery.securityAdmin)
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 |
-
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
ddlporque 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 |
+----------------+