Wenn Sie eine Apache Iceberg-Ansicht ändern, können Sie das Schema und die SQL-Definition der Ansicht weiterentwickeln oder benutzerdefinierte Ansichtseigenschaften festlegen und aufheben, ohne die Identität der Ansicht im Lakehouse-Laufzeitkatalog zu ändern.
Das Umbenennen einer Ansicht wird nicht unterstützt. Wenn Sie eine Ansicht umbenennen möchten, erstellen Sie eine Ansicht mit dem neuen Namen und löschen Sie dann die ursprüngliche Ansicht. Der Speicherort einer Ansicht ist nach der Erstellung ebenfalls unveränderlich. Eine Aktualisierung, bei der ein anderer Speicherort festgelegt wird, schlägt mit dem Fehler 400 Bad Request fehl.
Hinweis
-
Prüfen Sie, ob die Abrechnung für Ihr Google Cloud -Projekt aktiviert ist.
-
Aktivieren Sie die BigLake API, falls sie noch nicht aktiviert ist.
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 ein.
- Lesen Sie die Einschränkungen von Iceberg-Ansichten.
- Ansicht erstellen
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt und Ihren Storage-Bucket zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Ändern einer Ansicht benötigen:
-
Ansicht ändern: BigLake-Bearbeiter (
roles/biglake.editor) – Ihr Projekt -
Metadatendateien für Ansichten im Modus für Endnutzer-Anmeldedaten schreiben: Storage-Objekt-Nutzer (
roles/storage.objectUser) – der Cloud Storage-Bucket
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Ändern einer Ansicht erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Zum Ändern einer Ansicht sind die folgenden Berechtigungen erforderlich:
-
Ansicht ändern:
-
biglake.views.updatefür die Ansicht -
biglake.tables.getfür jede Iceberg-Tabelle, auf die die neue Ansichtsdefinition verweist
-
-
Metadatendateien für Ansichten im Modus für Endnutzer-Anmeldedaten schreiben:
storage.objects.createfür den Cloud Storage-Bucket
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Eine vollständige Liste der Leseberechtigungen finden Sie unter Erforderliche Rollen und Berechtigungen.
Ansichtsdefinition ersetzen
Ersetzen Sie das Schema und die SQL-Logik einer vorhandenen Ansicht. Wenn Sie eine Ansicht ersetzen, schreibt der Katalog eine neue versionierte metadata.json-Datei (z. B. 00001-UUID.metadata.json), hängt eine neue Ansichtsversion und ein neues Schema an die Ansichtsmetadaten an und behält die view-uuid der Ansicht bei.
Spark
CREATE OR REPLACE VIEW my_ns.eng_employees (
emp_id,
emp_name,
dept,
salary,
is_senior
)
COMMENT 'Updated Engineering view with seniority flag'
AS SELECT id, name, dept, salary, (salary >= 140000.0) AS is_senior
FROM my_ns.employees
WHERE dept = 'Engineering';
REST
Wenn Sie eine Ansicht mit der REST API aktualisieren möchten, senden Sie eine POST-Anfrage an den Endpunkt UpdateIcebergView:
POST /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/views/VIEW_NAME
Der Anfragetext muss eine gültige Iceberg-CommitViewRequest-JSON-Nutzlast mit den anzuwendenden requirements und updates enthalten. Der Katalog validiert die Anforderungen an die optimistische Nebenläufigkeit und schreibt die Aktualisierungen in eine neue metadata.json-Datei.
Ersetzen Sie Folgendes:
PROJECT_ID: Ihre Projekt-ID in Google Cloud.CATALOG_ID: die ID Ihres Katalogs.NAMESPACE_NAME: der Name Ihres Katalog-Namespace.VIEW_NAME: der Name der Ansicht.
Ansichtsattribute festlegen und entfernen
Benutzerdefinierte Eigenschaften für eine Ansicht festlegen oder entfernen, ohne ihre Definition zu ändern.
Spark
Legen Sie die Attribute fest:
ALTER VIEW my_ns.eng_employees
SET TBLPROPERTIES ('tier' = 'gold', 'reviewed' = 'true');
Attribut aufheben:
ALTER VIEW my_ns.eng_employees
UNSET TBLPROPERTIES IF EXISTS ('reviewed');
Weitere Informationen dazu, wie der Katalog Attribute wie write.metadata.compression-codec verarbeitet, finden Sie unter Attribute ansehen.
REST
Senden Sie eine CommitViewRequest-Anfrage an den UpdateIcebergView-Endpunkt mit set-properties- oder remove-properties-Updates. Den Endpunktpfad finden Sie unter Ansichtsdefinition ersetzen.