DESCRIBE TAG

Shows detailed information about a tag definition and its assignments.

Category: catalogDeltaForge extension

Syntax

DESCRIBE TAG <name>

Description

## Overview Returns detailed metadata for a single tag definition, including its name, description, category, allowed values, propagation setting, and current assignments. This command is the primary way to inspect a tag before modifying or assigning it. ## Behavior - Returns a result set with columns: name, description, category, allowed_values, propagate, and assignment details. - If the named tag does not exist, the command returns an error. - The command routes through the control plane catalog API. A valid catalog router connection is required. - The result includes all current assignments (which tables, views, or columns carry this tag and with what values), providing a single view of the tag's usage. ## Compatibility DESCRIBE TAG is a DeltaForge extension. It is analogous to DESCRIBE commands in standard SQL but targets tag definitions rather than table schemas.

Examples

-- View full details of a PII classification tag
DESCRIBE TAG pii_type;
-- Inspect an environment tag to see its allowed values
DESCRIBE TAG environment;
-- Check propagation settings for a sensitivity tag
DESCRIBE TAG sensitivity;

Pitfalls

See Also

Open in interactive docs →   DeltaForge home →