ALTER SCHEMA

Aplica-se a: Databricks SQL Databricks Runtime

Altera o proprietário de um esquema, define o comportamento de otimização preditiva ou altera os metadados associados a um esquema definindo DBPROPERTIES. Os valores de propriedade especificados substituem qualquer valor existente com o mesmo nome de propriedade.

Enquanto o uso de SCHEMA e DATABASE é intercambiável, SCHEMA é preferível.

Sintaxe

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

  O nome do esquema a ser alterado. Se o esquema não puder ser encontrado, o Azure Databricks gerará um erro SCHEMA_NOT_FOUND .

• DBPROPERTIES ( chave = val [, ...] )

  As propriedades do esquema a serem definidas ou desdefinidas.

• [ SET ] PROPRIETÁRIO A principal

  Transfere a propriedade do esquema para principal.

  Aplica-se a: Databricks SQL Databricks Runtime 11.3 LTS e superior

  SET é permitido como palavra-chave opcional.

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

  Aplique tags ao esquema. Você precisa aplicar use_schema uma tag ao esquema.

  Aplica-se a: Databricks SQL Databricks Runtime 13.3 LTS e superior

• TAGS NÃO DEFINIDAS ( tag_name [, ...] )

  Remova as tags do esquema. Você precisa remover use_schema uma tag do esquema.

  Aplica-se a: Databricks SQL Databricks Runtime 13.3 LTS e superior

• tag_name

  Um literal STRING. O tag_name deve ser exclusivo dentro do esquema.

• tag_value

  Um literal STRING.

• { ATIVAR | DESATIVAR | HERDAR } OTIMIZAÇÃO PREDITIVA

  Aplica-se a:Databricks SQL Databricks Runtime 12.2 LTS e superior somente Unity Catalog

  Altera o esquema para a configuração de otimização preditiva desejada. Por padrão, quando esquemas são criados, o comportamento é para INHERIT a partir do catálogo. Por padrão, novos objetos criados no esquema herdarão a configuração do esquema.

  Se o esquema for alterado, o comportamento será em cascata para todos os objetos que herdam a otimização preditiva. Objetos que explicitamente ENABLE ou DISABLE otimização preditiva não são afetados pela configuração do esquema.

  Para definir a otimização preditiva para um esquema, o usuário deve ter CREATE permissão no esquema.

  Somente esquemas em catálogos gerenciados não Delta Sharing no Unity Catalog são elegíveis para otimização preditiva.

Exemplos

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

Artigos relacionados

• CREATE SCHEMA
• DESCRIBE SCHEMA
• DROP SCHEMA
• SHOW SCHEMAS