The Lakehouse runtime catalog lets you manage
[catalog endpoints](https://docs.cloud.google.com/lakehouse/docs/about-lakehouse-catalogs.md.txt#configuration) in
borderless Lakehouse. You can use the Google Cloud console or the REST API
to create, configure, and monitor these catalog endpoints to establish the
metadata layer required for query engine connections.

## Before you begin

1. Read [About the Lakehouse runtime catalog](https://docs.cloud.google.com/lakehouse/docs/about-lakehouse-catalogs.md.txt) to understand how the Lakehouse runtime catalog works and the limitations for the service.

### Required roles


To get the permissions that
you need to use the Lakehouse runtime catalog,

ask your administrator to grant you the
following IAM roles on your project:

- [BigLake Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/biglake.md.txt#biglake.admin) (`roles/biglake.admin`)
- [Storage Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/storage.md.txt#storage.admin) (`roles/storage.admin`)


For more information about granting roles, see [Manage access to projects, folders, and organizations](https://docs.cloud.google.com/iam/docs/granting-changing-revoking-access.md.txt).


You might also be able to get
the required permissions through [custom
roles](https://docs.cloud.google.com/iam/docs/creating-custom-roles) or other [predefined
roles](https://docs.cloud.google.com/iam/docs/roles-overview#predefined).

## Management actions

You can perform the following management actions on your Apache Iceberg REST catalog endpoint resources using the Google Cloud console or the REST API:

- **[Create a catalog](https://docs.cloud.google.com/lakehouse/docs/create-catalog.md.txt):** Create an Apache Iceberg REST catalog management endpoint pointing to underlying Cloud Storage warehouse locations (`CreateIcebergCatalog`).
- **[Update a catalog](https://docs.cloud.google.com/lakehouse/docs/update-catalog.md.txt):** Upgrade an existing single bucket catalog to a multiple-bucket catalog (`UpdateIcebergCatalog`).
- **[Create a namespace](https://docs.cloud.google.com/lakehouse/docs/create-namespace.md.txt):** Create a namespace within an Iceberg REST catalog endpoint to group related tables (`CreateIcebergNamespace`).
- **[Enable credential vending](https://docs.cloud.google.com/lakehouse/docs/enable-credential-vending.md.txt):** Switch an existing catalog's authentication method to credential vending mode to vend short-lived storage tokens directly to query engines (`UpdateIcebergCatalog`).
- **[Get catalog details](https://docs.cloud.google.com/lakehouse/docs/get-catalog-details.md.txt):** View properties and metadata for your catalog, including the REST catalog URI required for client connections (`GetIcebergCatalog`).
- **[Manage namespace ACLs](https://docs.cloud.google.com/lakehouse/docs/manage-tables-acl.md.txt#apply-acl-namespaces):** View and update IAM policies on your catalog namespaces to control access for specific principals (`get-iam-policy`, `set-iam-policy`).
- **[Delete a catalog](https://docs.cloud.google.com/lakehouse/docs/delete-catalog.md.txt):** Unregister a catalog metadata management endpoint from the Lakehouse runtime catalog (`DeleteIcebergCatalog`).
- **[Delete a namespace](https://docs.cloud.google.com/lakehouse/docs/delete-namespace.md.txt):** Delete a namespace from your Iceberg REST catalog when it is no longer needed (`DeleteIcebergNamespace`).
- **[View audit logs](https://docs.cloud.google.com/lakehouse/docs/view-audit-logs.md.txt):** Inspect Cloud Audit Logs for verifiable records of administrative and data access activities.

## Pricing

For pricing details, see [Lakehouse
pricing](https://cloud.google.com/products/biglake/pricing).

## What's next

- Learn how to [manage namespace ACLs](https://docs.cloud.google.com/lakehouse/docs/manage-tables-acl.md.txt#apply-acl-namespaces).
- Learn more about the [Apache Iceberg REST catalog
  endpoint](https://docs.cloud.google.com/lakehouse/docs/set-up-lakehouse-iceberg-rest-catalog).