> For the complete documentation index, see [llms.txt](https://docs.telm.ai/telmai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.telm.ai/telmai/connect-to-data/data-connections/iceberg-rest.md).

# Iceberg REST

BigLake Metastore via Iceberg REST catalog (GCP only)

Feature only supported for GCP-BigLake and GCP deployments

## Creating a connection

To setup connection to Iceberg REST metastore, you will need to provide

* **Catalog URI**: Enter the REST catalog URI for your BigLake Metastore.
* **Project ID**: GCP Project ID where the metastore exists
* **Region:** GCP region for metastore
* **Warehouse:** Warehouse name
* **Default Branch:** Default table branch name

<figure><img src="https://604868671-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkO3-a8YVu1iq1jP__S%2Fuploads%2FXsEl5Q0kbztVcNSspEgi%2Fimage.png?alt=media&amp;token=52743d6d-0e23-4032-9cb4-9791df76d36a" alt=""><figcaption></figcaption></figure>

## Required Permissions

The following permissions are required to enable reading data from BigLake:

On BigLake side, you will need to grant:

* `Big Lake Viewer`
* `Service Usage Consumer`

On the Storage Bucket used by BigLake, you will need to grant:

* `Storage Object Viewer`

## Connecting an asset

Once a connection is defined, you can start using it to create assets. To create assets, you will need:

* Target Namespace
  * Next step will show you available tables

<figure><img src="https://604868671-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkO3-a8YVu1iq1jP__S%2Fuploads%2F6NTQWTDJbnRere2fANyp%2Fimage.png?alt=media&amp;token=2fad253d-44ac-461b-a1a3-a80c105af5a2" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Custom SQL Query is not currently supported for Iceberg connections
{% endhint %}

{% hint style="warning" %}
Delta scans is not currently supported for Iceberg connections
{% endhint %}

Once defined, you will be able to see your data asset in Telmai