> 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

Connect Telmai to Iceberg REST.

Telmai reads Iceberg tables through a BigLake Metastore Iceberg REST catalog, with the data files in Google Cloud Storage.

{% hint style="info" %}
Available on GCP deployments only, with BigLake Metastore as the catalog.
{% endhint %}

## Before you connect

Grant these roles to the service account Telmai uses: the tenant service account, or your own service account on private-cloud deployments.

1. On the project that holds the BigLake Metastore: **BigLake Viewer** and **Service Usage Consumer**.
2. On the Cloud Storage bucket that BigLake uses: **Storage Object Viewer**.

## Connection fields

On the **Connections** page, click **Add connection** and choose **Iceberg REST**. See [Add a connection](/telmai/connect-to-data.md#add-a-connection) for the full flow.

| Field              | Description                                                                                                              |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| **Catalog URI**    | The REST catalog URI of your BigLake Metastore, for example `https://biglake.googleapis.com/iceberg/v1beta/restcatalog`. |
| **Catalog type**   | **BIGLAKE**.                                                                                                             |
| **Project ID**     | The GCP project that holds the metastore.                                                                                |
| **Region**         | The metastore's GCP region, for example `us-central1`.                                                                   |
| **Warehouse**      | The catalog's warehouse.                                                                                                 |
| **Default branch** | The table branch to read, for example `main`.                                                                            |

Under **Credentials**, Telmai uses the tenant service account shown next to **Using:**. On private-cloud GCP deployments, you can choose **Use credentials** instead and enter your service account's **Client email**, **Client ID**, **Project ID**, **Private key ID** and **Private key**.

## Asset fields

Click **Add assets** on the connection. See [Add assets](/telmai/connect-to-data.md#list-of-connectors-enabled-by-default).

| Field         | Description                          |
| ------------- | ------------------------------------ |
| **Namespace** | The namespace that holds the tables. |

Click **Next** to pick from the namespace's tables. **Custom query** isn't available.

## Limitations

**New records only** scans aren't supported for Iceberg tables.