SET CÍMKE

A következőre vonatkozik:be van jelölve, igen Databricks SQL be van jelölve, igen Databricks Runtime 16.1 és újabb

Címke beállítása katalógusra, sémára, táblára, nézetre, kötetre, oszlopra, függvényre vagy külső metaadat-objektumra.

Important

A külső metaadat-objektumok címkéinek beállítása nyilvános előzetes verzióban történik, és a Databricks Runtime 18.2-s vagy újabb verziójára van szükség.

Ha címkéket szeretne hozzáadni a Unity Catalog biztonságos objektumaihoz, rendelkeznie kell az objektummal, vagy rendelkeznie kell az alábbi jogosultságokkal:

  • APPLY TAG az objektumon
  • USE SCHEMA az objektum szülősémáján
  • USE CATALOG az objektum szülőkatalógusában

A külső metaadat-objektumok nem találhatók katalógusban vagy sémában, ezért USE CATALOGUSE SCHEMA nem érvényesek.

Ha a címke szabályozva van, az ASSIGN is engedélyre van szüksége

Szemantika

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 ]

Paraméterek

  • CATALOG catalog_name

    A címkézni kívánt katalógus neve.

  • COLUMN relation_name . column_name

    A címkézni kívánt oszlop minősített neve. relation_name-nak egy nézetet vagy egy táblát kell azonosítania. A relation_name nem tartalmazhat időbeli specifikációt vagy beállítási specifikációt.

  • KÜLSŐ METAADATOK external_metadata_name

    A címkézendő külső metaadat-objektum neve.

  • { FUNCTION | PROCEDURE } function_name

    A címkézendő függvény vagy eljárás neve. FUNCTION és PROCEDURE felcserélhetők.

    Note

    A funkciók és eljárások címkézéséhez a Databricks Runtime 18.1 vagy újabb verziója szükséges.

  • SCHEMA schema_name

    A címkézni kívánt séma neve.

  • TABLE kapcsolat_név

    A címkézni kívánt tábla vagy nézet neve. A név nem tartalmazhat időbeli specifikációt vagy beállításspecifikációt.

  • MEGTEKINTÉSE relation_name

    A címkézni kívánt nézet neve.

  • KÖTET VOLUME_NAME

    A címkézni kívánt kötet neve.

  • tag_key

    Azonosító. Ha már létezik ugyanazzal a kulccsal rendelkező címke-hozzárendelés, akkor kivétel keletkezik.

  • tag_value

    Nem kötelező azonosító. Ha nincs megadva, a címke hozzárendelése a kulcsokra korlátozódik.

Példák

> 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