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

# Actian Data Intelligence Catalog

Telmai integrates with [Actian Data Intelligence](https://www.actian.com/data-intelligence/platform/) to connect data quality monitoring with your Actian Data Intelligence catalog. Actian Data Intelligence catalog metadata enriches Telmai's monitoring configuration and AI-powered recommendations, helping your team discover, prioritize, and monitor critical datasets faster.

The integration runs in both directions: Telmai reads catalog metadata to enrich its monitoring, and writes data quality results back into the catalog so governance and quality live in one place.

## Overview

Telmai pulls the following metadata from Actian Data Intelligence:

| Metadata type               | How Telmai uses it                                              |
| --------------------------- | --------------------------------------------------------------- |
| Business glossary terms     | Informs AI-generated monitoring rules with business definitions |
| Sensitivity classifications | Surfaces sensitivity context alongside monitors                 |
| Stewardship information     | Identifies the data steward responsible for each asset          |

<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-f511bf462b15bd9872c7d2220230bb9f388ee43a%2FScreenshot%202026-07-03%20at%203.56.00%20PM.png?alt=media" alt="Catalog Details Columns tab showing CDE tiers, sensitivity classifications, and glossary terms per column"><figcaption><p>Column-level metadata from Actian Data Intelligence: CDE tiers, sensitivity classifications, and glossary terms.</p></figcaption></figure>

{% hint style="info" %}
The Actian Data Intelligence catalog integration supports the following Telmai data connection types: **BigQuery**, **Databricks**, **Snowflake**, and **OneLake**.
{% endhint %}

### Not yet available

| Capability | Status      |
| ---------- | ----------- |
| Lineage    | Coming soon |

***

## Step 1: Create an API Key in Actian Data Intelligence

Telmai authenticates to Actian Data Intelligence with an API key. To create one:

1. In your Actian Data Intelligence instance, go to **Administration > API Keys**.
2. Create a new API key and give it a descriptive name (e.g., `telmai-integration`).
3. Select the **scanner** permission for the key.
4. Save the key. Actian Data Intelligence displays the secret once, inside a configuration snippet:

```hocon
api-key {
    secret = "eyJ0eXAiOiJKV1QiLCJhbGciOi..."
}
```

{% hint style="warning" %}
When copying the API key into Telmai, copy **only the secret value** — the token between the quotation marks (it starts with `eyJ`). Do not include the surrounding `api-key { secret = "..." }` wrapper or the quotation marks themselves.
{% endhint %}

***

## Step 2: Connect to Actian Data Intelligence Catalog

In Telmai, go to **Administration** and select **Catalog** from the left menu.

<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-6482857be2ccca154037947d777905cc0ca81b2a%2FScreenshot%202026-06-23%20at%204.05.00%20PM.png?alt=media" alt="Administration > Catalog connection form"><figcaption><p>The Catalog connection form in Administration, showing Catalog Type, API Endpoint, API Key/Token, and Sync Interval.</p></figcaption></figure>

Enter the following details:

| Field                   | Description                                                                                                                                                                                              |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Catalog Type            | Select **ADI Catalog** for Actian Data Intelligence                                                                                                                                                      |
| API Endpoint            | Your Actian Data Intelligence instance URL (e.g., `https://your-org.zeenea.app/`)                                                                                                                        |
| API Key / Token         | The API key secret created in Step 1 (only the token value, not the full `api-key { ... }` snippet). Leave blank when updating other fields to keep existing credentials.                                |
| Sync Interval (hours)   | How often Telmai syncs metadata from Actian Data Intelligence. Accepts values between 1 and 168 hours.                                                                                                   |
| Push results to catalog | Select this checkbox to write Telmai data quality results back into Actian Data Intelligence. See [Writing Results Back to Actian Data Intelligence](#writing-results-back-to-actian-data-intelligence). |

Save the connection. Once connected, Telmai displays **Connected to ADI Catalog** and two additional actions become available:

* **Sync Now** — triggers an immediate metadata sync
* **Remove Connection** — disconnects Telmai from Actian Data Intelligence

{% hint style="info" %}
After connecting, go to **Catalog Browser** to explore discovered datasets and link them to your Telmai data connections.
{% endhint %}

***

## Step 3: Catalog Browser

**Catalog Browser** is available in the sidebar under **Configure**. It is the central place for browsing catalog-discovered datasets and managing which tables are connected for monitoring in Telmai.

<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-f6836d9872ab85a6cae631f62a710e3b009ce916%2FScreenshot%202026-06-23%20at%204.06.00%20PM.png?alt=media" alt="Catalog Browser"><figcaption><p>The Catalog Browser, with catalog connections on the left and discovered sources on the right.</p></figcaption></figure>

### Catalog Connections

The left panel lists your Telmai data connections and their catalog link status:

* **Connected** — the Telmai connection is linked to a catalog source. Telmai maps catalog metadata to assets from this connection.
* **Not Connected** — the Telmai connection has not yet been linked to a catalog source.

Use the link icon next to each connection to associate it with the corresponding catalog source.

### All Sources

The right panel shows all tables discovered from the catalog. Tables are grouped into two sections:

* **Connected tables** — already linked to Telmai assets
* **Non connected tables** — discovered from the catalog but not yet monitored in Telmai

Each table shows the following columns:

| Column               | Description                                                             |
| -------------------- | ----------------------------------------------------------------------- |
| Score                | Current data quality score for the table                                |
| Details              | Number of columns                                                       |
| Last changed         | When the table was last updated in the catalog                          |
| Why it's recommended | AI-generated explanation of why Telmai recommends monitoring this table |

***

## Intelligent Recommendations

Telmai uses catalog metadata to prioritize which tables most need monitoring. The **Why it's recommended** column in the Catalog Browser surfaces this reasoning for each table, drawing on:

* Tier classification (e.g., Tier 1 critical data elements)
* Presence of sensitive or PII data
* Financial or business-critical context from the catalog
* Stewardship completeness

Select any table in the Catalog Browser to open its **Catalog Details**, which shows the dataset's catalog metadata, the full AI recommendation with its reasoning and priority, connection status, and suggested timestamp columns.

<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-407658dbc8ec22c764d8502471395af3e29b6e2b%2FScreenshot%202026-07-03%20at%203.55.00%20PM.png?alt=media" alt="Catalog Details Overview tab showing metadata, AI recommendation with CRITICAL priority, connection status, and load strategy"><figcaption><p>The Catalog Details view, with the AI recommendation and its reasoning for a Tier 1 dataset.</p></figcaption></figure>

***

Metadata syncs on the interval configured in **Administration > Catalog**. Use **Sync Now** to trigger an immediate sync at any time.

***

## Writing Results Back to Actian Data Intelligence

Telmai can publish its data quality results into Actian Data Intelligence, so that catalog users see current quality alongside the rest of a dataset's governance context without leaving the catalog.

### What Telmai writes

| Result             | Description                                                                                               |
| ------------------ | --------------------------------------------------------------------------------------------------------- |
| Data quality score | The asset's current [Data Quality Score](/telmai/monitoring-data/data-quality-score.md)                   |
| Incident details   | Open [incidents](/telmai/monitoring-data/incident-portal.md) raised against the asset, with their details |

Results are written into the **native data quality section** of the corresponding dataset in Actian Data Intelligence.

### Enabling write-back

Write-back is enabled on the catalog configuration page. In **Administration > Catalog**, select the **Push results to catalog** checkbox and save the connection.

{% hint style="info" %}
No additional API key permission is required. The **scanner** permission created in [Step 1](#step-1-create-an-api-key-in-actian-data-intelligence) is sufficient for both reading metadata and writing results back.
{% endhint %}

### When results are published

Telmai publishes results **on scan completion** — each time a monitor scan finishes for a linked asset, its score and incident details are pushed to the catalog. This is independent of the metadata **Sync Interval**, which controls only how often Telmai reads from the catalog.

{% hint style="info" %}
Only assets linked to a catalog dataset in the [Catalog Browser](#step-3-catalog-browser) are written back. Connect the asset first, or there is no catalog dataset for Telmai to publish to.
{% endhint %}

***

## Business-Aware Rule Generation

When suggesting monitoring rules, Telmai uses the business definitions from the Actian Data Intelligence catalog glossary rather than relying on technical column names alone, making suggestions easier to evaluate and accept.

***

## Lineage Visualization

{% hint style="info" %}
Lineage visualization is coming soon. When available, Telmai will display upstream and downstream data dependencies sourced from Actian Data Intelligence lineage data, giving you context for how quality issues propagate through your data pipelines.
{% endhint %}