SET ZNAČKA

platí pro:označeno jako ano Databricks SQL zaškrtnuto ano Databricks Runtime 16.1 a vyšší

Nastaví značku v katalogu, schématu, tabulce, zobrazení, svazku, sloupci, funkci nebo objektu externích metadat.

Důležité

Nastavení značek u externích objektů metadat je ve verzi Public Preview a vyžaduje Databricks Runtime 18.2 nebo vyšší.

Pokud chcete přidat značky do zabezpečitelných objektů katalogu Unity, musíte objekt vlastnit nebo mít všechna následující oprávnění:

  • APPLY TAG na objektu
  • USE SCHEMA na nadřazeném schématu objektu
  • USE CATALOG v nadřazeném katalogu objektu

Objekty externích metadat nejsou obsaženy v katalogu nebo schématu, takže USE CATALOGUSE SCHEMA se nevztahují.

Pokud se značka řídí, potřebujete ASSIGN také oprávnění k řízené značce.

Syntaxe

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 ]

Parametry

  • CATALOG catalog_name

    Název katalogu, který chcete označit.

  • COLUMN relation_name . column_name

    Kvalifikovaný název sloupce, který se má označit. relation_name musí identifikovat zobrazení nebo tabulku. relation_name nesmí obsahovat specifikaci času ani specifikaci možností.

  • EXTERNÍ METADATA external_metadata_name

    Název externího objektu metadat, který se má označit.

  • { FUNCTION | PROCEDURE } function_name

    Název funkce nebo procedury, která se má označit. FUNCTION a PROCEDURE jsou zaměnitelné.

    Poznámka:

    Funkce a postupy označování vyžadují Databricks Runtime 18.1 nebo vyšší.

  • SCHEMA Schema_name

    Název schématu, které se má označit.

  • TABLE relation_name

    Název tabulky nebo zobrazení, které chcete označit. Název nesmí obsahovat dočasnou specifikaci ani specifikaci možností.

  • ZOBRAZIT relation_name

    Název zobrazení, které chcete označit.

  • SVAZEK volume_name

    Název svazku, který se má označit.

  • tag_key

    Identifikátor. Pokud již existuje přiřazení značky se stejným klíčem, je vyvolána výjimka.

  • tag_value

    Volitelný identifikátor. Pokud není zadáno, přiřazení značky se nastaví jako pouze klíč.

Příklady

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