Lakehouse API

Die Lakehouse API (ehemals BigLake API) bietet Zugriff auf einen serverlosen, vollständig verwalteten und hochverfügbaren Metastore, der eine einzige zuverlässige Informationsquelle für Ihr Data Lakehouse darstellt. Er ermöglicht es mehreren Engines, darunter Apache Spark, Google Managed Spark, Apache Flink, Trino und BigQuery, Tabellen und Metadaten für wichtige offene Formate (Apache Iceberg, Apache Hive) gemeinsam zu nutzen und dieselbe Datenkopie abzufragen. Außerdem können Sie über die Föderation des Lakehouse-Laufzeitkatalogs Ihr Lakehouse-Ökosystem nahtlos zusammenführen, sodass Iceberg-kompatible Engines in Google Cloud (BigQuery, Google Managed Spark) Unternehmensdaten in Snowflake, Databricks und AWS Glue erkennen und analysieren können.

Dienst: biglake.googleapis.com

Wir empfehlen, diesen Dienst mit den von Google bereitgestellten Clientbibliotheken aufzurufen. Wenn Ihre Anwendung diesen Dienst mit Ihren eigenen Bibliotheken aufrufen muss, sollten Sie die folgenden Informationen verwenden, wenn Sie die API-Anfragen senden.

Discovery-Dokument

Ein Discovery-Dokument ist eine maschinenlesbare Spezifikation zum Beschreiben und Nutzen von REST APIs. Sie wird verwendet, um Clientbibliotheken, IDE-Plug-ins und andere Tools zu erstellen, die mit Google APIs interagieren. Ein Dienst kann mehrere Discovery-Dokumente haben. Der Dienst bietet das folgende Discovery-Dokument:

Dienstendpunkt

Ein Dienstendpunkt ist eine Basis-URL, die die Netzwerkadresse eines API-Dienstes angibt. Ein Dienst kann mehrere Dienstendpunkte haben. Dieser Dienst hat den folgenden Dienstendpunkt und alle nachstehenden URIs beziehen sich auf ihn:

  • https://biglake.googleapis.com

Regionaler Dienstendpunkt

Ein regionaler Dienstendpunkt ist eine Basis-URL, die die Netzwerkadresse eines API-Dienstes in einer bestimmten Region enthält. Ein Dienst, der in mehreren Regionen verfügbar ist, kann mehrere regionale Endpunkte haben. Wählen Sie eine Zone aus, um den regionalen Dienstendpunkt für diesen Dienst aufzurufen.


  • https://biglake.googleapis.com

    • REST-Ressource: dataproductsharing.v1.projects.catalogs

    Methoden
    publishDataProduct POST /dataproductsharing/v1/{connectionCatalog=projects/*/catalogs/*}:publishDataProduct
    Veröffentlicht ein Knowledge Catalog-Datenprodukt oder einen Iceberg-Katalog in SAP BDC.
    unpublishDataProduct POST /dataproductsharing/v1/{connectionCatalog=projects/*/catalogs/*}:unpublishDataProduct
    Hebt die Veröffentlichung eines Knowledge Catalog-Datenprodukts oder einer Iceberg-Katalogfreigabe aus SAP BDC auf.

    REST-Ressource: deltasharing.v1.projects.catalogs

    Methoden
    create POST /deltasharing/v1/{parent=projects/*}/catalogs
    Erstellt einen neuen Delta Sharing-Katalog.
    delete DELETE /deltasharing/v1/{name=projects/*/catalogs/*}
    Löscht einen vorhandenen Delta Sharing-Katalog, der durch den Ressourcennamen angegeben wird.
    get GET /deltasharing/v1/{name=projects/*/catalogs/*}
    Ruft den durch den Ressourcennamen angegebenen Katalog ab.
    list GET /deltasharing/v1/{parent=projects/*}/catalogs
    Alle Delta Sharing-Kataloge in einem angegebenen Projekt auflisten.
    patch PATCH /deltasharing/v1/{deltaSharingCatalog.name=projects/*/catalogs/*}
    Aktualisiert einen vorhandenen Delta Sharing-Katalog.

    REST-Ressource: deltasharing.v1.projects.catalogs.shares

    Methoden
    list GET /deltasharing/v1/{parent=projects/*/catalogs/*}/shares
    Ruft eine Liste der Delta Sharing-Freigaben ab, die in der Upstream-Delta Sharing-Quelle (z.B. SAP BDC) verfügbar sind.

    REST-Ressource: deltasharing.v1.projects.catalogs.shares.schemas

    Methoden
    list GET /deltasharing/v1/{parent=projects/*/catalogs/*/shares/*}/schemas
    Ruft eine Liste der Delta Sharing-Schemas ab, die in der Upstream-SAP BDC-Quelle verfügbar sind.

    REST-Ressource: deltasharing.v1.projects.catalogs.shares.schemas.tables

    Methoden
    list GET /deltasharing/v1/{parent=projects/*/catalogs/*/shares/*/schemas/*}/tables
    Ruft eine Liste der Delta Sharing-Tabellen ab, die in der Upstream-SAP BDC-Quelle verfügbar sind.

    REST-Ressource: hive.v1.projects.catalogs

    Methoden
    create POST /hive/v1/{parent=projects/*}/catalogs
    Erstellt einen neuen Hive-Katalog.
    delete DELETE /hive/v1/{name=projects/*/catalogs/*}
    Löscht einen vorhandenen Katalog, der durch die Katalog-ID angegeben wird.
    failover POST /hive/v1/{name=projects/*/catalogs/*}:failover
    Failover des Katalogs in eine neue primäre Replikatregion.
    get GET /hive/v1/{name=projects/*/catalogs/*}
    Ruft den durch den Ressourcennamen angegebenen Katalog ab.
    list GET /hive/v1/{parent=projects/*}/catalogs
    Alle Kataloge in einem angegebenen Projekt auflisten.
    patch PATCH /hive/v1/{hiveCatalog.name=projects/*/catalogs/*}
    Aktualisiert einen vorhandenen Katalog.

    REST-Ressource: hive.v1.projects.catalogs.databases

    Methoden
    create POST /hive/v1/{parent=projects/*/catalogs/*}/databases
    Erstellt eine neue Datenbank.
    delete DELETE /hive/v1/{name=projects/*/catalogs/*/databases/*}
    Löscht eine vorhandene Datenbank, die durch den Datenbanknamen angegeben wird.
    get GET /hive/v1/{name=projects/*/catalogs/*/databases/*}
    Ruft die durch den Ressourcennamen angegebene Datenbank ab.
    list GET /hive/v1/{parent=projects/*/catalogs/*}/databases
    Alle Datenbanken in einem angegebenen Katalog auflisten.
    patch PATCH /hive/v1/{hiveDatabase.name=projects/*/catalogs/*/databases/*}
    Aktualisiert eine vorhandene Datenbank, die durch den Datenbanknamen angegeben wird.

    REST-Ressource: hive.v1.projects.catalogs.databases.tables

    Methoden
    create POST /hive/v1/{parent=projects/*/catalogs/*/databases/*}/tables
    Erstellt eine neue Hive-Tabelle.
    delete DELETE /hive/v1/{name=projects/*/catalogs/*/databases/*/tables/*}
    Löscht eine vorhandene Tabelle, die durch den Tabellennamen angegeben wird.
    get GET /hive/v1/{name=projects/*/catalogs/*/databases/*/tables/*}
    Ruft die Tabelle ab, die durch den Ressourcennamen angegeben wird.
    list GET /hive/v1/{parent=projects/*/catalogs/*/databases/*}/tables
    Listet alle Hive-Tabellen in einem angegebenen Projekt unter dem Hive-Katalog und der Hive-Datenbank auf.
    patch PATCH /hive/v1/{hiveTable.name=projects/*/catalogs/*/databases/*/tables/*}
    Aktualisiert eine vorhandene Tabelle, die durch den Tabellennamen angegeben wird.

    REST-Ressource: hive.v1.projects.catalogs.databases.tables.partitions

    Methoden
    batchCreate POST /hive/v1/{parent=projects/*/catalogs/*/databases/*/tables/*}/partitions:batchCreate
    Fügt einer Tabelle Partitionen hinzu.
    batchDelete POST /hive/v1/{parent=projects/*/catalogs/*/databases/*/tables/*}/partitions:batchDelete
    Löscht Partitionen aus einer Tabelle.
    batchUpdate POST /hive/v1/{parent=projects/*/catalogs/*/databases/*/tables/*}/partitions:batchUpdate
    Aktualisiert Partitionen in einer Tabelle.
    list GET /hive/v1/{parent=projects/*/catalogs/*/databases/*/tables/*}/partitions:list
    Streams list of partitions from a table.

    REST-Ressource: iceberg.v1.restcatalog.extensions.projects.catalogs

    Methoden
    create POST /iceberg/v1/restcatalog/extensions/{parent=projects/*}/catalogs
    Erstellt den Iceberg-REST-Katalog.
    delete DELETE /iceberg/v1/restcatalog/extensions/{name=projects/*/catalogs/*}
    Löscht den Iceberg-REST-Katalog.
    failover POST /iceberg/v1/restcatalog/extensions/{name=projects/*/catalogs/*}:failover
    Failover des Katalogs in eine neue primäre Replikatregion.
    get GET /iceberg/v1/restcatalog/extensions/{name=projects/*/catalogs/*}
    Gibt die Konfigurationsoptionen für den Iceberg-REST-Katalog zurück.
    list GET /iceberg/v1/restcatalog/extensions/{parent=projects/*}/catalogs
    Führt die Iceberg-REST-Kataloge auf.
    patch PATCH /iceberg/v1/restcatalog/extensions/{icebergCatalog.name=projects/*/catalogs/*}
    Aktualisieren Sie die Konfigurationsoptionen für den Iceberg-REST-Katalog.

    REST-Ressource: iceberg.v1.restcatalog.v1

    Methoden
    getConfig GET /iceberg/v1/restcatalog/v1/config
    GetIcebergCatalogConfig listet alle Katalogkonfigurationseinstellungen auf.

    REST-Ressource: iceberg.v1.restcatalog.v1.projects.catalogs.namespaces

    Methoden
    create POST /iceberg/v1/restcatalog/v1/{parent=projects/*/catalogs/*}/namespaces
    Erstellt einen Namespace im Katalog.
    delete DELETE /iceberg/v1/restcatalog/v1/{name=projects/*/catalogs/*/namespaces/*}
    Gibt bei Erfolg 204 und nicht 200 zurück.
    get GET /iceberg/v1/restcatalog/v1/{name=projects/*/catalogs/*/namespaces/*}
    Ruft einen Iceberg-Namespace im Katalog ab (oder prüft, ob er vorhanden ist, wenn die Methode HEAD ist).
    head NONE /iceberg/v1/restcatalog/v1/{name=projects/*/catalogs/*/namespaces/*}
    Gibt 204 zurück, wenn der Namespace vorhanden ist, andernfalls 404.
    list GET /iceberg/v1/restcatalog/v1/{apiParent=projects/*/catalogs/*}/namespaces
    Listet Iceberg-Namespaces im Katalog auf.
    properties POST /iceberg/v1/restcatalog/v1/{name=projects/*/catalogs/*/namespaces/*}/properties
    Aktualisiert Namespace-Attribute.
    register POST /iceberg/v1/restcatalog/v1/{parent=projects/*/catalogs/*/namespaces/*}/register
    Registriert eine Tabelle mit dem angegebenen Speicherort der Metadatendatei.
    updateProperties PATCH /iceberg/v1/restcatalog/v1/{name=projects/*/catalogs/*/namespaces/*}/properties
    Aktualisiert Namespace-Attribute.

    REST-Ressource: iceberg.v1.restcatalog.v1.projects.catalogs.namespaces.tables

    Methoden
    create POST /iceberg/v1/restcatalog/v1/{parent=projects/*/catalogs/*/namespaces/*}/tables
    Erstellt eine Tabelle im Namespace.
    credentials GET /iceberg/v1/restcatalog/v1/{name=projects/*/catalogs/*/namespaces/*/tables/*}/credentials
    Lädt Anmeldedaten für eine Tabelle im Namespace.
    delete DELETE /iceberg/v1/restcatalog/v1/{name=projects/*/catalogs/*/namespaces/*/tables/*}
    Löscht eine Tabelle im Namespace.
    get GET /iceberg/v1/restcatalog/v1/{name=projects/*/catalogs/*/namespaces/*/tables/*}
    Ruft eine Tabelle im Namespace ab.
    head NONE /iceberg/v1/restcatalog/v1/{name=projects/*/catalogs/*/namespaces/*/tables/*}
    Gibt 204 zurück, wenn die Tabelle vorhanden ist, andernfalls 404.
    list GET /iceberg/v1/restcatalog/v1/{parent=projects/*/catalogs/*/namespaces/*}/tables
    Listet Tabellenkennungen (nicht Tabellen) im Namespace auf.
    metrics POST /iceberg/v1/restcatalog/v1/{name=projects/*/catalogs/*/namespaces/*/tables/*}/metrics
    Gibt einen Messwertbericht für eine Tabelle zurück.
    updateIcebergTable POST /iceberg/v1/restcatalog/v1/{name=projects/*/catalogs/*/namespaces/*/tables/*}
    Dies ist die CommitTable Iceberg API, die in der Google API-Nomenklatur UpdateIcebergTable entspricht.

    REST-Ressource: v1.projects.catalogs

    Methoden
    getIamPolicy GET /v1/{resource=projects/*/catalogs/*}:getIamPolicy
    Ruft die IAM-Richtlinie für den angegebenen Katalog ab.
    setIamPolicy POST /v1/{resource=projects/*/catalogs/*}:setIamPolicy
    Legt die IAM-Richtlinie für den angegebenen Katalog fest.
    testIamPermissions POST /v1/{resource=projects/*/catalogs/*}:testIamPermissions
    Testet die IAM-Berechtigungen für den angegebenen Katalog.

    REST-Ressource: v1.projects.catalogs.namespaces

    Methoden
    getIamPolicy GET /v1/{resource=projects/*/catalogs/*/namespaces/*}:getIamPolicy
    Ruft die IAM-Richtlinie für den angegebenen Katalog ab.
    setIamPolicy POST /v1/{resource=projects/*/catalogs/*/namespaces/*}:setIamPolicy
    Legt die IAM-Richtlinie für den angegebenen Katalog fest.
    testIamPermissions POST /v1/{resource=projects/*/catalogs/*/namespaces/*}:testIamPermissions
    Testet die IAM-Berechtigungen für den angegebenen Namespace.

    REST-Ressource: v1.projects.catalogs.namespaces.tables

    Methoden
    getIamPolicy GET /v1/{resource=projects/*/catalogs/*/namespaces/*/tables/*}:getIamPolicy
    Ruft die IAM-Richtlinie für den angegebenen Katalog ab.
    setIamPolicy POST /v1/{resource=projects/*/catalogs/*/namespaces/*/tables/*}:setIamPolicy
    Legt die IAM-Richtlinie für den angegebenen Katalog fest.
    testIamPermissions POST /v1/{resource=projects/*/catalogs/*/namespaces/*/tables/*}:testIamPermissions
    Testet die IAM-Berechtigungen für die angegebene Tabelle.

    REST-Ressource: v1.projects.catalogs.namespaces.views

    Methoden
    getIamPolicy GET /v1/{resource=projects/*/catalogs/*/namespaces/*/views/*}:getIamPolicy
    Ruft die IAM-Richtlinie für die angegebene Ansicht ab.
    setIamPolicy POST /v1/{resource=projects/*/catalogs/*/namespaces/*/views/*}:setIamPolicy
    Legt die IAM-Richtlinie für die angegebene Ansicht fest.
    testIamPermissions POST /v1/{resource=projects/*/catalogs/*/namespaces/*/views/*}:testIamPermissions
    Testet die IAM-Berechtigungen für die angegebene Ansicht.

    REST-Ressource: v1.projects.locations.catalogs

    Methoden
    create POST /v1/{parent=projects/*/locations/*}/catalogs
    Erstellt einen neuen Katalog.
    delete DELETE /v1/{name=projects/*/locations/*/catalogs/*}
    Löscht einen vorhandenen Katalog, der durch die Katalog-ID angegeben wird.
    get GET /v1/{name=projects/*/locations/*/catalogs/*}
    Ruft den durch den Ressourcennamen angegebenen Katalog ab.
    list GET /v1/{parent=projects/*/locations/*}/catalogs
    Alle Kataloge in einem angegebenen Projekt auflisten.

    REST-Ressource: v1.projects.locations.catalogs.databases

    Methoden
    create POST /v1/{parent=projects/*/locations/*/catalogs/*}/databases
    Erstellt eine neue Datenbank.
    delete DELETE /v1/{name=projects/*/locations/*/catalogs/*/databases/*}
    Löscht eine vorhandene Datenbank, die durch die Datenbank-ID angegeben wird.
    get GET /v1/{name=projects/*/locations/*/catalogs/*/databases/*}
    Ruft die durch den Ressourcennamen angegebene Datenbank ab.
    list GET /v1/{parent=projects/*/locations/*/catalogs/*}/databases
    Alle Datenbanken in einem angegebenen Katalog auflisten.
    patch PATCH /v1/{database.name=projects/*/locations/*/catalogs/*/databases/*}
    Aktualisiert eine vorhandene Datenbank, die durch die Datenbank-ID angegeben wird.

    REST-Ressource: v1.projects.locations.catalogs.databases.tables

    Methoden
    create POST /v1/{parent=projects/*/locations/*/catalogs/*/databases/*}/tables
    Erstellt eine neue Tabelle.
    delete DELETE /v1/{name=projects/*/locations/*/catalogs/*/databases/*/tables/*}
    Löscht eine vorhandene Tabelle, die durch die Tabellen-ID angegeben wird.
    get GET /v1/{name=projects/*/locations/*/catalogs/*/databases/*/tables/*}
    Ruft die Tabelle ab, die durch den Ressourcennamen angegeben wird.
    list GET /v1/{parent=projects/*/locations/*/catalogs/*/databases/*}/tables
    Alle Tabellen in einer angegebenen Datenbank auflisten.
    patch PATCH /v1/{table.name=projects/*/locations/*/catalogs/*/databases/*/tables/*}
    Aktualisiert eine vorhandene Tabelle, die durch die Tabellen-ID angegeben wird.
    rename POST /v1/{name=projects/*/locations/*/catalogs/*/databases/*/tables/*}:rename
    Benennt eine vorhandene Tabelle um, die durch die Tabellen-ID angegeben wird.