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:

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
Reemplaza lo siguiente:
  • Opcional: PROJECT_ID es 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 ddl porque 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              |
+----------------+