ROW_ACCESS_POLICIES 檢視表
在 INFORMATION_SCHEMA.ROW_ACCESS_POLICIES 檢視表中,您指定的資料集或區域內,每項有效的資料列存取政策都會有一列。您可以查詢這個檢視表,稽核資料列存取政策,並檢查 BigQuery 資料表中的篩選條件。如要進一步瞭解資料列層級安全性,請參閱「BigQuery 資料列層級安全性簡介」。
必要的角色
如要取得查詢 INFORMATION_SCHEMA.ROW_ACCESS_POLICIES 檢視表所需的權限,請要求管理員授予您資料集或專案的下列 IAM 角色:
- BigQuery 資料擁有者 (
roles/bigquery.dataOwner) - BigQuery 管理員 (
roles/bigquery.admin) - BigQuery 安全管理員 (
roles/bigquery.securityAdmin)
如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
這些預先定義的角色具備查詢 INFORMATION_SCHEMA.ROW_ACCESS_POLICIES 檢視表所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:
所需權限
必須具備下列權限,才能查詢 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 |
+----------------+