다음을 통해 공유

ALTER SCHEMA

  • 아티클

적용 대상:예로 표시된 확인 Databricks SQL 예로 표시된 확인 Databricks Runtime

schema소유자를 변경하거나, 예측 최적화 동작을 설정하거나, DBPROPERTIES설정하여 schema 연결된 메타데이터를 변경합니다. 지정된 속성 values은 동일한 속성 이름을 가진 기존 값을 덮어씁니다.

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

Parameters

  • schema_name

    변경할 schema 이름입니다. schema을 찾을 수 없는 경우에 Azure Databricks에서 SCHEMA_NOT_FOUND 오류가 발생합니다.

  • DBPROPERTIES ( key = val [, …] )

    schema 속성은 set이거나 설정되지 않은 상태입니다.

  • [ SET ] 소유자에게 주인

    schema 소유권을 principal에게 넘긴다.

    적용 대상:예로 표시된 확인 Databricks SQL 예로 표시된 확인 Databricks Runtime 11.3 LTS 이상

    SET는 선택적 키워드로 허용됩니다.

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

    schema에 태그를 적용하세요. use_schema이 있어야 schema에 태그를 적용할 수 있습니다.

    적용 대상:예로 표시된 확인 Databricks SQL 예로 표시된 확인 Databricks Runtime 13.3 LTS 이상

  • UNSET 태그 ( tag_name [, ...] )

    schema에서 가져온 Remove 태그. schema에서 태그를 use_schema에서 remove로 해야 합니다.

    적용 대상:예로 표시된 확인 Databricks SQL 예로 표시된 확인 Databricks Runtime 13.3 LTS 이상

  • tag_name

    리터럴 STRING입니다. tag_name schema내에서 고유해야 합니다.

  • tag_value

    리터럴 STRING입니다.

  • { ENABLE | DISABLE | INHERIT } 예측 최적화

    적용 대상:체크 표시됨 예 Databricks SQL 체크 표시됨 예 Databricks Runtime 12.2 LTS 이상 체크 표시됨 예 Unity Catalog만.

    schema을 원하는 예측 최적화 설정으로 변경합니다. 기본적으로 스키마를 만들 때의 기본 동작은 catalog에서 INHERIT 하는 것입니다. 기본적으로 schema에서 생성된 새 개체는 schema의 그 설정을 상속합니다.

    schema가 변경되면 예측 최적화를 상속하는 모든 객체에 동작이 전파됩니다. 예측 최적화를 위해 명시적으로 ENABLE 또는 DISABLE로 지정된 개체는 schema 설정의 영향을 받지 않습니다.

    schema대한 예측 최적화를 setschema대한 CREATE 권한이 있어야 합니다.

    오직 델타 공유 아닌, Unity Catalog에서 관리되는 catalogs 스키마만 예측 최적화가 가능합니다.

예제

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