Partager via

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 ou une colonne.

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

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 |
      { 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.

  • 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;

> SELECT table_name, column_name FROM information_schema.column_tags
    WHERE tag_name = 'pii' AND schema_name = 'default';
  table_name column_name
  ---------- -----------
  table      ssn
  • Last updated on