SET SORGULAMA_ETİKETLERİ

Şunlar için geçerlidir:onay işareti evet olarak işaretlenmiş Databricks SQL

Önemli

Bu özellik Genel Önizleme aşamasındadır.

Geçerli oturum için sorgu etiketlerini ayarlar, okur veya kaldırır.

Sorgu etiketleri, tabloda gruplandırma, filtreleme ve maliyet atfını system.query.history etkinleştirmek için SQL iş yüklerine uygulayabileceğiniz özel anahtar-değer çiftleridir. Sorgu etiketlerine tam bir genel bakış için bkz. Sorgu etiketleri.

Sözdizimi

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

Parametreler

  • tag_key

    Dize sabiti. Baştaki ve sondaki boşluk kırpılır.

  • tag_value

    Dize değişmez değeri, NULL, veya UNSET.

    • Baştaki ve sondaki boşluk kaldırılır.
    • Kırpılan sonuç boş bir dizeyse, (yalnızca anahtar etiketi) olarak NULL kabul edilir.
    • UNSET belirtilen anahtarı sorgu etiketlerinden kaldırır.

Yaygın hata koşulları

Örnekler

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

Ek kaynaklar

  • Last updated on