SET Abfrage-Tags

Gilt für:Grünes Häkchen für „Ja“ Databricks SQL

Legt Abfragetags für die aktuelle Sitzung fest, liest oder entfernt sie.

Abfragetags sind benutzerdefinierte Schlüsselwertpaare, die Sie auf SQL-Workloads anwenden können, um gruppieren, filtern und Kostenzuordnungen in der system.query.history Tabelle zu ermöglichen. Eine vollständige Übersicht über Abfragetags finden Sie unter Abfragetags.

Syntax

-- Set or update one or more query tags for the current session
SET QUERY_TAGS[<tag_key>] = <tag_value> [, ...]

-- Read the query tags defined on the session
SET QUERY_TAGS;

Parameter

  • tag_key

    Ein Zeichenfolgenliteral. Führende und nachfolgende Leerzeichen werden entfernt.

  • tag_value

    Ein Zeichenfolgenliteral, NULL oder UNSET.

    • Führende und nachfolgende Leerzeichen werden entfernt.
    • Wenn das gekürzte Ergebnis eine leere Zeichenfolge ist, wird es als NULL (nur Schlüsseltag) behandelt.
    • UNSET entfernt den angegebenen Schlüssel aus Abfragetags.

Häufige Fehlerbedingungen

Examples

-- Set two key-value pairs to annotate subsequent statement executions in this session.
> SET QUERY_TAGS['team'] = 'marketing', QUERY_TAGS['cost_center'] = '701';

-- Execute a query with the tags attached
> SELECT * FROM sales_data;

-- Update tags: change team value, add new tag, and remove cost_center tag
> SET QUERY_TAGS['team'] = 'engineering', QUERY_TAGS['env'] = 'prod', QUERY_TAGS['cost_center'] = UNSET;

-- Display all tags currently set on the session
> SET QUERY_TAGS;
  key         value
  ----------  -----------
  team        engineering
  env         prod

-- Set a key-only tag (value is NULL)
> SET QUERY_TAGS['experiment'] = NULL;

-- Execute another query with the updated tags
-- This statement execution will be tagged with team:engineering, env:prod, experiment
> SELECT * FROM sales_data;

Weitere Ressourcen

  • Zuletzt aktualisiert um