Skip to content
M↓ View as Markdown ↗

Actian Data Intelligence Platform

The Actian Data Intelligence Platform is Actian's data catalog. Connect it and the business terms your data team maintains there flow into your Glossary, so your AI Analysts answer with your organization's terminology.

Availability

  • Who can do this: members with the Edit capability in the active Workspace. If your organization turned on Restrict connection management, only Admins (members with the Manage organization capability) can add, edit or sync catalog connections. Other members see the connection fields, Save and Sync now disabled, with the message Data connections are managed by your organization's Admins.
  • Deployment: Actian SaaS and self-managed deployments. AI Analyst must be able to reach your catalog's base URL.

What gets synced

Each sync imports, for every business term in the catalog:

  • Glossary term: the term's name and definition. Rich-text descriptions are converted to plain text.
  • Synonyms: the term's alternative names.
  • Source link: a link back to the term in the catalog.

Hierarchies, item-type metadata and links to physical data assets are not imported. Nothing is written back to the catalog.

The connection belongs to your whole organization. Synced terms appear in the Glossary of every Workspace after the next scheduled sync, or right away in your current Workspace when you click Sync now. Each AI Analyst uses them according to its own glossary settings.

Prerequisites

You need:

  • A running Actian Data Intelligence Platform tenant.
  • The base URL of your catalog tenant, including the protocol (for example https://your-tenant.zeenea.app).
  • An API secret (the X-API-SECRET value) created in the Actian Data Intelligence Platform, that can read business glossary items.

Set up the connection

  1. In Studio, open Connections.
  2. Click + (Add connection).

  3. In the Catalog section, select Actian Data Intelligence.

  4. Fill in the New catalog connection form:

    Field Description
    Name A name for this connection, for example Production catalog. Names must be unique.
    Base URL Your catalog tenant's URL, including https://.
    API secret The X-API-SECRET value from the catalog. It's stored encrypted and never shown again after you save, so keep a copy in your secrets manager.

  5. Click Save connection. The button is available once all three fields are filled in.

The connection's detail page opens. To check that the connection works, click Sync now and review the Sync history tab.

The connection's detail page

The detail page has two tabs and a Sync now button in the header.

  • Overview: the Connection summary (Name, Base URL, Type, API secret shown as Stored or Not configured, and Created) and the API credentials section.
  • Sync history: the list of sync runs. See Sync history.

When syncs run

AI Analyst syncs every catalog connection automatically, into every Workspace, on a schedule set for your deployment. The default is once an hour. There's no schedule setting in the app.

To sync right away:

  1. Open the catalog connection under Connections.
  2. Click Sync now in the page header.

Sync now updates the Glossary of your current Workspace only. When the sync finishes, you see a message such as Sync complete — 3 created, 12 updated.

  • Sync now is unavailable until an API secret is saved. The page says Add an API secret below and save before syncing.
  • If a sync for this connection is already waiting to run, you see A sync for this connection is already queued.
  • Syncs are skipped while your organization's trial has ended, is on hold or is being closed.

How synced terms behave

In the Glossary, synced terms carry a Catalog source. You can filter the Glossary by Source to show only Manual or Catalog terms.

  • The catalog is the source of truth. Each sync overwrites the name, definition and synonyms of synced terms with the catalog's values. Make changes to these fields in the catalog, not in AI Analyst.
  • Matching names are taken over. If you created a term by hand with the same name as a catalog term, the sync takes it over and replaces its definition and synonyms with the catalog's values.
  • Deleted terms come back. If you delete a synced term in AI Analyst while it still exists in the catalog, the next sync restores it.

Terms removed from the catalog

When a term is no longer in the catalog, the next sync keeps it in your Glossary and marks it Orphaned. It's never deleted automatically. Delete it from the Glossary if you no longer need it. If the term comes back in the catalog, the next sync marks it Synced again.

Sync history

The Sync history tab lists the sync runs for this connection, newest first. It covers all Workspaces: a scheduled sync records one run per Workspace, and the list doesn't say which Workspace a run was for.

Column Shows
Status Running, Success or Failed
Started When the run started
Created Number of new terms added
Updated Number of existing terms updated
Orphaned Number of terms marked Orphaned because they left the catalog
Error The error message, if the run failed

If a scheduled sync can't reach the catalog at all, no run is recorded. A Sync now that fails is recorded as Failed with its error. So if terms stop updating and no new runs appear, click Sync now to see the error, then check the base URL, the API secret, and that AI Analyst can reach the catalog.

Edit the connection

Rename the connection or change its URL

  1. Open the connection's Overview tab.
  2. Edit Name or Base URL.
  3. Click Save.

If you leave the page with unsaved changes, AI Analyst asks whether to discard them.

Replace the API secret

If your API secret changes:

  1. On the Overview tab, under API credentials, enter the new secret in Replace API secret.
  2. Click Save.

Leave the field empty to keep the stored secret.

Remove the connection

AI Analyst doesn't currently let you delete a catalog connection.