Skip to main content

Asset Pages

All Tiers

Every data asset catalogued in Calabi Catalogue has a dedicated asset page — a single place to understand a table, dashboard, pipeline, or topic in full detail. Asset pages aggregate schema information, data quality results, lineage graphs, usage statistics, and collaborative annotations in one view.


Anatomy of a Table Asset Page

┌────────────────────────────────────────────────────────────────────┐
│ [Icon] psychometric_reporting.scores [ Follow] │
│ Redshift Production • Gold tier • Owner: Analytics Team │
│ "Stores all exam attempt results, one row per attempt..." │
│ │
│ [Schema] [Sample Data] [Lineage] [Quality] [Activity] [Custom] │
├────────────────────────────────────────────────────────────────────┤
│ OVERVIEW │
│ Tier: Gold Last updated: 2026-04-05 Rows: 18.4M │
│ Domain: Exams Tags: exam-core, finance │
│ │
│ Owners: Jane Smith • Analytics Engineering │
└────────────────────────────────────────────────────────────────────┘

Tab Reference

Schema Tab

The Schema tab lists every column in the table with its metadata:

ColumnWhat it shows
NameColumn name as it appears in the database
Data typeVARCHAR, INTEGER, TIMESTAMP, BOOLEAN, etc.
DescriptionHuman-written explanation of the column's contents
TagsClassification tags applied to this column (e.g., PII, computed)
Glossary termLinked business glossary terms
ConstraintPRIMARY KEY, NOT NULL, FOREIGN KEY if detected
Profiling statsNull %, distinct count, min/max (if profiling has run)

Click any column name to expand its detail panel, showing full description, linked glossary terms, data quality test results, and change history.

Sample Data Tab

Shows a preview of up to 50 rows from the table (respects your data permissions — you see only rows you are authorized to access).

  • Use the Refresh button to fetch a fresh sample.
  • Click a cell value to copy it to clipboard.
  • PII-tagged columns are automatically masked (***) unless you hold a role with PII access.

Lineage Tab

The Lineage tab displays an interactive graph of upstream and downstream dependencies.

Lineage controlFunction
Expand upstreamShow all tables that feed into this asset
Expand downstreamShow all assets built from this table
Column-level lineageTrace a specific column through transformations (Professional+)
Time travelView lineage as it existed at a past date

Quality Tab

Shows all data quality test results associated with this table.

ColumnMeaning
Test namee.g., not_null:candidate_id, unique:attempt_id
StatusPass / Fail / Skipped
Last runWhen the test was last executed
Failure detailsFor failing tests, the count or sample of failing rows

See Data Quality Tests for the full guide.

Activity Tab

The Activity tab is the asset's collaboration feed. It shows:

  • Description edits — who changed the description and when.
  • Tag changes — tags added or removed.
  • Owner changes — ownership transfers.
  • Conversation threads — @mention discussions.
  • Test result events — quality tests that newly passed or failed.

Posting a comment

  1. Click the Activity tab.
  2. Type in the comment box at the bottom.
  3. Use @username to mention a teammate.
  4. Click Post.

Following an asset

Click Follow (star icon, top-right of the asset page) to receive notifications when the asset's metadata changes, test results update, or new comments are posted.


Editing Descriptions

Clear, accurate descriptions are the foundation of a healthy data catalogue.

Editing the table description

  1. Click the description text (or the Edit pencil icon next to it).
  2. The description editor opens — it supports Markdown.
  3. Write or update the description.
  4. Click Save.

Good description structure:

## Purpose
Stores all exam attempt records submitted through the Calabi platform.
One row per attempt. Voided and practice attempts are excluded.

## Key columns
- `attempt_id` — unique identifier for this attempt (UUID)
- `candidate_id` — foreign key to `dim.candidates`
- `passed` — boolean; TRUE if the candidate met the passing threshold

## Notes
- Populated by the `score_loader` Calabi Pipeline (runs every 15 minutes)
- Upstream source: Exam Platform API → Calabi Connect → S3 → Redshift

Editing a column description

  1. Click the column name in the Schema tab.
  2. Click the Edit icon next to the description field.
  3. Enter the description and click Save.

Adding and Changing Owners

Owners are accountable for an asset's accuracy and documentation.

Adding an owner

  1. On the asset page, click + Add owner (or click the existing owner badge).
  2. Search by name or email.
  3. Select the user or team.
  4. Click Save.

An asset can have multiple owners — both individual users and teams.

Owner responsibilities

ResponsibilityDescription
Keep descriptions up to dateWhen schema changes, update column descriptions
Respond to commentsAnswer @mention questions within a reasonable SLA
Manage tagsEnsure PII and classification tags are current
Monitor quality testsInvestigate and resolve test failures
Certify the assetMark as Gold tier when the asset meets quality standards

Applying Tags

Tags are searchable labels that classify assets. See Tags & Classification for the full tagging guide.

To add a tag quickly from an asset page:

  1. Click + Add tag in the tags section (below the description).
  2. Search for existing tags or create a new one.
  3. Select and click Save.

Tier Badges

Tier reflects the asset's quality and reliability:

BadgeMeaningWho can set
GoldCertified, production-gradeAdmin, Data Steward
SilverGenerally reliable, mostly documentedOwner, Data Steward
BronzeExperimental or in-progressAny user

To set or change the tier:

  1. Click the tier badge (or the Edit pencil next to it).
  2. Select the appropriate tier.
  3. Click Save.

Asset Actions

ActionHow to accessWho can perform
Edit descriptionClick description textOwner, Steward, Admin
Edit column descriptionsSchema tab → click columnOwner, Steward, Admin
Add / remove ownersOwner section → + AddOwner, Admin
Add / remove tagsTags section → + Add tagAny user
Set tierTier badge → EditOwner, Steward, Admin
Follow assetStar icon (top-right)Any user
Post commentActivity tab → comment boxAny user
Add to glossary termSchema tab → column → GlossarySteward, Admin
View lineageLineage tabAny user
Run quality testQuality tab → RunOwner, Admin
Export schema as CSVSchema tab → ··· → ExportAny user

Asset Versions

The Catalogue automatically versions asset metadata. When any field changes (description, tags, owners, tier), the previous version is stored.

To view version history:

  1. Click ··· (more menu, top-right of the asset page).
  2. Select Version history.
  3. Browse past versions and their diffs.

You can restore any previous version by clicking Restore on that version entry.