Delete a catalog

When you delete a catalog (such as an Apache Iceberg REST catalog or Apache Hive catalog), the system unregisters the metadata management endpoint from the Lakehouse runtime catalog.

Although this removes the catalog from Lakehouse for Apache Iceberg, it does not automatically delete the underlying Cloud Storage warehouse bucket or your stored data files.

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 delete a catalog, 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.

Delete a catalog

Delete a catalog endpoint.

Console

  1. In the Google Cloud console, open the Lakehouse page.

    Go to Lakehouse

  2. In the row of the catalog that you're deleting, click More catalog actions > Delete.

  3. In the delete dialog, enter DELETE and click Delete.

REST

To delete a catalog management endpoint using the REST API, make a DELETE request to the DeleteIcebergCatalog endpoint:

DELETE /iceberg/v1/restcatalog/extensions/projects/PROJECT_ID/catalogs/CATALOG_ID

Replace the following:

  • PROJECT_ID: your Google Cloud project ID.
  • CATALOG_ID: the ID of your Lakehouse runtime catalog.