ALTER CATALOG

S’applique à : Databricks SQL Databricks Runtime 10.4 LTS et versions ultérieures Unity Catalog uniquement

Transfère la propriété d’un catalogue à un nouveau principal, applique des balises à un catalogue, ou active ou désactive l’optimisation prédictive pour un catalogue.

Syntaxe

ALTER CATALOG [ catalog_name ]
 { [ SET ] OWNER TO principal
   SET TAGS ( { tag_name = tag_value } [, ...] ) |
   UNSET TAGS ( tag_name [, ...] ) |
   { ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION }

Paramètres

• catalog_name

  Nom du catalogue à modifier. Si vous ne spécifiez pas de nom, la valeur par défaut est hive_metastore .

• [ SET ] PROPRIÉTAIRE DU principal

  Transfère la propriété du catalogue vers principal.

  S’applique à : Databricks SQL Databricks Runtime 11.3 LTS et versions ultérieures

  SET est autorisé en tant que mot clé facultatif.

• SET TAGS ( { tag_name = tag_value } [, …] )

  Appliquer des balises au catalogue. Vous devez avoir l’autorisation use_catalog pour appliquer une balise à un catalogue. Veuillez consulter UTILISER LE CATALOGUE.

  S’applique à : Databricks SQL Databricks Runtime 13.3 LTS et versions ultérieures

• UNSET TAGS ( tag_name [, ...] )

  Supprimer des balises du catalogue. Vous devez avoir l’autorisation use_catalog pour appliquer une balise à un catalogue.

  S’applique à : Databricks SQL Databricks Runtime 13.3 LTS et versions ultérieures

• tag_name

  Un STRING littéral. Le tag_name doit être unique dans le catalogue.

• tag_value

  Un STRING littéral.

• { ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION

  S’applique à : Databricks SQL Databricks Runtime 12.2 LTS et versions ultérieures

  Modifie le catalogue au paramètre d’optimisation prédictive souhaité. Par défaut, lorsque des catalogues sont créés, le comportement consiste à INHERIT à partir du compte. Par défaut, les nouveaux objets créés dans le catalogue héritent du paramètre du catalogue.

  Si le catalogue est modifié, le comportement se propage en cascade à tous les schémas et leurs objets, qui héritent de l’optimisation prédictive. Les objets dans les schémas qui n’héritent pas de l’optimisation prédictive ou des objets qui ENABLE ou DISABLE explicitement l’optimisation prédictive ne sont pas affectés par le paramètre de catalogue.

  Pour définir l’optimisation prédictive d’un catalogue, l’utilisateur doit avoir l’autorisation CREATE sur le catalogue.

  Seuls les catalogues managés non-Delta Sharing dans Unity Catalog sont éligibles à l’optimisation prédictive.

Exemples

-- Creates a catalog named `some_cat`.
> CREATE CATALOG some_cat;

-- Transfer ownership of the catalog to another user
> ALTER CATALOG some_cat OWNER TO `alf@melmak.et`;

-- Applies three tags to the catalog named `test`.
> ALTER CATALOG test SET TAGS ('tag1' = 'val1', 'tag2' = 'val2', 'tag3' = 'val3');

-- Removes three tags from the catalog named `test`.
> ALTER CATALOG test UNSET TAGS ('tag1', 'tag2', 'tag3');

–– Enables predictive optimization for catalog main
> ALTER CATALOG main ENABLE PREDICTIVE OPTIMIZATION;
> DESCRIBE CATALOG EXTENDED main;
  Key                        value
  ------------------------    ---------
  < other rows of describe extended >
  Predictive Optimization    ENABLE

-- Sets catalog main to inherit setting from parent object (metastore)
> ALTER CATALOG main INHERIT PREDICTIVE OPTIMIZATION;
> DESCRIBE CATALOG EXTENDED main;
  Key                         value
  ------------------------    ----------------------------------------
  < other rows of describe extended >
  Predictive Optimization     ENABLE (inherited from METASTORE metastore_name)

Articles connexes

• CRÉER UN CATALOGUE
• DESCRIBE CATALOG
• DROP CATALOG
• SHOW CATALOGS