ROW_ACCESS_POLICIES 视图
INFORMATION_SCHEMA.ROW_ACCESS_POLICIES 视图中的每一行对应您指定的数据集或区域中的每个有效行访问权限政策。您可以查询此视图,以审核行访问权限政策并检查 BigQuery 中各表的过滤谓词。如需详细了解行级安全性,请参阅 BigQuery 行级安全性简介。
所需的角色
如需获得查询 INFORMATION_SCHEMA.ROW_ACCESS_POLICIES 视图所需的权限,请让管理员向您授予数据集或项目的以下 IAM 角色:
- BigQuery Data Owner (
roles/bigquery.dataOwner) - BigQuery Admin (
roles/bigquery.admin) - BigQuery Security Admin (
roles/bigquery.securityAdmin)
如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
这些预定义角色可提供查询 INFORMATION_SCHEMA.ROW_ACCESS_POLICIES 视图所需的权限。如需查看所需的确切权限,请展开所需权限部分:
所需权限
查询 INFORMATION_SCHEMA.ROW_ACCESS_POLICIES 视图需要以下权限:
-
bigquery.rowAccessPolicies.get -
bigquery.rowAccessPolicies.list
如需详细了解 BigQuery 中的 IAM 角色和权限,请参阅预定义角色和权限。
架构
当您查询 INFORMATION_SCHEMA.ROW_ACCESS_POLICIES 视图时,查询结果会针对您指定的资源范围内的每个有效行访问权限政策返回一行。
INFORMATION_SCHEMA.ROW_ACCESS_POLICIES 视图具有如下架构:
| 列名 | 数据类型 | 值 |
|---|---|---|
table_catalog |
STRING |
包含行级访问权限政策的项目的 ID。 |
table_schema |
STRING |
包含行级访问权限政策的数据集的名称。 |
table_name |
STRING |
包含行访问权限政策的表的名称。 |
row_access_policy_name |
STRING |
行访问权限政策的名称。 |
filter_predicate |
STRING |
SQL 布尔表达式,用于定义此行访问权限政策可访问哪些行。 |
creation_time |
TIMESTAMP |
行访问权限政策的创建时间。 |
last_modified_time |
TIMESTAMP |
上次修改行访问权限政策的时间。 |
为了确保稳定性,我们建议您在信息架构查询中明确列出列,而不是使用通配符 (SELECT *)。明确列出列可防止底层架构发生更改时查询中断。
范围和语法
针对此视图的查询必须包含数据集或区域限定符。对于包含数据集限定符的查询,您必须拥有数据集的权限。对于包含区域限定符的查询,您必须拥有项目的权限。如需详细了解视图语法,请参阅语法。下表说明了此视图的区域和资源范围:
| 视图名称 | 资源范围 | 区域范围 |
|---|---|---|
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.ROW_ACCESS_POLICIES |
项目级 | REGION |
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.ROW_ACCESS_POLICIES |
数据集级 | 数据集位置 |
-
可选:
PROJECT_ID:您的 Google Cloud 项目的 ID。如果未指定,则使用默认项目。 -
REGION:任何数据集区域名称。 例如`region-us`。 -
DATASET_ID:您的数据集的 ID。如需了解详情,请参阅数据集限定符。
限制
INFORMATION_SCHEMA.ROW_ACCESS_POLICIES 视图具有以下限制:
- 该视图不包含受让人信息或
ddl列,因为行访问权限政策受让人存储在 IAM 政策绑定中,而不是 BigQuery 目录元数据中。如需查看通过行访问权限政策获得访问权限的主体,请参阅列出表行级访问权限政策。 - 结果不包含隐藏数据集或 BigLake 数据集中的行访问权限政策。
示例
以下示例展示了如何查询 INFORMATION_SCHEMA.ROW_ACCESS_POLICIES 视图。
查询某个区域中的行访问权限政策
以下示例会检索默认项目的 us 区域中所有活跃行访问权限政策的元数据:
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;
结果类似于以下内容:
+---------------+--------------+------------+------------------------+--------------------+-----------------------------+-----------------------------+
| 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 |
+---------------+--------------+------------+------------------------+--------------------+-----------------------------+-----------------------------+
查询数据集中的行访问权限政策
以下示例会检索名为 my_dataset 的特定数据集中所有有效行访问权限政策的元数据:
SELECT
table_name,
row_access_policy_name,
filter_predicate,
creation_time,
last_modified_time
FROM
my_dataset.INFORMATION_SCHEMA.ROW_ACCESS_POLICIES;
结果类似于以下内容:
+------------+------------------------+--------------------+-----------------------------+-----------------------------+
| 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 |
+------------+------------------------+--------------------+-----------------------------+-----------------------------+
统计表中的行访问权限政策数量
以下示例统计了 my_project.my_dataset 中 my_table 表上的有效行访问权限政策数量:
SELECT
COUNT(1) AS total_policies
FROM
my_project.my_dataset.INFORMATION_SCHEMA.ROW_ACCESS_POLICIES
WHERE
table_name = 'my_table';
结果类似于以下内容:
+----------------+
| total_policies |
+----------------+
| 2 |
+----------------+