metadata-ingestion/docs/sources/omni/omni_post.md
Use the Important Capabilities table above as the source of truth for supported features and whether additional configuration is required.
Omni Views reference physical warehouse tables via sql_table_name in model YAML. The connector resolves each reference to a DataHub dataset URN using the connection_to_platform mapping. If normalize_snowflake_names: true (default), database, schema, and table name components are uppercased to match the casing used by the DataHub Snowflake connector.
When include_column_lineage: true (default), the connector emits FineGrainedLineage entries by parsing sql expressions in model YAML and matching field references to known view columns. This enables precise field-level impact analysis across the full chain:
physical_table.column → semantic_view.field → dashboard_tile.field
For each Omni Semantic View, the connector emits a SchemaMetadata aspect containing one SchemaField per dimension and measure defined in model YAML:
NUMBERdescription attribute when presentUse model_pattern and document_pattern to restrict ingestion to specific models or dashboards:
model_pattern:
allow:
- "^prod-.*"
deny:
- ".*-dev$"
document_pattern:
allow:
- ".*"
sql expressions; complex or fully derived expressions may not fully resolve.max_requests_per_minute accordingly.If ingestion fails, validate credentials, permissions, and connectivity first. Then review the ingestion report and logs for source-specific errors.
Common issues:
| Symptom | Likely Cause | Resolution |
|---|---|---|
403 Forbidden on /v1/connections | API key lacks connection read scope | Ingestion continues with config fallbacks; physical lineage may be incomplete |
| Physical tables not linked to warehouse entities | connection_to_platform not configured | Add connection mapping for each Omni connection ID |
| Snowflake URN mismatch | Case mismatch between Omni and DataHub Snowflake URNs | Ensure normalize_snowflake_names: true (default) |
| Column lineage empty | View YAML has no sql expressions | Expected for views using direct sql_table_name without field-level SQL |