tags - Dimensions - Omni Docs

Tags can be referenced or searched in the workbook’s field browser within fields or drill_fields with the syntax tag:tag_name.

Syntax

<dimension_name>:
  tags: [<tag_1>, <tag_2>, ...]

Properties

object

The name of the dimension. Dimension names must:

Be unique within the view
Start with a letter
Contain only alphanumeric characters and underscores

Hide dimension_name properties

string[]

An unquoted list using [] and a comma-delimited list of tag values.If using Databricks Unity Catalog, schema refreshes automatically populate this parameter from the column’s Unity Catalog COLUMN_TAGS. A tag with a value renders as name: value, and a tag without a value renders as a bare name. This doesn’t apply to legacy hive_metastore catalogs, which don’t have Unity Catalog tag data. If you edit tags in the shared model, your changes are preserved on later refreshes.

Examples

PII tags

full_name:
  sql: CONCAT(${first_name}, ' ' ${last_name})
  tags: [pii, secure]

Finance tags

profit:
  sql: ${sales} - ${cost}
  tags: [finance, secure]

Databricks Unity Catalog tag with a value

full_name:
  tags: [ "pii: A"]

Databricks Unity Catalog tag without a value

full_name:
  tags: [ pii ]

Getting started

Manage content

Analyze & build

Visualize & present

Deliver content

Model data

Manage integrations

tags - Dimensions

Syntax

Properties

Examples

​Syntax

​Properties

​Examples

Syntax

Properties

Examples