Vista ROW_ACCESS_POLICIES
La vista INFORMATION_SCHEMA.ROW_ACCESS_POLICIES contiene una fila para cada
política de acceso de fila activa en el conjunto de datos o la región que especifiques. Puedes
consultar esta vista para auditar las políticas de acceso a las filas y, también, inspeccionar los predicados de filtro
en las tablas de BigQuery. Para obtener más información sobre la seguridad a nivel de fila, consulta Introducción a la seguridad a nivel de fila de BigQuery.
Roles obligatorios
Para obtener los permisos que
necesitas para consultar la vista INFORMATION_SCHEMA.ROW_ACCESS_POLICIES,
pídele a tu administrador que te otorgue los
siguientes roles de IAM en el conjunto de datos o proyecto:
- Propietario de datos de BigQuery (
roles/bigquery.dataOwner) - Administrador de BigQuery (
roles/bigquery.admin) - Administrador de seguridad de BigQuery (
roles/bigquery.securityAdmin)
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
Estos roles predefinidos contienen
los permisos necesarios para consultar la vista INFORMATION_SCHEMA.ROW_ACCESS_POLICIES. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para consultar la vista INFORMATION_SCHEMA.ROW_ACCESS_POLICIES:
-
bigquery.rowAccessPolicies.get -
bigquery.rowAccessPolicies.list
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.
Para obtener más información sobre las funciones de IAM y los permisos en BigQuery, consulta Funciones y permisos predefinidos.
Esquema
Cuando consultas la vista INFORMATION_SCHEMA.ROW_ACCESS_POLICIES, los resultados
contienen una fila por cada política de acceso a filas activa en el permiso del recurso
que especifiques.
La vista INFORMATION_SCHEMA.ROW_ACCESS_POLICIES tiene el siguiente esquema:
| Nombre de la columna | Tipo de datos | Valor |
|---|---|---|
table_catalog |
STRING |
Es el ID del proyecto que contiene la política de acceso de filas. |
table_schema |
STRING |
Es el nombre del conjunto de datos que contiene la política de acceso de filas. |
table_name |
STRING |
Es el nombre de la tabla que contiene la política de acceso de fila. |
row_access_policy_name |
STRING |
Es el nombre de la política de acceso de fila. |
filter_predicate |
STRING |
Es la expresión booleana de SQL que define a qué filas se puede acceder con esta política de acceso de fila. |
creation_time |
TIMESTAMP |
Es la hora en la que se creó la política de acceso a las filas. |
last_modified_time |
TIMESTAMP |
Es la hora en la que se modificó por última vez la política de acceso de fila. |
Para garantizar la estabilidad, te recomendamos que enumeres de forma explícita las columnas en tus consultas de esquema de información en lugar de
usar un comodín (SELECT *). Enumerar las columnas de forma explícita evita que las consultas
se interrumpan si cambia el esquema subyacente.
Permiso y sintaxis
Las consultas realizadas a esta vista deben incluir un conjunto de datos o un calificador de región. Para consultas con un calificador de conjunto de datos, debes tener permisos para el conjunto de datos. Para consultas con un calificador de región, debes tener permisos para el proyecto. Para obtener más información sobre la sintaxis de las vistas, consulta Sintaxis. En la siguiente tabla, se explican los permisos de la región y los recursos para esta vista:
| Nombre de la vista | Permiso del recurso | Permiso de la región |
|---|---|---|
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.ROW_ACCESS_POLICIES |
Nivel de proyecto | REGION |
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.ROW_ACCESS_POLICIES |
Nivel de conjunto de datos | Ubicación del conjunto de datos |
-
Opcional:
PROJECT_IDes el ID de tu proyecto de Google Cloud . Si no se especifica, se usa el proyecto predeterminado. -
REGION: Cualquier nombre de región del conjunto de datos. Por ejemplo,`region-us`. -
DATASET_ID: Es el ID del conjunto de datos. Para obtener más información, consulta Calificador de conjunto de datos.
Limitaciones
La vista INFORMATION_SCHEMA.ROW_ACCESS_POLICIES tiene las siguientes limitaciones:
- La vista no incluye información del beneficiario ni una columna
ddlporque los beneficiarios de la política de acceso a nivel de fila se almacenan en vinculaciones de políticas de IAM, en lugar de metadatos del catálogo de BigQuery. Para ver las principales a las que se les otorgó acceso mediante una política de acceso de fila, consulta Enumera las políticas de acceso a nivel de las filas de la tabla. - Los resultados no incluyen políticas de acceso de fila en conjuntos de datos ocultos ni conjuntos de datos de BigLake.
Ejemplos
En los siguientes ejemplos, se muestra cómo consultar la vista INFORMATION_SCHEMA.ROW_ACCESS_POLICIES.
Consulta las políticas de acceso de fila en una región
En el siguiente ejemplo, se recuperan los metadatos de todas las políticas de acceso de filas activas en
la región us para tu proyecto predeterminado:
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;
El resultado es similar al siguiente:
+---------------+--------------+------------+------------------------+--------------------+-----------------------------+-----------------------------+
| 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 |
+---------------+--------------+------------+------------------------+--------------------+-----------------------------+-----------------------------+
Consulta las políticas de acceso de fila en un conjunto de datos
En el siguiente ejemplo, se recuperan los metadatos de todas las políticas de acceso a nivel de fila activas en un
conjunto de datos específico llamado my_dataset:
SELECT
table_name,
row_access_policy_name,
filter_predicate,
creation_time,
last_modified_time
FROM
my_dataset.INFORMATION_SCHEMA.ROW_ACCESS_POLICIES;
El resultado es similar al siguiente:
+------------+------------------------+--------------------+-----------------------------+-----------------------------+
| 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 |
+------------+------------------------+--------------------+-----------------------------+-----------------------------+
Cuenta las políticas de acceso de fila en una tabla
En el siguiente ejemplo, se cuenta la cantidad de políticas de acceso de fila activas en la
tabla my_table en 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';
El resultado es similar al siguiente:
+----------------+
| total_policies |
+----------------+
| 2 |
+----------------+