Compartir a través de

ALTER CATALOG

Se aplica a:comprobar sí marcado Databricks SQL comprobar sí marcado Databricks Runtime 10.4 LTS y superior comprobar sí marcado Solo 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 ]
 { 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 [, ...] ) }

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.

  • INTERCALACIÓN PREDETERMINADA nombre_intercalación_predeterminada

    Se aplica a:check marcado yes Databricks SQL check marcado yes Databricks Runtime 17.1 y versiones posteriores

    Cambia la intercalación predeterminada para los nuevos esquemas definidos en el catálogo. No se cambia la intercalación predeterminada de esquemas y objetos existentes dentro del catálogo.

  • [ SET ] OWNER TO entidad de seguridad

    Transfiere la propiedad del catálogo a principal.

    Se aplica a:comprobar sí marcado Databricks SQL comprobar sí marcado Databricks Runtime 11.3 LTS y posterior

    SET está permitida como 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 USE CATALOG.

    Se aplica a:comprobar sí marcado Databricks SQL comprobar sí marcado Databricks Runtime 13.3 LTS y posterior

  • UNSET TAGS ( 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:comprobar sí marcado Databricks SQL comprobar sí marcado Databricks Runtime 13.3 LTS y posterior

  • tag_name

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

  • tag_value

    Un literal de STRING.

  • { ENABLE | DISABLE | HEREDAR } OPTIMIZACIÓN PREDICTIVA

    Se aplica a:comprobar sí marcado Databricks SQL comprobar sí marcado Databricks Runtime 12.2 LTS y posterior

    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.

  • OPCIONES

    Establece parámetros específicos del catálogo. Reemplaza la lista de opciones existente por una nueva lista de opciones.

    Use OPTIONS para establecer authorized paths para los catálogos externos creados usando la federación de metastore de Hive.

    • opción

      Clave de propiedad. La clave puede constar de uno o más identificadores separados por un punto o un literal de STRING.

      Las claves de propiedad deben ser únicas y distinguen mayúsculas de minúsculas.

    • valor

      El valor de la propiedad. El valor debe ser una BOOLEANSTRING , INTEGER, DECIMALo .

      Por ejemplo, un value para password puede usar la expresiónsecret('secrets.r.us', 'postgresPassword') constante en lugar de escribir la contraseña literal.

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

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