Compartir vía

ALTER CATALOG

  • Artículo

Se aplica a:casilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 10.4 LTS y versiones posteriores casilla marcada como sí solo a Unity Catalog

Transfiere la propiedad de un catálogo a una nueva entidad de seguridad, aplica etiquetas a un catálogo, o bien habilita o deshabilita la optimización predictiva para un catálogo.

Sintaxis

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

Parámetros

  • catalog_name

    Nombre del catálogo que se va a modificar. Si no proporciona ningún nombre, el valor predeterminado es hive_metastore.

  • [ SET ] OWNER TO principal

    Transfiere la propiedad del catálogo a principal.

    Se aplica a: casilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 11.3 LTS y versiones posteriores

    SET se permite como una palabra clave opcional.

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

    Aplica etiquetas al catálogo. Debe tener el permiso use_catalog para aplicar una etiqueta a un catálogo. Consulte USAR CATÁLOGO.

    Se aplica a: casilla marcada como sí Databricks SQL casilla marcada como sí Databricks Runtime 13.3 LTS y versiones posteriores

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

    Elimina las etiquetas del catálogo. Debe tener el permiso use_catalog para aplicar una etiqueta a un catálogo.

    Se aplica a:casilla marcada como sí Databricks SQL casilla marcada como sí Databricks Runtime 13.3 LTS y versiones posteriores

  • tag_name

    Un literal de STRING. El tag_name debe ser único dentro del catálogo.

  • tag_value

    Un literal de STRING.

  • { ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION

    Se aplica a: casilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 12.2 LTS y versiones posteriores

    Modifica el catálogo a la configuración de optimización predictiva deseada. De manera predeterminada, cuando se crean catálogos, el comportamiento es INHERIT desde la cuenta. De manera predeterminada, los objetos creados en el catálogo heredarán la configuración del catálogo.

    Si se modifica el catálogo, el comportamiento se aplicará en cascada a todos los esquemas y sus objetos, que heredan la optimización predictiva. Los objetos de esquemas que no heredan la optimización predictiva o los objetos que aplican ENABLE o DISABLE explícitamente a la optimización predictiva no se ven afectados por la configuración del catálogo.

    Para establecer la optimización predictiva de un catálogo, el usuario debe tener permiso CREATE en el catálogo.

    Solo los catálogos administrados sin uso compartido de Delta de Unity Catalog son aptos para la optimización predictiva.

Ejemplos

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