SET Dotazovací značky

Platí pro:označeno jako „ano“ Databricks SQL

Důležité

Tato funkce je ve verzi Public Preview.

Nastaví, přečte nebo odstraní dotazovací značky pro aktuální relaci.

Značky dotazů jsou vlastní páry klíč-hodnota, které můžete použít u úloh SQL pro umožnění seskupení, filtrování a přidělení nákladů v tabulce system.query.history. Úplný přehled značek dotazů najdete v tématu Značky dotazů.

Syntaxe

-- 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;

Parametry

  • tag_key

    Řetězcový literál. Počáteční a koncové prázdné znaky jsou odstraněny.

  • tag_value

    Řetězcový literál, NULL nebo UNSET.

    • Úvodní a koncové prázdné znaky se odeberou.
    • Pokud je oříznutý výsledek prázdný řetězec, je považován za NULL (pouze klíčová značka).
    • UNSET odebere zadaný klíč ze značek dotazu.

Běžné chybové podmínky

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;

Další zdroje informací

  • Last updated on