ALTER SCHEMA

  • Artículo

Se aplica a:casilla marcada como Sí Databricks SQL casilla marcada como sí Databricks Runtime

Cambia el propietario de un esquema, establece el comportamiento de optimización predictiva o modifica los metadatos asociados a un esquema estableciendo DBPROPERTIES. Los valores de propiedad especificados reemplazan cualquier valor existente por el mismo nombre de propiedad.

Aunque se pueden usar tanto SCHEMA como DATABASE, se prefiere SCHEMA.

Sintaxis

ALTER SCHEMA schema_name
   { SET DBPROPERTIES ( { key = val } [, ...] ) |
    [ SET ] OWNER TO principal
    SET TAGS ( { tag_name = tag_value } [, ...] ) |
    UNSET TAGS ( tag_name [, ...] ) |
    { ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION } }

Parámetros

  • schema_name

    Nombre del esquema que se va a modificar. Si no se encuentra el esquema, Azure Databricks genera un error SCHEMA_NOT_FOUND.

  • DBPROPERTIES ( key = val [, …] )

    Propiedades de esquema que se establecerán o anularán.

  • [ SET ] OWNER TO principal

    Transfiere la propiedad del esquema 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 } [, …] )

    Aplique etiquetas al esquema. Debe tener use_schema para aplicar una etiqueta al esquema.

    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 [, ...] )

    Quite las etiquetas del esquema. Debe tener use_schema para quitar una etiqueta del esquema.

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

  • 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 solo casilla marcada como Sí Unity Catalog

    Importante

    Esta característica está en versión preliminar pública.

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

    Si se modifica el esquema, el comportamiento se aplicará en cascada a todos los objetos que hereden la optimización predictiva. Los objetos que explícitamente ENABLE o DISABLE la optimización predictiva no se ven afectados por la configuración del esquema.

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

    Solo los esquemas en uso compartido no Delta y los catálogos administrados en el catálogo de Unity son aptos para la optimización predictiva.

Ejemplos

-- Creates a schema named `inventory`.
> CREATE SCHEMA inventory;

-- Alters the schema to set properties `Edited-by` and `Edit-date`.
> ALTER SCHEMA inventory SET DBPROPERTIES ('Edited-by' = 'John', 'Edit-date' = '01/01/2001');

-- Verify that properties are set.
> DESCRIBE SCHEMA EXTENDED inventory;
 database_description_item                 database_description_value
 ------------------------- ------------------------------------------
             Database Name                                  inventory
               Description
                  Location    file:/temp/spark-warehouse/inventory.db
                Properties ((Edit-date,01/01/2001), (Edited-by,John))

-- Transfer ownership of the schema to another user
> ALTER SCHEMA inventory OWNER TO `alf@melmak.et`

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

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

-- Enables predictive optimization for objects in schema my_schema
> ALTER SCHEMA my_schema ENABLE PREDICTIVE OPTIMIZATION;