ALTER VIEW
적용 대상: 
Databricks SQL Databricks Runtime
뷰와 연결된 메타데이터를 변경합니다. TBLPROPERTIES를 설정하여 뷰 정의를 변경하고, 뷰 이름을 다른 이름으로 변경하고, 뷰 메타데이터를 설정 및 설정 해제할 수 있습니다.
뷰가 캐시된 경우 이 명령은 뷰의 캐시된 데이터와 뷰를 참조하는 모든 종속 항목을 지웁니다. 다음에 뷰에 액세스할 때는 뷰 캐시가 채워지는 시간이 지연됩니다. 이 명령은 뷰의 종속 항목을 캐시되지 않은 상태로 둡니다.
구문
ALTER VIEW view_name
{ rename |
SET TBLPROPERTIES clause |
UNSET TBLPROPERTIES clause |
alter_body |
schema_binding |
owner_to |
SET TAGS clause |
UNSET TAGS clause }
rename
RENAME TO to_view_name
alter_body
AS query
schema_binding
WITH SCHEMA { BINDING | [ TYPE ] EVOLUTION | COMPENSATION }
property_key
{ idenitifier [. ...] | string_literal }
owner_to
[ SET ] OWNER TO principal
매개 변수
-
변경할 뷰를 식별합니다. 뷰를 찾을 수 없으면 Azure Databricks에서 TABLE_OR_VIEW_NOT_FOUND 오류가 발생합니다.
RENAME TO to_view_name
스키마 내의 기존 뷰 이름을 바꿉니다. 구체화된 뷰의 이름을 바꿀 수 없습니다.
to_view_name은 뷰의 새 이름을 지정합니다.
to_view_name이 이미 있으면TableAlreadyExistsException이 throw됩니다.to_view_name이 정규화된 경우view_name의 스키마 이름과 일치해야 합니다.-
하나 이상의 사용자 정의 속성을 설정 또는 다시 설정합니다.
-
사용자 정의 속성을 하나 이상 제거합니다.
AS query
기본 테이블 또는 다른 뷰에서 뷰를 생성하는 쿼리입니다.
이 절은 뷰에 부여된 권한이 유지된다는 점을 제외하고 기존 뷰의 CREATE OR REPLACE VIEW 문과 동일합니다.
-
적용 대상:
Databricks Runtime 15.3 이상기본 개체 정의의 변경으로 인해 뷰의 후속 쿼리가 보기의 스키마 변경 내용에 맞게 조정되는 방식을 지정합니다. CREATE VIEW를 참조하세요 ... 스키마 바인딩 모드에 대한 자세한 내용은 WITH SCHEMA 입니다.
[ SET ] OWNER TO principal
뷰의 소유권을
principal로 이전합니다.hive_metastore에 뷰가 정의되지 않은 경우 사용자가 속한 그룹에만 소유권을 이전할 수 있습니다.적용 대상:
Databricks SQL Databricks Runtime 11.3 LTS 이상SET는 선택적 키워드로 허용됩니다.SET TAGS ( { tag_name = tag_value } [, ...] )
보기에 태그를 적용합니다. 뷰에
APPLY TAG태그를 추가할 수 있는 권한이 있어야 합니다.적용 대상:
Databricks SQL Databricks Runtime 13.3 LTS 이상UNSET 태그 ( tag_name [, ...] )
테이블에서 태그를 제거합니다. 보기에서 태그를 제거할 수 있는 권한이 있어야 합니다
APPLY TAG.적용 대상:
Databricks SQL Databricks Runtime 13.3 LTS 이상tag_name
리터럴
STRING입니다.tag_name뷰 내에서 고유해야 합니다.tag_value
리터럴
STRING입니다.
예제
-- Rename only changes the view name.
-- The source and target schemas of the view have to be the same.
-- Use qualified or unqualified name for the source and target view.
> ALTER VIEW tempsc1.v1 RENAME TO tempsc1.v2;
-- Verify that the new view is created.
> DESCRIBE TABLE EXTENDED tempsc1.v2;
c1 int NULL
c2 string NULL
# Detailed Table Information
Database tempsc1
Table v2
-- Before ALTER VIEW SET TBLPROPERTIES
> DESCRIBE TABLE EXTENDED tempsc1.v2;
c1 int null
c2 string null
# Detailed Table Information
Database tempsc1
Table v2
Table Properties [....]
-- Set properties in TBLPROPERTIES
> ALTER VIEW tempsc1.v2 SET TBLPROPERTIES ('created.by.user' = "John", 'created.date' = '01-01-2001' );
-- Use `DESCRIBE TABLE EXTENDED tempsc1.v2` to verify
> DESCRIBE TABLE EXTENDED tempsc1.v2;
c1 int NULL
c2 string NULL
# Detailed Table Information
Database tempsc1
Table v2
Table Properties [created.by.user=John, created.date=01-01-2001, ....]
-- Remove the key created.by.user and created.date from `TBLPROPERTIES`
> ALTER VIEW tempsc1.v2 UNSET TBLPROPERTIES (`created`.`by`.`user`, created.date);
-- Use `DESCRIBE TABLE EXTENDED tempsc1.v2` to verify the changes
> DESCRIBE TABLE EXTENDED tempsc1.v2;
c1 int NULL
c2 string NULL
# Detailed Table Information
Database tempsc1
Table v2
Table Properties [....]
-- Change the view definition
> ALTER VIEW tempsc1.v2 AS SELECT * FROM tempsc1.v1;
-- Use `DESCRIBE TABLE EXTENDED` to verify
> DESCRIBE TABLE EXTENDED tempsc1.v2;
c1 int NULL
c2 string NULL
# Detailed Table Information
Database tempsc1
Table v2
Type VIEW
View Text select * from tempsc1.v1
View Original Text select * from tempsc1.v1
-- Transfer ownership of a view to another user
> ALTER VIEW v1 OWNER TO `alf@melmak.et`
-- Change the view schema binding to adopt type evolution
> ALTER VIEW v1 WITH SCHEMA TYPE EVOLUTION;
-- Applies three tags to the view named `test`.
> ALTER VIEW test SET TAGS ('tag1' = 'val1', 'tag2' = 'val2', 'tag3' = 'val3');
-- Removes three tags from the view named `test`.
> ALTER VIEW test UNSET TAGS ('tag1', 'tag2', 'tag3');