SET ТЕГИ_ЗАПРОСА

Область применения:отмечено «Да» Databricks SQL

Это важно

Эта функция доступна в общедоступной предварительной версии.

Задает, считывает или удаляет теги запросов для текущего сеанса.

Теги запросов — это пользовательские пары "ключ-значение", которые можно применить к рабочим нагрузкам SQL, чтобы включить групповку, фильтрацию и распределение затрат в таблице system.query.history. Полный обзор тегов запросов см. в разделе "Теги запросов".

Синтаксис

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

Параметры

  • tag_key

    Строковый литерал. Начальные и конечные пробелы обрезаются.

  • tag_value

    Строковый литерал, NULLили UNSET.

    • Начальные и конечные пробелы удаляются.
    • Если полученный результат является пустой строкой, он обрабатывается как NULL (только ключевой тег).
    • UNSET удаляет указанный ключ из тегов запросов.

Распространенные условия ошибки

Примеры

-- 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;
  • Last updated on