# Iceberg REST

Feature only supported for GCP-BigLake

## 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.telm.ai/telmai/connect-to-data/data-connections/iceberg-rest.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.