Wenn Sie einschränken möchten, welche Zeilen Hauptkonten sehen können, und sensible Spaltenwerte maskieren oder blockieren möchten, ohne die zugrunde liegenden Cloud Storage-Dateien zu duplizieren, konfigurieren Sie die detaillierte Zugriffssteuerung (Fine-Grained Access Control, FGAC) von BigQuery für Apache Iceberg-Tabellen, die vom Lakehouse-Laufzeitkatalog verwaltet werden. Die detaillierte Zugriffssteuerung umfasst die Sicherheit auf Zeilenebene und die Sicherheit auf Spaltenebene mit dynamischer Datenmaskierung. In diesem Dokument erfahren Sie, wie Sie Zugriffsrichtlinien auf Zeilenebene erstellen und Datenrichtlinien direkt auf Spalten anwenden.
Sie hängen Zugriffsrichtlinien auf Zeilenebene und Datenspaltenrichtlinien an Apache Iceberg-Tabellen an und verwalten sie, indem Sie GoogleSQL-Datendefinitionssprache(DDL)-Anweisungen in BigQuery ausführen, die die vierteilige Tabellen-ID P.C.N.T (Project.Catalog.Namespace.Table) verwenden. Wenn Ihr Katalog den Modus für die Bereitstellung von Anmeldedaten verwendet, erzwingt der Apache Iceberg REST-Katalogendpunkt eine Schutzmaßnahme für die Bereitstellung von Anmeldedaten für FGAC-geschützte Tabellen. Der Endpunkt gibt für direkte Cloud Storage-Anmeldedatenanfragen den HTTP-Statuscode 403 Forbidden zurück, es sei denn, das aufrufende Hauptkonto hat unmaskierten Zugriff (RAW_DATA_ACCESS_POLICY) auf jede geschützte Spalte und, wenn die Tabelle Zugriffsrichtlinien auf Zeilenebene hat, ungefilterten Zeilenzugriff (FILTER USING (TRUE)).
Beschränkungen
Die detaillierte Zugriffssteuerung für Apache Iceberg-Tabellen, die vom Lakehouse-Laufzeitkatalog verwaltet werden, unterliegt zusätzlich zu den standardmäßigen Einschränkungen für Spaltendatenrichtlinien und Einschränkungen für die Sicherheit auf Zeilenebene den folgenden Einschränkungen:
- Nur SQL-DDL: Sie können Spaltendatenrichtlinien nur über BigQuery-GoogleSQL-DDL-Anweisungen (
CREATE TABLE,ALTER TABLE ... ADD COLUMN,ALTER TABLE ... ALTER COLUMN ... SET OPTIONS,CREATE ROW ACCESS POLICYundDROP ROW ACCESS POLICY) anhängen, aktualisieren oder trennen und Zugriffsrichtlinien auf Zeilenebene erstellen oder löschen. Die Verwaltung dieser Tabellenbindungen über die Google Cloud Console, die BigQuery API (tables.patch), das bq-Befehlszeilentool oder Terraform wird nicht unterstützt. - Vierteilige P.C.N.T-Tabellen-ID erforderlich: Wenn Sie in DDL-Anweisungen oder Abfragen auf eine Apache Iceberg-Tabelle verweisen, die vom Lakehouse-Laufzeitkatalog verwaltet wird, müssen Sie das vierteilige P.C.N.T-Format (
PROJECT_ID.CATALOG_ID.NAMESPACE.TABLE_NAME) verwenden. - Richtlinien-Tags und Data-Governance-Tags werden nicht unterstützt: Data Catalog-Richtlinien-Tags (und Taxonomien) sowie Resource Manager-Data-Governance-Tags werden für Apache Iceberg-Tabellen im Lakehouse-Laufzeitkatalog nicht unterstützt. Wenn Sie die Sicherheit auf Spaltenebene und die Datenmaskierung erzwingen möchten, müssen Sie Datenrichtlinien direkt auf Spalten anwenden.
- Unterabfragen in Zugriffsrichtlinien auf Zeilenebene werden nicht unterstützt: Zugriffsrichtlinien auf Zeilenebene für Apache Iceberg-Tabellen im Lakehouse-Laufzeitkatalog unterstützen keine Unterabfragen im Filterausdruck
FILTER USING. - Schutzmaßnahme für die Bereitstellung von Anmeldedaten für Open-Source-Engines: Bei Katalogen, die mit dem Modus für die Bereitstellung von Anmeldedaten konfiguriert sind, gibt der Apache Iceberg REST-Katalogendpunkt den HTTP-Statuscode
403 Forbiddenzurück, wenn ein Client, z. B. eine Open-Source-Engine, temporäre Cloud Storage-Anmeldedaten für eine FGAC-geschützte Tabelle anfordert. Um bereitgestellte Anmeldedaten zu erhalten, muss das aufrufende Hauptkonto unmaskierten (RAW_DATA_ACCESS_POLICY) Zugriff auf jede geschützte Spalte und, wenn die Tabelle Zugriffsrichtlinien auf Zeilenebene hat, ungefilterten Zeilenzugriff (FILTER USING (TRUE)) haben. Konfigurationsschritte finden Sie unter Anmeldedaten für Open-Source-Engines für FGAC-geschützte Tabellen konfigurieren. - Modus für Endnutzer-Anmeldedaten: In Katalogen, die nicht den Modus für die Bereitstellung von Anmeldedaten verwenden, erzwingt BigQuery Zugriffsrichtlinien auf Zeilen- und Spaltenebene nur für Abfragen, die in BigQuery ausgeführt werden, nicht, wenn Hauptkonten die zugrunde liegenden Cloud Storage-Dateien direkt lesen. Wenn Sie verhindern möchten, dass Hauptkonten die detaillierte Zugriffssteuerung umgehen, indem sie Speicherdateien direkt lesen, verwenden Sie den Modus für die Bereitstellung von Anmeldedaten.
- Föderierte Kataloge werden nicht unterstützt: Die detaillierte Zugriffssteuerung (Sicherheit auf Zeilenebene und Datenspaltenrichtlinien) wird für föderierte Kataloge oder externe Tabellen, auf die über cloudübergreifende Verbindungen zugegriffen wird, nicht unterstützt.
Hinweis
-
Prüfen Sie, ob die Abrechnung für Ihr Google Cloud -Projekt aktiviert ist.
-
Aktivieren Sie die BigLake API und die BigQuery Data Policy API, falls sie noch nicht aktiviert sind.
Rollen, die zum Aktivieren von APIs erforderlich sind
Zum Aktivieren von APIs benötigen Sie die Berechtigung
serviceusage.services.enable. Wenn Sie das Projekt erstellt haben, haben Sie diese Berechtigung wahrscheinlich bereits über die Inhaberrolle (roles/owner). Andernfalls können Sie diese Berechtigung über die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) erhalten. Informationen zum Zuweisen von Rollen - Richten Sie den Lakehouse-Laufzeitkatalog mit dem Apache Iceberg REST-Katalogendpunkt im Modus für die Bereitstellung von Anmeldedaten ein.
- Apache Iceberg-Tabelle erstellen
Erforderliche Rollen
Zum Verwalten und Abfragen von detaillierten Zugriffssteuerungsrichtlinien für Apache Iceberg-Tabellen sind IAM-Berechtigungen (Identity and Access Management) sowohl für die Lakehouse-Tabelle (biglake.*) als auch für die BigQuery-Datenrichtlinie oder den Abfragejob (bigquery.*) erforderlich.
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Konfigurieren und Abfragen der Sicherheit auf Zeilen- und Spaltenebene für Apache Iceberg-Tabellen benötigen:
-
Datenrichtlinie erstellen, aktualisieren, löschen oder Zugriff darauf gewähren:
- BigQuery-Datenrichtlinienadministrator (
roles/bigquerydatapolicy.admin) für das Projekt - BigQuery Admin (
roles/bigquery.admin) für das Projekt - BigQuery Data Owner (
roles/bigquery.dataOwner) für das Projekt
- BigQuery-Datenrichtlinienadministrator (
-
Spaltendatenrichtlinie an eine Apache Iceberg-Tabelle anhängen oder davon trennen:
- BigLake-Administrator (
roles/biglake.admin) für die Tabelle, den Namespace, den Katalog oder das Projekt - BigQuery Data Policy Admin (
roles/bigquerydatapolicy.admin) für das Projekt, das die Datenrichtlinie enthält
- BigLake-Administrator (
-
Zugriffsrichtlinie auf Zeilenebene für eine Apache Iceberg-Tabelle erstellen, aktualisieren, auflisten oder löschen:
- BigLake-Administrator (
roles/biglake.admin) für die Tabelle, den Namespace, den Katalog oder das Projekt - BigQuery-Jobnutzer (
roles/bigquery.jobUser) für das Abfrageprojekt
- BigLake-Administrator (
-
Fragen Sie eine durch detaillierte Zugriffssteuerung geschützte Apache Iceberg-Tabelle ab:
- BigLake-Betrachter (
roles/biglake.viewer) für die Tabelle, den Namespace, den Katalog oder das Projekt - BigQuery-Jobnutzer (
roles/bigquery.jobUser) für das Abfrageprojekt
- BigLake-Betrachter (
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Konfigurieren und Abfragen der Sicherheit auf Zeilen- und Spaltenebene für Apache Iceberg-Tabellen erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind erforderlich, um die Sicherheit auf Zeilen- und Spaltenebene für Apache Iceberg-Tabellen zu konfigurieren und abzufragen:
-
Datenrichtlinien erstellen, aktualisieren, löschen oder Zugriff darauf gewähren:
bigquery.dataPolicies.createfür das Projekt-
bigquery.dataPolicies.updatefür die Datenrichtlinie -
bigquery.dataPolicies.deletefür die Datenrichtlinie -
bigquery.dataPolicies.getfür die Datenrichtlinie -
bigquery.dataPolicies.setIamPolicyfür die Datenrichtlinie -
bigquery.jobs.createfür das Abfrageprojekt
-
Datenrichtlinie an eine Apache Iceberg-Tabellenspalte anhängen:
-
biglake.tables.setColumnDataPolicyfür die Tabelle (oder den Namespace fürCREATE TABLE) -
biglake.tables.updatefür die Tabelle (oderbiglake.tables.createfürCREATE TABLE) -
bigquery.dataPolicies.getfür die Datenrichtlinie -
bigquery.dataPolicies.attachfür die Datenrichtlinie -
bigquery.jobs.createfür das Abfrageprojekt
-
-
Datenrichtlinie von einer Apache Iceberg-Tabellenspalte trennen:
-
biglake.tables.setColumnDataPolicyfür die Tabelle -
biglake.tables.updatefür die Tabelle -
bigquery.jobs.createfür das Abfrageprojekt
-
-
Zugriffsrichtlinie auf Zeilenebene erstellen oder aktualisieren:
-
biglake.rowAccessPolicies.createfür die Tabelle -
biglake.rowAccessPolicies.updatefür die Tabelle -
biglake.rowAccessPolicies.setIamPolicyfür die Tabelle -
biglake.tables.getDatafür die Zieltabelle -
bigquery.jobs.createfür das Abfrageprojekt
-
-
Zugriffsrichtlinien auf Zeilenebene auflisten oder ansehen:
-
biglake.rowAccessPolicies.listfür die Tabelle -
biglake.rowAccessPolicies.getfür die Tabelle -
biglake.rowAccessPolicies.getIamPolicyfür die Tabelle
-
-
Löschen Sie eine oder alle Zugriffsrichtlinien auf Zeilenebene:
-
biglake.rowAccessPolicies.deletefür die Tabelle -
biglake.rowAccessPolicies.setIamPolicyfür die Tabelle -
biglake.rowAccessPolicies.listfür die Tabelle (beim Löschen aller Richtlinien) -
bigquery.jobs.createfür das Abfrageprojekt
-
-
Fragen Sie eine durch detaillierte Zugriffssteuerung geschützte Apache Iceberg-Tabelle ab:
-
biglake.tables.getfür die Tabelle -
biglake.tables.getDatafür die Tabelle -
bigquery.jobs.createfür das Abfrageprojekt
-
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Zusätzlich zu den IAM-Berechtigungen auf Tabellenebene müssen die detaillierten Richtlinien für die Tabelle auch die Abfrage von Hauptkonten autorisieren:
- Sicherheit auf Spaltenebene: Dem Hauptkonto muss
FINE_GRAINED_READin dergrantees-Liste einesRAW_DATA_ACCESS_POLICY(für unmaskierte Werte) oder einesDATA_MASKING_POLICY(für maskierte Werte) gewährt werden, das an die abgefragte Spalte angehängt ist. - Sicherheit auf Zeilenebene: Das Hauptkonto muss in der
grantee_listeiner Zugriffsrichtlinie auf Zeilenebene für die Tabelle enthalten sein. Dadurch wird dem Hauptkonto automatisch die vom System verwaltete Rolleroles/biglake.filteredDataViewerzugewiesen. Diese Rolle enthält die Berechtigungbiglake.rowAccessPolicies.getFilteredData.
Zusätzlich zu den IAM-Berechtigungen auf Tabellenebene müssen die detaillierten Richtlinien für die Tabelle auch Zugriff auf die abfragenden Hauptkonten gewähren:
- Sicherheit auf Spaltenebene: Dem Hauptkonto muss
FINE_GRAINED_READin dergrantees-Liste einesRAW_DATA_ACCESS_POLICY(für unmaskierte Werte) oder einesDATA_MASKING_POLICY(für maskierte Werte) gewährt werden, das an die abgefragte Spalte angehängt ist. - Sicherheit auf Zeilenebene: Das Hauptkonto muss in der
grantee_listeiner Zugriffsrichtlinie auf Zeilenebene für die Tabelle enthalten sein. Dadurch wird dem Hauptkonto automatisch die vom System verwaltete Rolleroles/biglake.filteredDataViewerzugewiesen. Diese Rolle enthält die Berechtigungbiglake.rowAccessPolicies.getFilteredData.
Sicherheit auf Spaltenebene und Datenmaskierung konfigurieren
Sie konfigurieren die Zugriffssteuerung auf Spaltenebene und die dynamische Datenmaskierung für Apache Iceberg-Tabellen im Lakehouse-Laufzeitkatalog, indem Sie BigQuery-Datenrichtlinien erstellen und sie mithilfe von GoogleSQL-DDL direkt an Tabellenspalten anhängen. Weitere Informationen zu allgemeinen Konzepten und Definitionen von Maskierungsregeln finden Sie unter Einführung in die Datenmaskierung und Daten durch Anwenden von Datenrichtlinien auf eine Spalte maskieren.
Datenrichtlinien erstellen
Eine Datenrichtlinie definiert entweder eine Datenmaskierungsregel (DATA_MASKING_POLICY) oder den Zugriff auf unmaskierte Rohdaten (RAW_DATA_ACCESS_POLICY). Sie können Datenrichtlinien mit GoogleSQL-DDL oder der BigQuery Data Policy API v2 erstellen.
Führen Sie je nach Anwendungsfall eine der folgenden Anweisungen aus:
Führen Sie die Anweisung
CREATE DATA_POLICYaus, um eine Datenrichtlinie mit einem vordefinierten Maskierungsausdruck (z. B.SHA256oderALWAYS_NULL) zu erstellen:CREATE DATA_POLICY IF NOT EXISTS `PROJECT_ID.region-LOCATION.MASKING_POLICY_NAME` OPTIONS ( data_policy_type = "DATA_MASKING_POLICY", masking_expression = "SHA256" );Wenn Sie eine Zugriffsrichtlinie für Rohdaten erstellen möchten, die Hauptkonten zum Lesen unmaskierter Spaltenwerte autorisiert, setzen Sie
data_policy_typeaufRAW_DATA_ACCESS_POLICY:CREATE DATA_POLICY IF NOT EXISTS `PROJECT_ID.region-LOCATION.RAW_POLICY_NAME` OPTIONS ( data_policy_type = "RAW_DATA_ACCESS_POLICY" );
Ersetzen Sie Folgendes:
PROJECT_ID: Ihre Google Cloud-Projekt-ID.LOCATION: Die Region oder der multiregionale Standort der Datenrichtlinie (z. B.usoderus-central1).MASKING_POLICY_NAME: Ein eindeutiger Name für die Datenmaskierungsrichtlinie.RAW_POLICY_NAME: Ein eindeutiger Name für die Zugriffsrichtlinie für Rohdaten.
Präzisen Lesezugriff gewähren oder widerrufen
Wenn Sie Datenrichtlinien direkt auf Spalten anwenden, steuert die Liste grantees in der Datenrichtlinie den Lesezugriff zum Zeitpunkt der Abfrage. In GoogleSQL gewähren oder widerrufen Sie die Berechtigung FINE_GRAINED_READ für die Datenrichtlinie:
- Wenn Sie
FINE_GRAINED_READfür eineDATA_MASKING_POLICYgewähren, erhält das Hauptkonto maskierten Lesezugriff auf Spalten, die durch diese Richtlinie geschützt sind. - Wenn Sie
FINE_GRAINED_READfür einRAW_DATA_ACCESS_POLICYgewähren, erhält das Hauptkonto unmaskierten (unformatierten) Lesezugriff auf Spalten, die durch diese Richtlinie geschützt sind.
- Nutzer:
principal://goog/subject/USER_EMAIL - Dienstkonto:
principal://iam.googleapis.com/projects/-/serviceAccounts/SA_EMAIL - Google-Gruppe:
principalSet://goog/group/GROUP_EMAIL
Führen Sie eine der folgenden Anweisungen aus, um den detaillierten Lesezugriff für eine Datenrichtlinie zu verwalten:
Führen Sie die Anweisung GRANT
FINE_GRAINED_READ aus, um Hauptkonten detaillierten Lesezugriff auf eine Datenrichtlinie zu gewähren:
GRANT FINE_GRAINED_READ ON DATA_POLICY `PROJECT_ID.region-LOCATION.DATA_POLICY_NAME`
TO "principal://goog/subject/USER_EMAIL",
"principalSet://goog/group/GROUP_EMAIL";
Führen Sie die Anweisung REVOKE
FINE_GRAINED_READ aus, um einem Hauptkonto den detaillierten Lesezugriff zu entziehen:
REVOKE FINE_GRAINED_READ ON DATA_POLICY `PROJECT_ID.region-LOCATION.DATA_POLICY_NAME`
FROM "principal://goog/subject/USER_EMAIL";
Ersetzen Sie Folgendes:
PROJECT_ID: Projekt-ID in Google Cloud .LOCATION: die Region oder der multiregionale Standort der Datenrichtlinie.DATA_POLICY_NAME: der Name der Richtlinie für die Datenmaskierung oder den Zugriff auf Rohdaten.USER_EMAIL: die E-Mail-Adresse des Nutzerkontos.GROUP_EMAIL: die E-Mail-Adresse der Google-Gruppe.
Datenrichtlinien mit P.C.N.T-DDL an Spalten anhängen
Hängen Sie Datenrichtlinien an Spalten in Ihrer Apache Iceberg-Tabelle im Lakehouse-Laufzeitkatalog an. Verwenden Sie dazu das vierteilige P.C.N.T (PROJECT_ID.CATALOG_ID.NAMESPACE.TABLE_NAME).
Kennzeichnung umfasst. Führen Sie je nach Anwendungsfall eine der folgenden Anweisungen aus:
Wenn Sie Datenrichtlinien an eine vorhandene Spalte anhängen möchten, indem Sie (
+=) an die Optiondata_policiesder Spalte anhängen, führen Sie die AnweisungALTER TABLE ... ALTER COLUMN SET OPTIONSaus:ALTER TABLE `PROJECT_ID.CATALOG_ID.NAMESPACE.TABLE_NAME` ALTER COLUMN COLUMN_NAME SET OPTIONS ( data_policies += ["{'name':'PROJECT_ID.region-LOCATION.MASKING_POLICY_NAME'}", "{'name':'PROJECT_ID.region-LOCATION.RAW_POLICY_NAME'}"] );Führen Sie die Anweisung
ALTER TABLE ... ADD COLUMNaus, um eine neue Spalte mit einer angehängten Datenrichtlinie hinzuzufügen:ALTER TABLE `PROJECT_ID.CATALOG_ID.NAMESPACE.TABLE_NAME` ADD COLUMN COLUMN_NAME STRING OPTIONS ( data_policies = ["{'name':'PROJECT_ID.region-LOCATION.MASKING_POLICY_NAME'}"] );Führen Sie die Anweisung
CREATE TABLEaus, um eine neue Apache Iceberg-Tabelle mit angehängten Spaltendatenrichtlinien zu erstellen:CREATE TABLE `PROJECT_ID.CATALOG_ID.NAMESPACE.TABLE_NAME` ( id INT64, COLUMN_NAME STRING OPTIONS ( data_policies = ["{'name':'PROJECT_ID.region-LOCATION.MASKING_POLICY_NAME'}", "{'name':'PROJECT_ID.region-LOCATION.RAW_POLICY_NAME'}"] ) );
Ersetzen Sie Folgendes:
PROJECT_ID.CATALOG_ID.NAMESPACE.TABLE_NAME: die vierteilige P.C.N.T-Kennung der Apache Iceberg-Tabelle.COLUMN_NAME: der Name der zu schützenden Spalte.LOCATION: die Region oder der multiregionale Standort der Datenrichtlinie.MASKING_POLICY_NAMEundRAW_POLICY_NAME: die Namen der anzuhängenden Datenrichtlinien.
Spaltendatenrichtlinien trennen oder ersetzen
Wenn Sie Datenrichtlinien für eine Spalte in einer Apache Iceberg-Tabelle entfernen oder ersetzen möchten, verwenden Sie eine der folgenden Anweisungen mit der vierteiligen Tabellenkennung P.C.N.T:
Wenn Sie alle Datenrichtlinien aus einer Spalte entfernen möchten, setzen Sie
data_policiesauf ein leeres Array ([]):ALTER TABLE `PROJECT_ID.CATALOG_ID.NAMESPACE.TABLE_NAME` ALTER COLUMN COLUMN_NAME SET OPTIONS ( data_policies = [] );Wenn Sie vorhandene Datenrichtlinien für eine Spalte durch eine neue Liste ersetzen möchten, verwenden Sie den Operator
=anstelle des Operators+=:ALTER TABLE `PROJECT_ID.CATALOG_ID.NAMESPACE.TABLE_NAME` ALTER COLUMN COLUMN_NAME SET OPTIONS ( data_policies = ["{'name':'PROJECT_ID.region-LOCATION.NEW_POLICY_NAME'}"] );Wenn Sie eine Datenrichtlinie löschen möchten, nachdem Sie sie von allen Tabellenspalten getrennt haben, die auf sie verweisen, führen Sie die Anweisung
DROP DATA_POLICYaus:DROP DATA_POLICY IF EXISTS `PROJECT_ID.region-LOCATION.MASKING_POLICY_NAME`;
Ersetzen Sie Folgendes:
PROJECT_ID.CATALOG_ID.NAMESPACE.TABLE_NAME: die vierteilige P.C.N.T-Kennung der Apache Iceberg-TabelleCOLUMN_NAME: der Name der SpalteLOCATION: die Region oder der multiregionale Standort der DatenrichtlinieNEW_POLICY_NAMEundMASKING_POLICY_NAME: die Namen der Datenrichtlinien, die angehängt oder gelöscht werden sollen.
Sicherheit auf Zeilenebene konfigurieren
Sie können den Zugriff auf bestimmte Zeilen in einer Apache Iceberg-Tabelle, die vom Lakehouse-Laufzeitkatalog verwaltet wird, einschränken. Erstellen Sie dazu Zugriffsrichtlinien auf Zeilenebene mit GoogleSQL-DDL-Anweisungen, die die vierteilige P.C.N.T-Tabellenkennung verwenden. Weitere Informationen zu allgemeinen Konzepten der Sicherheit auf Zeilenebene und zur Filtersemantik finden Sie unter Sicherheit auf Zeilenebene verwenden.
Zugriffsrichtlinie auf Zeilenebene erstellen oder aktualisieren
Wenn Sie die Sicherheit auf Zeilenebene für eine Tabelle konfigurieren, erstellen Sie eine Richtlinie mit einer FILTER
USING (TRUE)-Klausel für Administratoren und Dienstkonten mit Schreibzugriff, die vollständigen Zugriff auf Zeilen benötigen. Erstellen Sie dann gefilterte Richtlinien für bestimmte Nutzergruppen.
Gewähren Sie Tabellenadministratoren oder Dienstkonten mit Schreibzugriff vollständigen Zeilenzugriff (
FILTER USING (TRUE)):CREATE OR REPLACE ROW ACCESS POLICY ADMIN_POLICY_NAME ON `PROJECT_ID.CATALOG_ID.NAMESPACE.TABLE_NAME` GRANT TO ("group:ADMIN_GROUP_EMAIL") FILTER USING (TRUE);Erstellen Sie eine Zugriffsrichtlinie auf Zeilenebene, die Zeilen anhand eines Prädikatausdrucks filtert:
CREATE OR REPLACE ROW ACCESS POLICY FILTER_POLICY_NAME ON `PROJECT_ID.CATALOG_ID.NAMESPACE.TABLE_NAME` GRANT TO ("user:USER_EMAIL", "group:ANALYST_GROUP_EMAIL") FILTER USING (FILTER_EXPRESSION);Ersetzen Sie Folgendes:
ADMIN_POLICY_NAMEundFILTER_POLICY_NAME: Eindeutige Namen für die Zugriffsrichtlinien auf Zeilenebene für die Tabelle.PROJECT_ID.CATALOG_ID.NAMESPACE.TABLE_NAME: Die vierteilige P.C.N.T-Kennung der Apache Iceberg-Tabelle.ADMIN_GROUP_EMAIL,USER_EMAILundANALYST_GROUP_EMAIL: Die E-Mail-Adressen der Google-Gruppen oder Nutzer, denen Zeilenzugriff gewährt wurde.FILTER_EXPRESSION: Ein boolescher Filterausdruck, der wie eineWHERE-Klausel ausgewertet wird (z. B.region = 'APAC').
Zugriffsrichtlinien auf Zeilenebene löschen
Führen Sie eine der folgenden Anweisungen aus, um Zugriffsrichtlinien auf Zeilenebene aus einer Apache Iceberg-Tabelle zu entfernen:
Wenn Sie eine bestimmte Zugriffsrichtlinie auf Zeilenebene löschen möchten, während andere Zugriffsrichtlinien auf Zeilenebene in der Tabelle verbleiben, führen Sie die Anweisung
DROP ROW ACCESS POLICYaus:DROP ROW ACCESS POLICY IF EXISTS FILTER_POLICY_NAME ON `PROJECT_ID.CATALOG_ID.NAMESPACE.TABLE_NAME`;Führen Sie die
DROP ALL ROW ACCESS POLICIES-Anweisung aus, um die letzte verbleibende Zugriffsrichtlinie auf Zeilenebene oder alle Zugriffsrichtlinien auf Zeilenebene für die Tabelle zu löschen:DROP ALL ROW ACCESS POLICIES ON `PROJECT_ID.CATALOG_ID.NAMESPACE.TABLE_NAME`;
Ersetzen Sie Folgendes:
FILTER_POLICY_NAME: Der Name der Zugriffsrichtlinie auf Zeilenebene, die gelöscht werden soll.PROJECT_ID.CATALOG_ID.NAMESPACE.TABLE_NAME: die vierteilige P.C.N.T-Kennung der Apache Iceberg-Tabelle
Durch detaillierte Zugriffssteuerung geschützte Tabelle in BigQuery abfragen
Wenn ein Hauptkonto eine mit detaillierter Zugriffssteuerung geschützte Apache Iceberg-Tabelle in BigQuery mithilfe der vierteiligen P.C.N.T-ID abfragt, wertet BigQuery zum Zeitpunkt der Abfrage sowohl Richtlinien auf Zeilen- als auch auf Spaltenebene aus:
- Auswertung auf Zeilenebene: Hauptkonten im
grantee_listeiner oder mehrerer Zugriffsrichtlinien auf Zeilenebene sehen die Vereinigung von Zeilen, die denfilter_expression-Prädikaten dieser Richtlinien entsprechen. Hauptkonten, die in keiner Zugriffsrichtlinie auf Zeilenebene für die Tabelle enthalten sind, sehen keine Zeilen. - Bewertung auf Spaltenebene:
- Hauptkonten, denen
FINE_GRAINED_READfür einRAW_DATA_ACCESS_POLICYgewährt wurde, das an eine Spalte angehängt ist, sehen unmaskierte (Roh-)Daten. - Hauptkonten, denen
FINE_GRAINED_READfür eineDATA_MASKING_POLICY(und nicht für eineRAW_DATA_ACCESS_POLICYfür diese Spalte) gewährt wurde, sehen maskierte Daten. Wenn mehrere Maskierungsrichtlinien für dasselbe Hauptkonto in einer Spalte gelten, wählt BigQuery die Regel gemäß der Hierarchie der Datenmaskierungsregeln aus. - Hauptkonten, denen für keine an eine geschützte Spalte angehängte Datenrichtlinie
FINE_GRAINED_READgewährt wurde, erhalten beim Abfragen dieser Spalte den FehlerAccess Denied. Diese Hauptkonten können ungeschützte Spalten weiterhin explizit abfragen oderSELECT * EXCEPT(PROTECTED_COLUMN)verwenden.
- Hauptkonten, denen
Die folgende Abfrage gibt beispielsweise Zeilen- und Spaltenwerte gemäß den Richtlinien des Aufrufers zurück:
SELECT id, COLUMN_NAME
FROM `PROJECT_ID.CATALOG_ID.NAMESPACE.TABLE_NAME`;
Ersetzen Sie Folgendes:
COLUMN_NAME: der Name der abzufragenden Spalte.PROJECT_ID.CATALOG_ID.NAMESPACE.TABLE_NAME: die vierteilige P.C.N.T-Kennung der Apache Iceberg-Tabelle.
Anmeldedaten für Open-Source-Engines für FGAC-geschützte Tabellen konfigurieren
Wenn eine Open-Source-Abfrage-Engine (z. B. Apache Spark, Trino oder Apache Flink) aus einer Apache Iceberg-Tabelle in einem Katalog liest oder in diese schreibt, der mit dem Modus für die Bereitstellung von Anmeldedaten konfiguriert ist, ruft die Engine den Apache Iceberg REST-Katalogendpunkt auf, um kurzlebige Cloud Storage-Anmeldedaten mit eingeschränktem Umfang zu erhalten.
Da beim direkten Zugriff auf Cloud Storage-Dateien die Richtlinienprüfung zur Abfragezeit in BigQuery umgangen wird, erzwingt der Apache Iceberg REST-Katalogendpunkt eine Schutzmaßnahme für die Bereitstellung von Anmeldedaten. Die Guardrail gibt den HTTP-Statuscode 403 Forbidden zurück, wenn ein Hauptkonto Speicheranmeldedaten für eine durch detaillierte Zugriffssteuerung geschützte Tabelle anfordert, es sei denn, das Hauptkonto hat vollen Zugriff auf die Tabelle:
- Zugriff auf unmaskierte (Roh-)Daten für alle geschützten Spalten: Jede geschützte Spalte in der Tabelle muss auch eine
RAW_DATA_ACCESS_POLICYhaben. Gewähren Sie dem aufrufenden Hauptkonto die BerechtigungFINE_GRAINED_READfür dieseRAW_DATA_ACCESS_POLICY. - Ungefilterter Zeilenzugriff (alle Zeilen): Wenn der Tabelle Zugriffsrichtlinien auf Zeilenebene zugeordnet sind, gewähren Sie dem aufrufenden Hauptkonto eine Zugriffsrichtlinie auf Zeilenebene mit einer
FILTER USING (TRUE)-Klausel.
Vollständigen Zugriff auf ein Dienstkonto für Open-Source-Engine-Writer gewähren
Ein Dienstkonto, das Open-Source-Engine-Jobs ausführt, z. B. Jobs in Managed Service for Apache Spark oder Dataflow, benötigt vollständigen Tabellenzugriff, um bereitgestellte Anmeldedaten für eine FGAC-geschützte Apache Iceberg-Tabelle zu erhalten. Führen Sie die folgenden Schritte in BigQuery aus, um diesen Zugriff zu gewähren:
Zugriff auf Rohdaten (
RAW_DATA_ACCESS_POLICY) für alle geschützten Spalten gewähren: Hängen Sie einRAW_DATA_ACCESS_POLICYan jede geschützte Spalte in der Tabelle an und gewähren Sie dem Dienstkonto dann die BerechtigungFINE_GRAINED_READ, indem Sie die IAM v2-Hauptkontokennungprincipal://IAM.googleapis.com/projects/-/serviceAccounts/SA_EMAILverwenden:-- 1. Create a raw data access policy (if not already created) CREATE DATA_POLICY IF NOT EXISTS `PROJECT_ID.region-LOCATION.RAW_POLICY_NAME` OPTIONS ( data_policy_type = "RAW_DATA_ACCESS_POLICY" ); -- 2. Grant FINE_GRAINED_READ on the raw data access policy to the writer service account GRANT FINE_GRAINED_READ ON DATA_POLICY `PROJECT_ID.region-LOCATION.RAW_POLICY_NAME` TO "principal://iam.googleapis.com/projects/-/serviceAccounts/WRITER_SA_EMAIL"; -- 3. Attach the raw data access policy to each protected column on the table ALTER TABLE `PROJECT_ID.CATALOG_ID.NAMESPACE.TABLE_NAME` ALTER COLUMN COLUMN_NAME SET OPTIONS ( data_policies += ["{'name':'PROJECT_ID.region-LOCATION.RAW_POLICY_NAME'}"] );Zugriffsrichtlinie für alle Zeilen gewähren, wenn die Sicherheit auf Zeilenebene aktiviert ist: Wenn die Tabelle Zugriffsrichtlinien auf Zeilenebene hat, weisen Sie dem Dienstkonto eine Zugriffsrichtlinie auf Zeilenebene mit einer
FILTER USING (TRUE)-Klausel zu:CREATE OR REPLACE ROW ACCESS POLICY WRITER_ROW_POLICY_NAME ON `PROJECT_ID.CATALOG_ID.NAMESPACE.TABLE_NAME` GRANT TO ("serviceAccount:WRITER_SA_EMAIL") FILTER USING (TRUE);
Ersetzen Sie Folgendes:
PROJECT_ID.CATALOG_ID.NAMESPACE.TABLE_NAME: die vierteilige P.C.N.T-Kennung der Apache Iceberg-TabelleLOCATION: die Region oder der multiregionale Standort der DatenrichtlinieRAW_POLICY_NAME: der Name der Zugriffsrichtlinie für RohdatenCOLUMN_NAME: der Name jeder geschützten Spalte in der TabelleWRITER_ROW_POLICY_NAME: ein eindeutiger Name für die Zugriffsrichtlinie auf Zeilenebene für den WriterWRITER_SA_EMAIL: die E-Mail-Adresse des Dienstkontos, das den Apache Iceberg REST-Katalogendpunkt aufruft, z. B.spark-writer-sa@PROJECT_ID.iam.gserviceaccount.com.
Nächste Schritte
- Weitere Informationen finden Sie unter Modus für Bereitstellung von Anmeldedaten.
- ACLs für Kataloge, Namespaces und Tabellen verwalten
- Weitere Informationen finden Sie unter Datenrichtlinien für Spalten in BigQuery.
- Weitere Informationen finden Sie unter Sicherheit auf Zeilenebene in BigQuery.