Manage Iceberg REST catalogs

Lakehouse for Apache Iceberg lets you manage the Apache Iceberg REST catalog endpoint within the Lakehouse runtime catalog. The Google Cloud console lets you create, configure, and monitor these catalogs to establish the metadata layer required for query engine connections.

Before you begin

  1. Verify that billing is enabled for your Google Cloud project.

  2. Enable the BigLake API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

Required roles

To get the permissions that you need to use the Lakehouse runtime catalog in the Google Cloud console, ask your administrator to grant you the following IAM roles on your project:

For more information about granting roles, see Manage access to projects, folders, and organizations.

You might also be able to get the required permissions through custom roles or other predefined roles.

Management actions

You can perform the following management actions on your Apache Iceberg REST catalogs in the Google Cloud console:

  • Create a catalog: Create an Apache Iceberg REST catalog management endpoint pointing to an underlying Cloud Storage bucket warehouse.
  • Enable credential vending: Switch an existing catalog's authentication method to credential vending mode to vend short-lived storage tokens directly to query engines.
  • Get catalog details: View properties and metadata for your catalog, including the REST catalog URI required for client connections.
  • Import tables: Ingest data from external Apache Iceberg REST catalogs directly into your Lakehouse tables using Dataflow's job builder UI.
  • Delete a catalog: Unregister a catalog metadata management endpoint from the Lakehouse runtime catalog.
  • View audit logs: Inspect Cloud Audit Logs for verifiable records of administrative and data access activities.

Pricing

For pricing details, see Lakehouse for Apache Iceberg pricing.

What's next

Learn more about the Apache Iceberg REST catalog endpoint.