SET BALISE

S'applique à :coché Databricks SQL coché Databricks Runtime 16.1 et version ultérieure

Définit une balise sur un catalogue, un schéma, une table, une vue, un volume, une colonne, une fonction ou un objet de métadonnées externe.

Important

La définition d’étiquettes sur des objets de métadonnées externes est en préversion publique et nécessite Databricks Runtime 18.2 ou version ultérieure.

Pour ajouter des balises à des objets sécurisables du catalogue Unity, vous devez être propriétaire de l’objet ou disposer de tous les privilèges suivants :

  • APPLY TAG sur l’objet.
  • USE SCHEMA sur le schéma parent de l’objet
  • USE CATALOG sur le catalogue parent de l'objet

Les objets de métadonnées externes ne sont pas contenus dans un catalogue ou un schéma, de sorte qu’ils USE CATALOGUSE SCHEMA ne s’appliquent pas.

Si la balise est régie, vous avez également besoin ASSIGN d’une autorisation sur la balise régie

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 ]

Paramètres

  • CATALOG catalog_name

    Nom du catalogue sur lequel insérer les balises.

  • COLUMN relation_name . nom_de_colonne

    Nom complet de la colonne sur laquelle insérer les balises. relation_name doit identifier une vue ou une table. La relation_name ne doit pas inclure de spécification temporelle ou de spécification d’options.

  • EXTERNAL_METADATA_NAME DE MÉTADONNÉES EXTERNES

    Nom de l’objet de métadonnées externes à baliser.

  • { FUNCTION | PROCEDURE } function_name

    Nom de la fonction ou de la procédure à baliser. FUNCTION et PROCEDURE sont interchangeables.

  • SCHEMA schema_name

    Nom du schéma à baliser.

  • TABLE relation_name

    Nom de la table ou vue sur laquelle insérer les balises. Le nom ne doit pas inclure de spécification temporelle ou de spécification d’options.

  • AFFICHER relation_name

    Nom de l'affichage sur lequel insérer les balises.

  • VOLUME volume_name

    Nom du volume sur lequel insérer les balises.

  • tag_key

    Identificateur. Si une attribution de balise avec la même clé existe déjà et qu’une exception est déclenchée.

  • tag_value

    Identificateur facultatif. Si cette valeur n'est pas spécifiée, l'attribution de la balise sera définie en tant que clé uniquement.

Exemples

> 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