Ansicht ROW_ACCESS_POLICIES
Die Ansicht INFORMATION_SCHEMA.ROW_ACCESS_POLICIES enthält eine Zeile für jede aktive Zeilenzugriffsrichtlinie im Dataset oder in der Region, die Sie angeben. Sie können diese Ansicht abfragen, um Zeilenzugriffsrichtlinien zu prüfen und Filterprädikate für Tabellen in BigQuery zu untersuchen. Weitere Informationen zur Sicherheit auf Zeilenebene finden Sie unter Einführung in die BigQuery-Sicherheit auf Zeilenebene.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Dataset oder Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Abfragen der Ansicht INFORMATION_SCHEMA.ROW_ACCESS_POLICIES benötigen:
- BigQuery-Dateninhaber (
roles/bigquery.dataOwner) - BigQuery-Administrator (
roles/bigquery.admin) - BigQuery Security Admin (
roles/bigquery.securityAdmin)
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Abfragen der Ansicht INFORMATION_SCHEMA.ROW_ACCESS_POLICIES erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Zum Abfragen der Ansicht INFORMATION_SCHEMA.ROW_ACCESS_POLICIES sind die folgenden Berechtigungen erforderlich:
-
bigquery.rowAccessPolicies.get -
bigquery.rowAccessPolicies.list
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Weitere Informationen zu IAM-Rollen und Berechtigungen in BigQuery finden Sie unter Vordefinierte Rollen und Berechtigungen.
Schema
Wenn Sie die Ansicht INFORMATION_SCHEMA.ROW_ACCESS_POLICIES abfragen, wird im Ergebnis jede aktive Zeilenzugriffsrichtlinie im von Ihnen angegebenen Ressourcenbereich in einer eigenen Zeile dargestellt.
Die Ansicht INFORMATION_SCHEMA.ROW_ACCESS_POLICIES hat das folgende Schema:
| Spaltenname | Datentyp | Wert |
|---|---|---|
table_catalog |
STRING |
Die ID des Projekts, das die Zeilenzugriffsrichtlinie enthält. |
table_schema |
STRING |
Der Name des Datasets, das die Zugriffsrichtlinie für Zeilen enthält. |
table_name |
STRING |
Der Name der Tabelle, die die Richtlinie für den Zeilenzugriff enthält. |
row_access_policy_name |
STRING |
Der Name der Zeilenzugriffsrichtlinie. |
filter_predicate |
STRING |
Der boolesche SQL-Ausdruck, der definiert, auf welche Zeilen diese Zeilenzugriffsrichtlinie zugreifen kann. |
creation_time |
TIMESTAMP |
Der Zeitpunkt, zu dem die Zugriffsrichtlinie für Zeilen erstellt wurde. |
last_modified_time |
TIMESTAMP |
Der Zeitpunkt, zu dem die Zeilenzugriffsrichtlinie zuletzt geändert wurde. |
Aus Gründen der Stabilität empfehlen wir, Spalten in Ihren Informationsschemaabfragen explizit aufzulisten, anstatt einen Platzhalter (SELECT *) zu verwenden. Durch das explizite Auflisten von Spalten wird verhindert, dass Abfragen fehlschlagen, wenn sich das zugrunde liegende Schema ändert.
Bereich und Syntax
Für Abfragen dieser Ansicht muss ein Dataset- oder Regions-Qualifier verwendet werden. Für Abfragen mit einem Dataset-Qualifier benötigen Sie Berechtigungen für das Dataset. Für Abfragen mit einem Regions-Qualifier müssen Sie Berechtigungen für das Projekt haben. Weitere Informationen zur Ansichtssyntax finden Sie unter Syntax. In der folgenden Tabelle werden die Regions- und Ressourcenbereiche für diese Ansicht erläutert:
| Ansichtsname | Ressourcenbereich | Regionsbereich |
|---|---|---|
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.ROW_ACCESS_POLICIES |
Projektebene | REGION |
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.ROW_ACCESS_POLICIES |
Dataset-Ebene | Dataset-Speicherort |
-
Optional:
PROJECT_ID: die ID Ihres Google Cloud -Projekts. Wenn keine Angabe erfolgt, wird das Standardprojekt verwendet. -
REGION: ist ein beliebiger Dataset-Regionsname. Beispiel:`region-us` -
DATASET_ID: die ID Ihres Datasets. Weitere Informationen finden Sie unter Dataset-Qualifier.
Beschränkungen
Für die Ansicht INFORMATION_SCHEMA.ROW_ACCESS_POLICIES gelten die folgenden Einschränkungen:
- Die Ansicht enthält keine Informationen zu Empfängern einer Förderung oder eine
ddl-Spalte, da Empfänger einer Förderung von Zeilenzugriffsrichtlinien in IAM-Richtlinienbindungen und nicht in BigQuery-Katalogmetadaten gespeichert werden. Informationen zum Aufrufen der Hauptkonten, denen durch eine Zeilenzugriffsrichtlinie Zugriff gewährt wurde, finden Sie unter Zugriffsrichtlinien auf Tabellenzeilenebene auflisten. - Die Ergebnisse enthalten keine Zeilenzugriffsrichtlinien in ausgeblendeten Datasets oder BigLake-Datasets.
Beispiele
Die folgenden Beispiele zeigen, wie die Methode INFORMATION_SCHEMA.ROW_ACCESS_POLICIES abgefragt wird.
Zeilenzugriffsrichtlinien in einer Region abfragen
Im folgenden Beispiel werden Metadaten für alle aktiven Zeilenzugriffsrichtlinien in der Region us für Ihr Standardprojekt abgerufen:
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;
Das Ergebnis sieht etwa so aus:
+---------------+--------------+------------+------------------------+--------------------+-----------------------------+-----------------------------+
| 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 |
+---------------+--------------+------------+------------------------+--------------------+-----------------------------+-----------------------------+
Zeilenzugriffsrichtlinien in einem Dataset abfragen
Im folgenden Beispiel werden Metadaten für alle aktiven Zugriffsrichtlinien für Zeilen in einem bestimmten Dataset namens my_dataset abgerufen:
SELECT
table_name,
row_access_policy_name,
filter_predicate,
creation_time,
last_modified_time
FROM
my_dataset.INFORMATION_SCHEMA.ROW_ACCESS_POLICIES;
Das Ergebnis sieht etwa so aus:
+------------+------------------------+--------------------+-----------------------------+-----------------------------+
| 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 |
+------------+------------------------+--------------------+-----------------------------+-----------------------------+
Zeilenzugriffsrichtlinien für eine Tabelle zählen
Im folgenden Beispiel wird die Anzahl der aktiven Zeilenzugriffsrichtlinien für die Tabelle my_table in my_project.my_dataset gezählt:
SELECT
COUNT(1) AS total_policies
FROM
my_project.my_dataset.INFORMATION_SCHEMA.ROW_ACCESS_POLICIES
WHERE
table_name = 'my_table';
Das Ergebnis sieht etwa so aus:
+----------------+
| total_policies |
+----------------+
| 2 |
+----------------+