¶ Semantics Registry Overview
¶ What is Semantics Registry
The Semantics Registry (also known as Business Glossary) is a centralized repository of standardized business terms and definitions used across your organization. It provides:
- Standardized Terminology: Consistent definitions for business terms
- Data Discovery: Help users find data products through semantic search
- Data Understanding: Clear descriptions of what data means
- Cross-Linking: Connect related data products sharing same semantics
Key Benefits:
- Improved data literacy across the organization
- Reduced ambiguity in data definitions
- Enhanced data discoverability
- Better data governance compliance
¶ What is Semantics Collection, Semantics and Semantics Attributes
¶ Semantics Collection (Category)
A Semantics Collection is a logical grouping of related semantic terms. Think of it as a folder or category that organizes terms by domain or subject area.
Examples:
- Customer Data
- Financial Metrics
- Product Information
- Operational Data
Structure:
Semantics Collection
├── Name (e.g., "Customer Data")
├── Description
├── Owner
├── Contributors
└── Terms (multiple)
¶ Semantics (Terms)
A Semantic (or Term) is an individual business term with its definition, context, and metadata.
Term Components:
- Name: The business term (e.g., "Customer Lifetime Value")
- Definition: Clear, unambiguous description
- Snippet: Brief summary for quick reference
- Status: DRAFT or PUBLISHED
- Sensitive: Flag for PII or confidential data
- Owner: Responsible person
- Category: Parent collection
- Synonyms: Alternative names
- Tags: Keywords for discovery
- Related Fields: Linked data product fields
¶ Semantics Attributes
Key attributes of a semantic term:
| Attribute | Description | Example |
|---|---|---|
| Name | Official business term | "Annual Recurring Revenue" |
| Definition | Detailed explanation | "Total value of recurring revenue..." |
| Snippet | Short description | "Yearly subscription revenue" |
| Status | Publication state | DRAFT, PUBLISHED |
| Sensitive | Contains PII/confidential | true/false |
| Owner | Responsible person | john.doe@company.com |
| Category | Parent collection | "Financial Metrics" |
| Synonyms | Alternative names | ["ARR", "Yearly MRR"] |
| Tags | Discovery keywords | ["finance", "revenue", "metrics"] |
¶ Next Steps
- Create Semantic Collections - Learn how to organize terms into categories
- Create Semantic Terms - Add new business terms to the glossary
- Manage Tags & Synonyms - Improve discoverability