ROW_ACCESS_POLICIES ビュー
INFORMATION_SCHEMA.ROW_ACCESS_POLICIES ビューには、指定したデータセットまたはリージョン内のアクティブな行レベルのアクセス ポリシーごとに 1 行が表示されます。このビューにクエリを実行して、行アクセス ポリシーを監査し、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 ビューにクエリを実行するために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。
必要な権限
INFORMATION_SCHEMA.ROW_ACCESS_POLICIES ビューにクエリを実行するには、次の権限が必要です。
-
bigquery.rowAccessPolicies.get -
bigquery.rowAccessPolicies.list
カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。
BigQuery での IAM のロールと権限について詳しくは、事前定義ロールと権限をご覧ください。
スキーマ
INFORMATION_SCHEMA.ROW_ACCESS_POLICIES ビューにクエリを実行すると、指定したリソース スコープ内のアクティブな行アクセス ポリシーごとに 1 行ずつ表示されるクエリ結果が返されます。
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 ビューには次の制限があります。
- 行アクセス ポリシーの譲受人は BigQuery カタログ メタデータではなく IAM ポリシー バインディングに保存されるため、ビューには譲受人情報や
ddl列は含まれません。行アクセス ポリシーによってアクセス権が付与されているプリンシパルを表示するには、テーブルの行レベルのアクセス ポリシーを一覧表示するをご覧ください。 - 結果には、非表示データセットまたは 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 |
+----------------+