Partager via

ALTER CATALOG

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

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

Syntaxe

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

Parameters

  • catalog_name

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

  • COLLATION PAR DÉFAUT default_collation_name

    S’applique à :check marqué oui Databricks SQL vérifié marqué oui Databricks Runtime 17.1 et versions ultérieures

    Modifie le classement par défaut pour les nouveaux schémas définis dans le catalogue. Le classement par défaut des schémas et objets existants dans le catalogue n’est pas modifié.

  • [ SET ] PROPRIÉTAIRE À principal

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

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

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

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

    Applique des balises au catalogue. Vous devez avoir l’autorisation USE CATALOG pour appliquer une balise à un catalogue. Voir USE CATALOG.

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

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

    Supprime des balises du catalogue. Vous devez avoir l’autorisation USE CATALOG pour appliquer une balise à un catalogue.

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

  • tag_name

    Une STRING littérale. Le tag_name doit être unique au sein du catalogue.

  • tag_value

    Une STRING littérale.

  • { ENABLE | DISABLE | HÉRITER } OPTIMISATION PRÉDICTIVE

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

    Modifie le paramètre d’optimisation prédictive du catalogue. Par défaut, lors de la création d’un catalogue, le comportement consiste à INHERIT 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é, ce comportement se répercute sur 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 ceux qui ENABLE ou DISABLE explicitement l’optimisation prédictive, ne sont pas affectés par le paramètre du catalogue.

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

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

  • OPTIONS

    Définit les paramètres spécifiques au catalogue. Remplace la liste d’options existante par une nouvelle liste d’options.

    Utilisez OPTIONS pour définir authorized paths pour les catalogues étrangers créés via la fédération du metastore Hive.

    • option

      Clé de la propriété. La clé peut comporter un ou plusieurs identificateurs séparés par un point, ou une STRING littérale.

      Les clés de propriété doivent être uniques et respectent la casse.

    • valeur

      Valeur de la propriété. La valeur doit être une BOOLEANSTRING , INTEGERDECIMALou constante.

      Par exemple, une valuepasswordexpression constantesecret('secrets.r.us', 'postgresPassword') peut être utilisée au lieu de saisir un mot de passe littéral.

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');

-- Change the default collation of a catalog to case sensitive unicode
> ALTER CATALOG test DEFAULT COLLATION UNICODE_CS;

-- Adds an authorized path to a foreign catalog created using :re[HMS] federation.
> ALTER CATALOG my_federated_catalog OPTIONS (authorized_paths 'path/to/dir1, path/to/dir2');

–– 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)
  • Last updated on