Share via

ALTER SCHEMA

  • Статья

Область применения:проверка помечены да Databricks SQL проверка помечены да Databricks Runtime

Изменяет владельца схемы, задает поведение прогнозной оптимизации или изменяет метаданные, связанные с схемой, задав параметр DBPROPERTIES. Указанные значения свойств переопределяют любое существующее значение с тем же именем свойства.

Хотя использование SCHEMA и DATABASE является взаимозаменяемым, лучше использовать SCHEMA.

Синтаксис

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

Параметры

  • schema_name

    Имя схемы, которую нужно изменить. Если схема не найдена, Azure Databricks вызывает ошибку SCHEMA_NOT_FOUND .

  • DBPROPERTIES ( key = val [, …] )

    Свойства схемы, которые нужно установить или сбросить.

  • [ SET ] OWNER TO субъект

    Передает владение схемой субъекту principal.

    Область применения:проверка помечены да Databricks SQL проверка помечены да Databricks Runtime 11.3 LTS и выше

    SETдопускается как необязательный ключевое слово.

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

    Примените теги к схеме. use_schema Необходимо применить тег к схеме.

    Область применения:проверка помечены да Databricks SQL проверка помечены да Databricks Runtime 13.3 LTS и выше

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

    Удалите теги из схемы. Необходимо use_schema удалить тег из схемы.

    Область применения:проверка помечены да Databricks SQL проверка помечены да Databricks Runtime 13.3 LTS и выше

  • tag_name

    Литерал STRING. Он tag_name должен быть уникальным в схеме.

  • tag_value

    Литерал STRING.

  • { ENABLE | DISABLE | НАСЛЕДОВАНИЕ } ПРОГНОЗНАЯ ОПТИМИЗАЦИЯ

    Применимо к:проверка помечены да Databricks SQL проверка помечены да Databricks Runtime 12.2 LTS и более поздних проверка помечены да версий каталога Unity

    Внимание

    Эта функция предоставляется в режиме общедоступной предварительной версии.

    Изменяет схему на нужный параметр прогнозной оптимизации. По умолчанию при создании схем поведение выполняется INHERIT из каталога. По умолчанию новые объекты, созданные в схеме, наследуют параметр от схемы.

    Если схема изменена, поведение будет каскадно для всех объектов, наследующих прогнозную оптимизацию. Объекты, которые явно ENABLE или DISABLE прогнозной оптимизации не влияют на параметр схемы.

    Чтобы задать прогнозную оптимизацию схемы, пользователь должен иметь CREATE разрешение на схему.

    Для прогнозирования можно использовать только схемы, не относящиеся к разностному совместному использованию, управляемые каталоги в каталоге Unity.

Примеры

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