Partilhar via

ALTER SCHEMA

Aplica-se a:assinalado como Sim Databricks SQL assinalado como Sim 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
    { DEFAULT COLLATION default_collation_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 .

  • COTEJAMENTO PADRÃO default_collation_name

    Aplica-se a:check marked yes Databricks SQL check marked yes Databricks Runtime 17.1 e superior

    Altera o agrupamento padrão para novos objetos definidos no esquema. O agrupamento padrão de objetos existentes dentro do esquema não é alterado.

  • 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:selecionado sim Databricks SQL selecionado sim Databricks Runtime 11.3 LTS e superior

    SET é permitido como palavra-chave opcional.

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

    Aplique tags ao esquema. Precisa de USE SCHEMA para aplicar uma tag ao esquema.

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

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

    Remova as tags do esquema. Você precisa ter USE SCHEMA para remover uma tag do esquema.

    Aplica-se a:marcado sim Databricks SQL marcado sim 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:assinalado sim Databricks SQL assinalado sim Databricks Runtime 12.2 LTS e superior assinalado sim apenas 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 usam ENABLE ou DISABLE para 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;

-- Alter the default collation of a schema
> ALTER SCHEMA my_schema DEFAULT COLLATION UNICODE_CI_AI;
  • Last updated on