> 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

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="/files/T6FW48UrLt78P7m4yvmC" 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="/files/5jJqvlLsfKFCpJplJPnq" 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