Lakehouse API

L'API Lakehouse (in precedenza API BigLake) fornisce l'accesso a un metastore serverless, completamente gestito e ad alta disponibilità che fornisce una "single source of truth" per il tuo data lakehouse. Consente a più motori, tra cui Apache Spark, Google Managed Spark, Apache Flink, Trino e BigQuery, di condividere tabelle e metadati per i principali formati aperti (Apache Iceberg, Apache Hive) e di fare query sulla stessa copia dei dati. Inoltre, tramite la federazione del catalogo di runtime Lakehouse, puoi unire perfettamente il tuo ecosistema Lakehouse, consentendo ai motori compatibili con Iceberg su Google Cloud (BigQuery, Google Managed Spark) di scoprire e analizzare i dati aziendali in Snowflake, Databricks e AWS Glue.

Servizio: biglake.googleapis.com

Per chiamare questo servizio, ti consigliamo di utilizzare le librerie client fornite da Google. Se la tua applicazione deve utilizzare le tue librerie per chiamare questo servizio, utilizza le seguenti informazioni quando effettui le richieste API.

Documento di rilevamento

Un documento di rilevamento è una specifica leggibile da una macchina per descrivere e utilizzare le API REST. Viene utilizzato per creare librerie client, plug-in IDE e altri strumenti che interagiscono con le API di Google. Un servizio può fornire più documenti di rilevamento. Questo servizio fornisce il seguente documento di rilevamento:

Endpoint di servizio

Un endpoint di servizio è un URL di base che specifica l'indirizzo di rete di un servizio API. Un servizio potrebbe avere più endpoint di servizio. Questo servizio ha il seguente endpoint di servizio e tutti gli URI riportati di seguito sono relativi a questo endpoint di servizio:

  • https://biglake.googleapis.com

Endpoint di servizio regionale

Un endpoint di servizio regionale è un URL di base che specifica l'indirizzo di rete di un servizio API in una singola regione. Un servizio disponibile in più regioni potrebbe avere più endpoint regionali. Seleziona una località per visualizzare l'endpoint di servizio regionale per questo servizio.


  • https://biglake.googleapis.com

    • Risorsa REST: dataproductsharing.v1.projects.catalogs

    Metodi
    publishDataProduct POST /dataproductsharing/v1/{connectionCatalog=projects/*/catalogs/*}:publishDataProduct
    Pubblica un prodotto di dati Knowledge Catalog o un catalogo Iceberg in SAP BDC.
    unpublishDataProduct POST /dataproductsharing/v1/{connectionCatalog=projects/*/catalogs/*}:unpublishDataProduct
    Annulla la pubblicazione di un prodotto di dati di Knowledge Catalog o di una condivisione del catalogo Iceberg da SAP BDC.

    Risorsa REST: deltasharing.v1.projects.catalogs

    Metodi
    create POST /deltasharing/v1/{parent=projects/*}/catalogs
    Crea un nuovo catalogo Delta Sharing.
    delete DELETE /deltasharing/v1/{name=projects/*/catalogs/*}
    Elimina un catalogo Delta Sharing esistente specificato dal nome della risorsa.
    get GET /deltasharing/v1/{name=projects/*/catalogs/*}
    Recupera il catalogo specificato dal nome della risorsa.
    list GET /deltasharing/v1/{parent=projects/*}/catalogs
    Elenca tutti i cataloghi Delta Sharing in un progetto specificato.
    patch PATCH /deltasharing/v1/{deltaSharingCatalog.name=projects/*/catalogs/*}
    Aggiorna un catalogo Delta Sharing esistente.

    Risorsa REST: deltasharing.v1.projects.catalogs.shares

    Metodi
    list GET /deltasharing/v1/{parent=projects/*/catalogs/*}/shares
    Recupera un elenco delle condivisioni Delta Sharing disponibili nell'origine Delta Sharing upstream (ad es. SAP BDC).

    Risorsa REST: deltasharing.v1.projects.catalogs.shares.schemas

    Metodi
    list GET /deltasharing/v1/{parent=projects/*/catalogs/*/shares/*}/schemas
    Recupera un elenco di schemi Delta Sharing disponibili nell'origine SAP BDC upstream.

    Risorsa REST: deltasharing.v1.projects.catalogs.shares.schemas.tables

    Metodi
    list GET /deltasharing/v1/{parent=projects/*/catalogs/*/shares/*/schemas/*}/tables
    Recupera un elenco delle tabelle di condivisione delta disponibili nell'origine SAP BDC upstream.

    Risorsa REST: hive.v1.projects.catalogs

    Metodi
    create POST /hive/v1/{parent=projects/*}/catalogs
    Crea un nuovo catalogo Hive.
    delete DELETE /hive/v1/{name=projects/*/catalogs/*}
    Elimina un catalogo esistente specificato dall'ID catalogo.
    failover POST /hive/v1/{name=projects/*/catalogs/*}:failover
    Esegui il failover del catalogo in una nuova regione di replica principale.
    get GET /hive/v1/{name=projects/*/catalogs/*}
    Recupera il catalogo specificato dal nome della risorsa.
    list GET /hive/v1/{parent=projects/*}/catalogs
    Elenca tutti i cataloghi in un progetto specificato.
    patch PATCH /hive/v1/{hiveCatalog.name=projects/*/catalogs/*}
    Aggiorna un catalogo esistente.

    Risorsa REST: hive.v1.projects.catalogs.databases

    Metodi
    create POST /hive/v1/{parent=projects/*/catalogs/*}/databases
    Crea un nuovo database.
    delete DELETE /hive/v1/{name=projects/*/catalogs/*/databases/*}
    Elimina un database esistente specificato dal nome del database.
    get GET /hive/v1/{name=projects/*/catalogs/*/databases/*}
    Recupera il database specificato dal nome della risorsa.
    list GET /hive/v1/{parent=projects/*/catalogs/*}/databases
    Elenca tutti i database in un catalogo specificato.
    patch PATCH /hive/v1/{hiveDatabase.name=projects/*/catalogs/*/databases/*}
    Aggiorna un database esistente specificato dal nome del database.

    Risorsa REST: hive.v1.projects.catalogs.databases.tables

    Metodi
    create POST /hive/v1/{parent=projects/*/catalogs/*/databases/*}/tables
    Crea una nuova tabella Hive.
    delete DELETE /hive/v1/{name=projects/*/catalogs/*/databases/*/tables/*}
    Elimina una tabella esistente specificata dal nome della tabella.
    get GET /hive/v1/{name=projects/*/catalogs/*/databases/*/tables/*}
    Recupera la tabella specificata dal nome della risorsa.
    list GET /hive/v1/{parent=projects/*/catalogs/*/databases/*}/tables
    Elenca tutte le tabelle Hive in un progetto specificato nel catalogo e nel database Hive.
    patch PATCH /hive/v1/{hiveTable.name=projects/*/catalogs/*/databases/*/tables/*}
    Aggiorna una tabella esistente specificata dal nome della tabella.

    Risorsa REST: hive.v1.projects.catalogs.databases.tables.partitions

    Metodi
    batchCreate POST /hive/v1/{parent=projects/*/catalogs/*/databases/*/tables/*}/partitions:batchCreate
    Aggiunge partizioni a una tabella.
    batchDelete POST /hive/v1/{parent=projects/*/catalogs/*/databases/*/tables/*}/partitions:batchDelete
    Elimina le partizioni da una tabella.
    batchUpdate POST /hive/v1/{parent=projects/*/catalogs/*/databases/*/tables/*}/partitions:batchUpdate
    Aggiorna le partizioni in una tabella.
    list GET /hive/v1/{parent=projects/*/catalogs/*/databases/*/tables/*}/partitions:list
    Elenca gli stream di partizioni di una tabella.

    Risorsa REST: iceberg.v1.restcatalog.extensions.projects.catalogs

    Metodi
    create POST /iceberg/v1/restcatalog/extensions/{parent=projects/*}/catalogs
    Crea il catalogo REST Iceberg.
    delete DELETE /iceberg/v1/restcatalog/extensions/{name=projects/*/catalogs/*}
    Elimina il catalogo REST Iceberg.
    failover POST /iceberg/v1/restcatalog/extensions/{name=projects/*/catalogs/*}:failover
    Esegui il failover del catalogo in una nuova regione di replica principale.
    get GET /iceberg/v1/restcatalog/extensions/{name=projects/*/catalogs/*}
    Restituisce le opzioni di configurazione del catalogo REST Iceberg.
    list GET /iceberg/v1/restcatalog/extensions/{parent=projects/*}/catalogs
    Elenca i cataloghi REST Iceberg.
    patch PATCH /iceberg/v1/restcatalog/extensions/{icebergCatalog.name=projects/*/catalogs/*}
    Aggiorna le opzioni di configurazione del catalogo REST Iceberg.

    Risorsa REST: iceberg.v1.restcatalog.v1

    Metodi
    getConfig GET /iceberg/v1/restcatalog/v1/config
    GetIcebergCatalogConfig elenca tutte le impostazioni di configurazione del catalogo.

    Risorsa REST: iceberg.v1.restcatalog.v1.projects.catalogs.namespaces

    Metodi
    create POST /iceberg/v1/restcatalog/v1/{parent=projects/*/catalogs/*}/namespaces
    Crea uno spazio dei nomi nel catalogo.
    delete DELETE /iceberg/v1/restcatalog/v1/{name=projects/*/catalogs/*/namespaces/*}
    Restituisce 204, non 200 in caso di esito positivo.
    get GET /iceberg/v1/restcatalog/v1/{name=projects/*/catalogs/*/namespaces/*}
    Recupera uno spazio dei nomi Iceberg nel catalogo (o verifica se esiste, se il metodo è HEAD).
    head NONE /iceberg/v1/restcatalog/v1/{name=projects/*/catalogs/*/namespaces/*}
    Restituisce 204 se lo spazio dei nomi esiste, 404 altrimenti.
    list GET /iceberg/v1/restcatalog/v1/{apiParent=projects/*/catalogs/*}/namespaces
    Elenca gli spazi dei nomi Iceberg nel catalogo.
    properties POST /iceberg/v1/restcatalog/v1/{name=projects/*/catalogs/*/namespaces/*}/properties
    Aggiorna le proprietà dello spazio dei nomi.
    register POST /iceberg/v1/restcatalog/v1/{parent=projects/*/catalogs/*/namespaces/*}/register
    Registra una tabella utilizzando la posizione del file di metadati specificata.
    updateProperties PATCH /iceberg/v1/restcatalog/v1/{name=projects/*/catalogs/*/namespaces/*}/properties
    Aggiorna le proprietà dello spazio dei nomi.

    Risorsa REST: iceberg.v1.restcatalog.v1.projects.catalogs.namespaces.tables

    Metodi
    create POST /iceberg/v1/restcatalog/v1/{parent=projects/*/catalogs/*/namespaces/*}/tables
    Crea una tabella nello spazio dei nomi.
    credentials GET /iceberg/v1/restcatalog/v1/{name=projects/*/catalogs/*/namespaces/*/tables/*}/credentials
    Carica le credenziali per una tabella nello spazio dei nomi.
    delete DELETE /iceberg/v1/restcatalog/v1/{name=projects/*/catalogs/*/namespaces/*/tables/*}
    Elimina una tabella nello spazio dei nomi.
    get GET /iceberg/v1/restcatalog/v1/{name=projects/*/catalogs/*/namespaces/*/tables/*}
    Recupera una tabella nello spazio dei nomi.
    head NONE /iceberg/v1/restcatalog/v1/{name=projects/*/catalogs/*/namespaces/*/tables/*}
    Restituisce 204 se la tabella esiste, 404 altrimenti.
    list GET /iceberg/v1/restcatalog/v1/{parent=projects/*/catalogs/*/namespaces/*}/tables
    Elenca gli identificatori di tabella (non le tabelle) nello spazio dei nomi.
    metrics POST /iceberg/v1/restcatalog/v1/{name=projects/*/catalogs/*/namespaces/*/tables/*}/metrics
    Genera un report sulle metriche per una tabella.
    updateIcebergTable POST /iceberg/v1/restcatalog/v1/{name=projects/*/catalogs/*/namespaces/*/tables/*}
    Si tratta dell'API CommitTable Iceberg, che corrisponde a UpdateIcebergTable nella nomenclatura delle API di Google.

    Risorsa REST: v1.projects.catalogs

    Metodi
    getIamPolicy GET /v1/{resource=projects/*/catalogs/*}:getIamPolicy
    Recupera la policy IAM per il catalogo specificato.
    setIamPolicy POST /v1/{resource=projects/*/catalogs/*}:setIamPolicy
    Imposta la policy IAM per il catalogo specificato.
    testIamPermissions POST /v1/{resource=projects/*/catalogs/*}:testIamPermissions
    Esegue il test delle autorizzazioni IAM per il catalogo specificato.

    Risorsa REST: v1.projects.catalogs.namespaces

    Metodi
    getIamPolicy GET /v1/{resource=projects/*/catalogs/*/namespaces/*}:getIamPolicy
    Recupera la policy IAM per il catalogo specificato.
    setIamPolicy POST /v1/{resource=projects/*/catalogs/*/namespaces/*}:setIamPolicy
    Imposta la policy IAM per il catalogo specificato.
    testIamPermissions POST /v1/{resource=projects/*/catalogs/*/namespaces/*}:testIamPermissions
    Esegue il test delle autorizzazioni IAM per lo spazio dei nomi specificato.

    Risorsa REST: v1.projects.catalogs.namespaces.tables

    Metodi
    getIamPolicy GET /v1/{resource=projects/*/catalogs/*/namespaces/*/tables/*}:getIamPolicy
    Recupera la policy IAM per il catalogo specificato.
    setIamPolicy POST /v1/{resource=projects/*/catalogs/*/namespaces/*/tables/*}:setIamPolicy
    Imposta la policy IAM per il catalogo specificato.
    testIamPermissions POST /v1/{resource=projects/*/catalogs/*/namespaces/*/tables/*}:testIamPermissions
    Esegue il test delle autorizzazioni IAM per la tabella specificata.

    Risorsa REST: v1.projects.catalogs.namespaces.views

    Metodi
    getIamPolicy GET /v1/{resource=projects/*/catalogs/*/namespaces/*/views/*}:getIamPolicy
    Recupera la policy IAM per la visualizzazione specificata.
    setIamPolicy POST /v1/{resource=projects/*/catalogs/*/namespaces/*/views/*}:setIamPolicy
    Imposta la policy IAM per la visualizzazione specificata.
    testIamPermissions POST /v1/{resource=projects/*/catalogs/*/namespaces/*/views/*}:testIamPermissions
    Esegue il test delle autorizzazioni IAM per la visualizzazione specificata.

    Risorsa REST: v1.projects.locations.catalogs

    Metodi
    create POST /v1/{parent=projects/*/locations/*}/catalogs
    Crea un nuovo catalogo.
    delete DELETE /v1/{name=projects/*/locations/*/catalogs/*}
    Elimina un catalogo esistente specificato dall'ID catalogo.
    get GET /v1/{name=projects/*/locations/*/catalogs/*}
    Recupera il catalogo specificato dal nome della risorsa.
    list GET /v1/{parent=projects/*/locations/*}/catalogs
    Elenca tutti i cataloghi in un progetto specificato.

    Risorsa REST: v1.projects.locations.catalogs.databases

    Metodi
    create POST /v1/{parent=projects/*/locations/*/catalogs/*}/databases
    Crea un nuovo database.
    delete DELETE /v1/{name=projects/*/locations/*/catalogs/*/databases/*}
    Elimina un database esistente specificato dall'ID database.
    get GET /v1/{name=projects/*/locations/*/catalogs/*/databases/*}
    Recupera il database specificato dal nome della risorsa.
    list GET /v1/{parent=projects/*/locations/*/catalogs/*}/databases
    Elenca tutti i database in un catalogo specificato.
    patch PATCH /v1/{database.name=projects/*/locations/*/catalogs/*/databases/*}
    Aggiorna un database esistente specificato dall'ID database.

    Risorsa REST: v1.projects.locations.catalogs.databases.tables

    Metodi
    create POST /v1/{parent=projects/*/locations/*/catalogs/*/databases/*}/tables
    Crea una nuova tabella.
    delete DELETE /v1/{name=projects/*/locations/*/catalogs/*/databases/*/tables/*}
    Elimina una tabella esistente specificata dall'ID tabella.
    get GET /v1/{name=projects/*/locations/*/catalogs/*/databases/*/tables/*}
    Recupera la tabella specificata dal nome della risorsa.
    list GET /v1/{parent=projects/*/locations/*/catalogs/*/databases/*}/tables
    Elenca tutte le tabelle in un database specificato.
    patch PATCH /v1/{table.name=projects/*/locations/*/catalogs/*/databases/*/tables/*}
    Aggiorna una tabella esistente specificata dall'ID tabella.
    rename POST /v1/{name=projects/*/locations/*/catalogs/*/databases/*/tables/*}:rename
    Rinomina una tabella esistente specificata dall'ID tabella.