SET LABEL

Van toepassing op:aangevinkt als ja Databricks SQL aangevinkt als ja Databricks Runtime 16.1 en hoger

Hiermee stelt u een tag in voor een catalogus, schema, tabel, weergave, volume, kolom, functie of extern metagegevensobject.

Important

Het instellen van tags voor externe metagegevensobjecten bevindt zich in openbare preview en vereist Databricks Runtime 18.2 of hoger.

Als u tags wilt toevoegen aan beveiligbare objecten van Unity Catalog, moet u eigenaar zijn van het object of alle volgende bevoegdheden hebben:

  • APPLY TAG op het object
  • USE SCHEMA in het bovenliggende schema van het object
  • USE CATALOG in de bovenliggende catalogus van het object

Externe metagegevensobjecten zijn niet opgenomen in een catalogus of schema, dus USE CATALOG niet USE SCHEMA van toepassing.

Als de tag wordt beheerd, hebt u ook toestemming nodig ASSIGN voor de beheerde tag

Syntaxis

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 ]

Parameterwaarden

  • CATALOG catalog_name

    De naam van de catalogus die moet worden gelabeld.

  • COLUMN relation_name . column_name

    De gekwalificeerde naam van de kolom die moet worden gelabeld. relation_name moet een weergave of tabel identificeren. De relation_name mag geen specificatie voor tijd of opties bevatten.

  • EXTERNE METAGEGEVENS external_metadata_name

    De naam van het externe metagegevensobject dat moet worden gelabeld.

  • { FUNCTION | PROCEDURE } function_name

    De naam van de functie of procedure die moet worden gelabeld. FUNCTION en PROCEDURE zijn uitwisselbaar.

  • SCHEMA schema_name

    De naam van het schema dat moet worden gelabeld.

  • TABLE relation_name

    De naam van de tabel of weergave die u wilt taggen. De naam mag geen tijdelijke specificatie of optiesspecificatie bevatten.

  • WEERGAVE relation_name

    De naam van de weergave die getagd moet worden.

  • VOLUME-volume_name

    De naam van het volume dat moet worden gelabeld.

  • tag_key

    Een id. Als er al een tagtoewijzing met dezelfde sleutel bestaat en er een uitzondering wordt gegenereerd.

  • tag_value

    Een optionele id. Als een specificatie ontbreekt, wordt de tagtoewijzing ingesteld op alleen voor de sleutel.

Voorbeelden

> 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