ALTER SCHEMA (Databricks SQL)

  • 项目

通过设置 DBPROPERTIES 更改与架构关联的元数据。 指定的属性值将替代具有相同属性名的任何现有值。 如果在系统中找不到该架构，则系统会发出一条错误消息。 此命令主要用于记录架构的元数据，可用于审核目的。

虽然使用 SCHEMA 和 DATABASE 是可互换的，但最好使用 SCHEMA。

语法

ALTER { SCHEMA | DATABASE schema_name
   { SET DBPROPERTIES ( { key = val } [, ...] ) |
     OWNER TO principal }

参数

  • schema_name

    要更改的架构的名称。

  • DBPROPERTIES ( key = val [, …] )

    要设置或取消设置的架构属性。

  • OWNER TO 主体

    将架构的所有权转移给 principal。

示例

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