> 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/azure-onelake.md).

# OneLake

Connect Telmai to OneLake.

Telmai reads files from a Microsoft Fabric workspace in [OneLake](https://learn.microsoft.com/en-us/fabric/onelake/onelake-overview), signing in as an app registration with a client ID and secret.

{% hint style="info" %}
OneLake connections aren't supported on hybrid deployments.
{% endhint %}

## Before you connect

1. Register an application in Microsoft Entra ID. See Microsoft's [Register an application](https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app).
2. Copy the **Application (client) ID** and the **Directory (tenant) ID** from the app's **Overview** page.
3. Under **Certificates & secrets**, create a client secret and copy its value.
4. Give the app access to the Fabric workspace that holds your files.
5. Copy the workspace ID. It's the GUID after `/groups/` in the workspace's URL.

## Connection fields

On the **Connections** page, click **Add connection** and choose **OneLake**. See [Add a connection](https://docs.telm.ai/telmai/connect-to-data.md#add-a-connection) for the full flow.

| Field         | Description                                                 |
| ------------- | ----------------------------------------------------------- |
| **Workspace** | The Fabric workspace ID.                                    |
| **Tenant**    | Your Microsoft Entra tenant ID. It's under **Credentials**. |
| **Client ID** | The app's application (client) ID.                          |
| **Secret**    | The client secret value.                                    |

## Asset fields

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

| Field                                      | Description                                                                                |
| ------------------------------------------ | ------------------------------------------------------------------------------------------ |
| **Path**                                   | The file, or the folder of files, in the workspace. Wildcards are allowed.                 |
| **File type**                              | **Automatic**, or the format of the files.                                                 |
| **Delimiter**                              | For CSV files, **Comma**, **Semicolon**, **Tab**, **Space** or **Pipe**, or **Automatic**. |
| **Resolve wildcards (\*) to folder names** | Select it to read files from every folder that matches a wildcard in **Path**.             |

For paths, wildcards and file types, see [File Path Options](https://docs.telm.ai/telmai/connect-to-data/file-path-options.md) and [Supported File Types](https://docs.telm.ai/telmai/connect-to-data/supported-file-types.md).
