ALTER CATALOG

  • Article

S’applique à :coche marquée oui Databricks SQL coche marquée oui Databricks Runtime 10.4 LTS et versions ultérieures oui coché 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 à :coche marquée oui Databricks SQL coche marquée oui 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 à :coche marquée oui Databricks SQL oui coché 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 à :coche marquée oui Databricks SQL oui coché 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 à :coche marquée oui Databricks SQL case marquée oui Databricks Runtime 12.2 LTS et versions ultérieures

    Important

    Cette fonctionnalité est disponible en préversion publique.

    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)