ANNULER BALISE

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

Supprime une balise d’un catalogue, d’un schéma, d’une table, d’une vue, d’un volume, d’une colonne, d’une fonction ou d’un objet de métadonnées externe.

Important

La suppression de balises d’objets de métadonnées externes est disponible en préversion publique et nécessite Databricks Runtime 18.2 ou version ultérieure.

Pour supprimer des balises des objets sécurisables du catalogue Unity, vous devez posséder 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.

Syntaxe

UNSET 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

Paramètres

  • CATALOG catalog_name

    Nom du catalogue à partir duquel supprimer la balise.

  • COLUMN relation_name . nom_de_colonne

    Nom qualifié de la colonne à partir de laquelle supprimer la balise. 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 à partir duquel supprimer la balise.

  • { FUNCTION | PROCEDURE } function_name

    Nom de la fonction ou de la procédure à partir de laquelle supprimer la balise.

  • SCHEMA schema_name

    Nom du schéma à partir duquel supprimer la balise.

  • TABLE relation_name

    Nom de la table ou vue à partir de laquelle supprimer la balise. Le nom ne doit pas inclure de spécification temporelle ou de spécification d’options.

  • AFFICHER relation_name

    Nom de la vue à partir de laquelle supprimer la balise.

  • VOLUME volume_name

    Nom du volume à partir duquel supprimer la balise.

  • tag_key

    Identificateur. Si la balise est introuvable, une exception est levée.

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;