Delete a namespace

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

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

If a namespace does not contain any tables, you can delete it.

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 namespace, ask your administrator to grant you the following IAM roles on your project:

• All:
  • BigLake Admin (roles/biglake.admin)
  • Storage Admin (roles/storage.admin)

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 namespace

Delete a namespace from a catalog.

DELETE /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME