SET ETİKET

Şunlar için geçerlidir:evet olarak işaretlendi Databricks SQL evet olarak işaretlendi Databricks Runtime 16.1 ve üzeri

Katalog, şema, tablo, görünüm, birim, sütun, işlev veya dış meta veri nesnesinde bir etiket ayarlar.

Important

Dış meta veri nesnelerinde etiketlerin ayarlanması Genel Önizleme aşamasındadır ve Databricks Runtime 18.2 veya üzerini gerektirir.

Unity Kataloğu güvenli hale getirilebilir nesnelere etiket eklemek için nesnenin sahibi olmanız veya aşağıdaki ayrıcalıkların tümüne sahip olmanız gerekir:

  • APPLY TAG nesnesinde
  • USE SCHEMA nesnenin ebeveyn şemasında
  • USE CATALOG nesnenin üst kataloğunda

Dış meta veri nesneleri bir katalogda veya şemada USE CATALOGUSE SCHEMA yer almadığından uygulanmaz.

Etiket yönetiliyorsa, ASSIGN ihtiyacınız vardır

Sözdizimi

SET TAG ON
    { CATALOG catalog_name |
      COLUMN relation_name . column_name |
      EXTERNAL METADATA external_metadata_name |
      { FUNCTION | PROCEDURE } function_name |
      { SCHEMA | DATABASE } schema_name |
      TABLE relation_name |
      VIEW  relation_name |
      VOLUME volume_name }
    tag_key [ = tag_value ]

Parametreler

  • CATALOG Catalog_name

    Etiketlenecek kataloğun adı.

  • COLUMN relation_name . sütun_adı

    Etiketli sütunun tam adı. relation_name bir görünümü veya tabloyu tanımlaması gerekir. relation_name bir zamansal belirtim veyaseçenek belirtimi içermemelidir.

  • DıŞ META VERILER external_metadata_name

    Etiketli dış meta veri nesnesinin adı.

  • { FUNCTION | PROCEDURE } function_name

    Etiket için işlevin veya yordamın adı. FUNCTION ve PROCEDURE birbirinin yerine kullanılabilir.

    Uyarı

    İşlevleri ve yordamları etiketlemek için Databricks Runtime 18.1 veya üzeri gerekir.

  • SCHEMA Schema_name

    Etiketlenecek şemanın adı.

  • TABLE relation_name

    Etiketlenmek üzere tablonun veya görünümün adı. Ad bir zamansal belirtim veya seçenek belirtimi içermemelidir.

  • GÖRÜNÜM relation_name

    Etiketlenecek görünümün adı.

  • VOLUME volume_name

    Etiketlenecek hacmin adı.

  • tag_key

    Tanımlayıcı. Aynı anahtara sahip bir etiket ataması zaten varsa ve özel durum oluşursa.

  • tag_value

    İsteğe bağlı bir tanımlayıcı. Belirtilmezse, etiket ataması sadece anahtar olarak ayarlanacaktır.

Örnekler

> SET TAG ON CATALOG catalog `cost_center` = `hr`;

> UNSET TAG ON CATALOG catalog cost_center;

> SET TAG ON TABLE catalog.schema.table cost_center = hr;

> UNSET TAG ON TABLE catalog.schema.table cost_center;

> SET TAG ON COLUMN table.ssn pii;

> UNSET TAG ON COLUMN table.ssn pii;

> SET TAG ON FUNCTION catalog.schema.my_func cost_center = hr;

> UNSET TAG ON FUNCTION catalog.schema.my_func cost_center;

> SELECT catalog_name, schema_name, table_name, tag_name, tag_value
    FROM information_schema.column_tags
    WHERE tag_name = 'pii' AND schema_name = 'default';
  table_name column_name
  ---------- -----------
  table      ssn