> 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/integrations/catalog-integration.md).

# Catalog Integration

Connect your data catalog to discover datasets, prioritize what to monitor, and share quality results.

Telmai integrates with your data catalog for dataset discovery, metadata enrichment, CDE coverage tracking and data governance. Catalog metadata adds business context to monitoring, so your team can find, prioritize and monitor critical datasets faster.

## Supported catalogs

* [Actian Data Intelligence Catalog](/telmai/integrations/catalog-integration/zeenea.md)
* [Databricks Unity Catalog](/telmai/integrations/catalog-integration/databricks-unity-catalog.md)
* [Microsoft Fabric OneLake](/telmai/integrations/catalog-integration/microsoft-fabric-onelake.md)
* [Atlan Catalog](/telmai/integrations/catalog-integration/atlan.md)

Alation is integrated separately; see [Alation Integration](/telmai/integrations/alation-integration.md). To show Telmai data quality results on your Atlan assets, see [Data Quality in Atlan](/telmai/integrations/atlan-integration.md).

## Connect a catalog

Tenant admins connect a catalog in **Administration** > **Catalogs**: choose the catalog, fill in its settings, and click **Connect**. Connecting tests the connection and starts the first sync. To change a connected catalog's settings later, edit them and click **Save changes**. See the page for your catalog for its settings.

Some catalogs, such as Atlan, also ask which connections to sync. Under **Connections to sync**, click **Load connections**, then pick the connections or check **All connections**.

{% hint style="info" %}
A tenant can connect one catalog at a time. While one is connected, the others show that it is connected and are locked. To switch, **Disconnect** the current catalog first.
{% endhint %}

After the first sync, the setting shows the result of the last sync, for example **Connected. Last sync succeeded**, with a **View in Catalog** link. Click **Sync now** to sync again at any time; otherwise Telmai syncs on the **Sync Interval** you set.

## The Catalog tab

The datasets discovered from your catalog are on the **Catalog** tab of the **Connections** page. Open **Connections** from the side menu and choose **Catalog**.

{% hint style="info" %}
The **Why it's recommended** reason, the **AI Recommendation** and the **CDE tier (AI)** part of the score come from Telmai's AI, so they need AI enabled in your Telmai installation. AI doesn't have to be turned on for the tenant. Syncing the catalog, linking its sources and monitoring its tables work without AI.
{% endhint %}

<figure><img src="https://604868671-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkO3-a8YVu1iq1jP__S%2Fuploads%2Fgit-blob-2282dcbe7c99ebc09df618f7ad7f38392a0fda69%2Fcatalog-tab-2026-11-04.png?alt=media" alt="The Catalog tab with catalog sources on the left and the catalog&#x27;s tables, views and filters on the right"><figcaption><p>The Catalog tab.</p></figcaption></figure>

### Summary

The card at the top names the catalog, when it last synced, how many tables and sources it found, and whether scan results are written back to it. It also says how many sources still need a connection. Use **Catalog settings** to open the catalog's setting in Administration, and **Sync now** to sync.

When the catalog has a single source, the card also shows its link. Click **Link connection** or **Create connection** to link it, or, once linked, **Edit connection** or **Unlink**.

### Sources

The panel on the left lists the catalog's sources: the databases, warehouses or workspaces it describes.

* **Available & connected** — sources linked to a Telmai connection. Click **Edit** to open the linked connection.
* **Discovered from catalog** — sources that aren't linked yet. For each one:
  * **Link** — link it to an existing Telmai connection.
  * **Create connection** — create a new connection for it, prefilled from the catalog.

Linking a source connects all of its tables at once. Sources that share a platform can be grouped. Use **Search catalog source...** to find a source, and **Manage connections** to open the **Connections** tab.

### Tables

The table on the right lists the catalog's tables. Choose a view:

| View             | Shows                                                          |
| ---------------- | -------------------------------------------------------------- |
| Recommended      | Tables Telmai recommends monitoring first.                     |
| Ready to monitor | Tables whose source is linked, so they can be added as assets. |
| Needs connection | Tables whose source isn't linked yet.                          |
| Monitored        | Tables already monitored as assets in Telmai.                  |
| All              | Every table.                                                   |

Filter by **Score**, **Criticality**, **Steward**, **Sensitive data** and **Data product**, use **Group by** to group the tables, or search by table name. Filters appear only when the catalog has values for them. For Databricks Unity Catalog, you can also filter by **Catalog**, and **Steward** is called **Owner**.

| Column               | Description                                                                 |
| -------------------- | --------------------------------------------------------------------------- |
| Table                | The table, with its location and catalog source.                            |
| Score                | How strongly the table is recommended for monitoring, out of 100.           |
| Steward              | The table's steward in the catalog.                                         |
| Status               | Whether the table is ready to monitor, needs a connection, or is monitored. |
| Why it's recommended | The AI's reason for recommending the table.                                 |

### Catalog details

Click a table to open its **Catalog details**.

<figure><img src="https://604868671-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkO3-a8YVu1iq1jP__S%2Fuploads%2Fgit-blob-b62737a6bd048cc225b3e1462ce6f8d01c422901%2Fcatalog-details-2026-11-04.png?alt=media" alt="Catalog details for a table with Metadata, Why this score and AI Recommendation" width="640"><figcaption><p>Catalog details.</p></figcaption></figure>

* **Overview** — the table's metadata (location, steward, catalog source, last update), **Why this score**, the **AI Recommendation** with its priority and the risks it addresses, the connection status, and timestamp column candidates.
* **Columns** — the table's columns from the catalog.
* **Lineage** — the table's upstream and downstream tables.

**View in catalog** opens the table in your catalog.

#### Why this score

The score adds up points for what Telmai knows about the table, such as:

* **CDE tier (AI)** — how critical the table's data elements are, as classified by Telmai's AI.
* **Connection** — whether its source is linked.
* **Steward set** — whether it has a steward.
* **Column count** — how many columns it has.
* **PII columns** — whether columns are tagged as PII.
* **Lineage** — whether other tables depend on it.
* **Column glossary** and **Table glossary** — whether glossary terms are attached.

Each input shows the points earned out of the points possible, and why when none were earned.

### Start monitoring tables

* For one table, open its **Catalog details** and click **Create Asset & Monitor**.
* For several tables, select them in the list and click **Monitor N tables** to create assets and deploy monitors for all of them at once.

The new assets appear under **Assets**, with default monitors. See [Managing Assets](/telmai/connect-to-data/managing-assets.md).
