ROW_ACCESS_POLICIES 檢視表

在 INFORMATION_SCHEMA.ROW_ACCESS_POLICIES 檢視表中,您指定的資料集或區域內,每項有效的資料列存取政策都會有一列。您可以查詢這個檢視表,稽核資料列存取政策,並檢查 BigQuery 資料表中的篩選條件。如要進一步瞭解資料列層級安全性,請參閱「BigQuery 資料列層級安全性簡介」。

必要的角色

如要取得查詢 INFORMATION_SCHEMA.ROW_ACCESS_POLICIES 檢視表所需的權限,請要求管理員授予您資料集或專案的下列 IAM 角色:

如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

這些預先定義的角色具備查詢 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              |
+----------------+