Glossaries

Link terms to schema objects

A definition is most useful when you can see where the concept lives in your data. Related entities connect a glossary term to schema objects, so a reader of the term can jump straight to the customer table or the net_revenue column behind it.

In the app: Business Context › Glossaries › your glossary › your term › RELATED ENTITIES

Before you start

  • The objects must already exist in one of your organization’s schemas. See Create a schema or import one.
  • Your organization must not be in read-only mode.

You can link a term to these object types from any schema in your organization:

  • Tables and columns
  • Views and materialized views
  • Stored procedures
  • Scalar, table-valued, and inline table functions

One term can link to many objects, and one object can be linked from many terms.

  1. Open the term.
  2. In the RELATED ENTITIES section, click + (tooltip: Link a data asset).
  3. In Search Data Assets, type part of the object’s name. Kenseme searches names and display names across all your schemas. For columns, it also searches the column’s governance name.
  4. Click the result you want. Each result shows its type, its name, and its schema. Columns show as Table.Column.
  5. Check the Selected: line, then click Add.

The object appears in RELATED ENTITIES with a type badge, its name, and the schema it belongs to.

[screenshot]
The Add Related Entity dialog with search results of mixed types and one column selected.

Note: Search shows up to 20 matches of each kind. If you don’t see the object you want, type more of its name.

Open a linked object

Click the object’s name in RELATED ENTITIES to open its detail page in the schema. Hover over it to see the schema name.

Note: The link shows on the term page only. A table’s or column’s own page doesn’t list the glossary terms that point to it. To record something about the object itself, use a custom attribute on the object.

  1. Click x beside the object in RELATED ENTITIES.
  2. Confirm Remove Data Asset.

Removing a link doesn’t delete the term or the schema object. If the object itself is deleted from its schema, it drops out of the term’s list.

  • Glossary exports in JSON include each term’s related entities. CSV exports don’t. See Import and export a glossary.
  • A JSON import re-creates related entities when it can find the named objects in your schemas.