Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Berlaku untuk:
Databricks SQL
Databricks Runtime
Mengubah metadata yang terkait dengan tampilan. Ini dapat mengubah definisi tampilan, mengganti nama tampilan, dan mengatur atau membatalkan set metadata dengan mengatur TBLPROPERTIES. Untuk tampilan metrik, ia juga dapat menambah dan menghapus hubungan (Beta).
Untuk menambahkan atau mengubah komentar pada tampilan, gunakan COMMENT ON.
Jika tampilan dicache, perintah menghapus data cache dari tampilan dan semua tanggungannya yang merujuk kepadanya. Cache tampilan diisi dengan malas saat tampilan diakses berikutnya. Perintah meninggalkan dependen tampilan sebagai tidak di-cache.
Hak istimewa yang diperlukan
Jika Anda menggunakan Katalog Unity, operasi berikut ini tidak memerlukan kepemilikan tampilan:
-
SET TAGS: MemerlukanAPPLY TAGhak istimewa. -
UNSET TAGS: MemerlukanAPPLY TAGhak istimewa.
Operasi berikut memerlukan kepemilikan tampilan:
SET TBLPROPERTIESUNSET TBLPROPERTIES-
AS query(ubah definisi tampilan) -
WITH SCHEMA(mengubah pengikatan skema)
RENAME TO
MANAGE memerlukan hak istimewa pada tampilan.
ADD CONSTRAINT dan DROP CONSTRAINT memerlukan MANAGE hak istimewa pada tampilan metrik atau kepemilikannya, plus USE CATALOG serta pada USE SCHEMA katalog dan skemanya.
ADD CONSTRAINT Untuk sebuah relasi, juga diperlukan SELECT hak istimewa pada tampilan metrik target, plus USE CATALOG , dan USE SCHEMA pada katalog serta skema target.
Untuk SET OWNER TO, hak istimewa yang diperlukan bergantung pada pemilik baru:
- Jika prinsipal adalah diri Anda sendiri, Anda harus memiliki
MANAGEhak istimewa pada tampilan. - Jika prinsipal adalah grup, Anda harus menjadi anggota grup tersebut.
- Dalam semua kasus lain, Anda harus menjadi admin metastore.
Sintaks
ALTER VIEW view_name
{ rename |
SET TBLPROPERTIES clause |
UNSET TBLPROPERTIES clause |
alter_body |
schema_binding |
owner_to |
SET TAGS clause |
UNSET TAGS clause |
add_constraint |
drop_constraint }
rename
RENAME TO to_view_name
alter_body
AS { query | yaml_definition }
yaml_definition
$$
yaml_string
$$
schema_binding
WITH SCHEMA { BINDING | [ TYPE ] EVOLUTION | COMPENSATION }
property_key
{ identifier [. ...] | string_literal }
owner_to
[ SET ] OWNER TO principal
add_constraint
ADD [ CONSTRAINT name ] relationship_constraint
relationship_constraint
cardinality RELATIONSHIP TO target_view [ [ AS ] target_alias ]
{ ON condition | USING ( column [, ...] ) }
cardinality
{ MANY | ONE } TO { MANY | ONE }
drop_constraint
DROP CONSTRAINT [ IF EXISTS ] name
Parameter
-
Mengidentifikasi tampilan yang akan diubah. Jika tampilan tidak dapat ditemukan, Azure Databricks menimbulkan kesalahan TABLE_OR_VIEW_NOT_FOUND .
GANTI NAMA MENJADI to_view_name
Mengganti nama tampilan yang ada menjadi
to_view_name.Untuk tampilan Katalog Unity,
to_view_nameharus berada dalam katalog yang sama denganview_name. Untuk tampilan lain,to_view_nameharus berada dalam skema yang sama denganview_name.Jika
to_view_nametidak memenuhi syarat, secara implisit memenuhi syarat dengan skema saat ini.Tampilan materialisasi tidak dapat diganti namanya.
-
Mengatur satu atau beberapa properti yang ditentukan pengguna.
HAPUS PENGATURAN TBLPROPERTIES
Menghapus satu atau beberapa properti yang ditentukan pengguna.
AS Kueri
Kueri yang membuat tampilan dari tabel dasar atau tampilan lainnya.
AS querytidak didukung untuk tampilan metrik.Klausa ini setara dengan pernyataan CREATE OR REPLACE VIEW pada tampilan yang ada, kecuali bahwa hak istimewa yang diberikan pada tampilan dipertahankan.
SEPERTI yaml_definition
Berlaku untuk:
Databricks SQL
Databricks Runtime 16.4 ke atas
Unity Catalog sajaDefinisi YAML untuk tampilan metrik.
Klausa ini setara dengan pernyataan CREATE OR REPLACE VIEW pada tampilan yang ada, kecuali bahwa hak istimewa yang diberikan pada tampilan dipertahankan.
Menentukan kembali definisi YAML menambahkan, menjatuhkan, atau mengubah tampilan
parametersmetrik tanpa perubahan sintaks apa pun. Untuk sintaks parameter, lihat CREATE VIEW. Parameter memerlukan Databricks Runtime 18.2 ke atas.-
Berlaku untuk:
Databricks SQL
Databricks Runtime 15.3 ke atasMenentukan bagaimana kueri tampilan berikutnya beradaptasi dengan perubahan pada skema tampilan karena perubahan dalam definisi objek yang mendasar. Lihat CREATE VIEW... WITH SCHEMA untuk detail tentang mode pengikatan skema.
Klausa ini tidak didukung untuk tampilan metrik.
[ SET ] PEMILIK UNTUK penanggung jawab utama
Memindahkan kepemilikan tampilan ke
principal. Kecuali tampilan ditentukan dalamhive_metastore, Anda hanya dapat mentransfer kepemilikan ke grup tempat Anda berada.Berlaku untuk:
Databricks SQL
Databricks Runtime 11.3 LTS dan ke atasSETdiperbolehkan sebagai kata kunci opsional.SET TAGS ( { tag_name = tag_value } [, ...] )
Menerapkan tag ke tampilan. Anda memerlukan
APPLY TAGhak istimewa untuk menambahkan tag ke tampilan.Berlaku untuk:
Databricks SQL
Databricks Runtime 13.3-LTS ke atasUNSET TAGS ( tag_name [, ...] )
Menghapus tag dari tampilan. Anda memerlukan
APPLY TAGhak istimewa untuk menghapus tag dari tampilan.Berlaku untuk:
Databricks SQL
Databricks Runtime 13.3-LTS ke atastag_name
Harfiah
STRING.tag_nameharus unik dalam tampilan.tag_value
Harfiah
STRING.add_constraint
Berlaku untuk:
Databricks SQL
Databricks Runtime 19 ke atas
hanya Unity CatalogMenambahkan hubungan informasi dari tampilan metrik ke tampilan metrik target. Klausul ini masih dalam tahap Beta. Baik dan
view_nametarget_viewharus merupakan tampilan metrik Unity Catalog. Tampilan metrik sementara tidak didukung. Azure Databricks tidak menegakkan hubungan. Lihat Hubungan antar tampilan metrik.CONSTRAINT nama
Secara opsional menamai hubungan. Nama harus unik di antara semua kendala dalam skema. Jika Anda menghilangkannya, Azure Databricks menamai hubungan
<source>_to_<target>tersebut , menggunakan nama tanpa kualifikasi dari dua tampilan metrik tersebut.kardinalitas
Salah satu dari
MANY TO ONE,ONE TO MANY,ONE TO ONE, atauMANY TO MANY. Azure Databricks tidak memeriksa data terhadap kardinalitas tersebut.UNTUK target_view
Mengidentifikasi tampilan metrik target. Target dapat berada di katalog atau skema mana pun dari metastore yang sama.
SEPERTI target_alias
Secara opsional menamai target dalam .
conditionSebuah hubungan dari tampilan metrik ke dirinya sendiri memerlukan alias yang berbeda dari namaview_name.DENGAN SYARAT
Ekspresi deterministik
BOOLEANatas kolom danview_nametarget_view, dengan aturan yang sama sepertiONklausa gabungan. Ungkapan itu tidak bisa merujuk pada ukuran. Ia tidak dapat memanggil fungsi agregat, termasuk MEASURE dan AGG, fungsi jendela, atau generator. Bisa hingga 1.024 karakter.MENGGUNAKAN ( kolom [, ...] )
Satu hingga 20 kolom yang ada dengan nama yang sama di kedua tampilan metrik.
drop_constraint
Berlaku untuk:
Databricks SQL
Databricks Runtime 19 ke atas
hanya Unity CatalogMenghapus hubungan
namedari tampilan metrik. Klausul ini masih dalam tahap Beta. Jika Anda menentukanIF EXISTS, pernyataan berhasil ketika tidak ada hubungan dengan nama tersebut. Jika tidak, gagal denganNO_SUCH_CONSTRAINT_EXCEPTION.Warning
Jangan sebutkan
RESTRICTkapanCASCADEkamu memutuskan hubungan. Berbeda dengan ALTER TABLE DROP CONSTRAINT, kata kunci ini tidak memiliki perilaku yang jelas untuk hubungan, dan perilaku mereka mungkin berubah di rilis mendatang.
Contoh
-- Rename only changes the view name.
-- The source and target schemas of the view must 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;
-- Apply three tags to the view named `test`.
> ALTER VIEW test SET TAGS ('tag1' = 'val1', 'tag2' = 'val2', 'tag3' = 'val3');
-- Remove three tags from the view named `test`.
> ALTER VIEW test UNSET TAGS ('tag1', 'tag2', 'tag3');
-- Alter the metric view `region_sales_metrics` defined in CREATE VIEW
-- to drop the `total_revenue_for_open_orders` measure.
> ALTER VIEW region_sales_metrics
AS $$
version: 0.1
source: samples.tpch.orders
filter: o_orderdate > '1990-01-01'
dimensions:
- name: month
expr: date_trunc('MONTH', o_orderdate)
- name: status
expr: case
when o_orderstatus = 'O' then 'Open'
when o_orderstatus = 'P' then 'Processing'
when o_orderstatus = 'F' then 'Fulfilled'
end
- name: order_priority
expr: split(o_orderpriority, '-')[1]
measures:
- name: count_orders
expr: count(1)
- name: total_revenue
expr: SUM(o_totalprice)
- name: total_revenue_per_customer
expr: SUM(o_totalprice) / count(distinct o_custkey)
$$;
> DESCRIBE EXTENDED region_sales_metrics;
col_name data_type
month timestamp
status string
order_priority string
count_orders bigint measure
total_revenue decimal(28,2) measure
total_revenue_per_customer decimal(38,12) measure
# Detailed Table Information
Catalog main
Database default
Table region_sales_metrics
Owner alf@melmak.et
Created Time Sun May 18 23:45:25 UTC 2025
Last Access UNKNOWN
Created By Spark
Type METRIC_VIEW
Comment A metric view for regional sales metrics.
View Text "
version: 0.1
source: samples.tpch.orders
filter: o_orderdate > '1990-01-01'
dimensions:
- name: month
expr: date_trunc('MONTH', o_orderdate)
- name: status
expr: case
when o_orderstatus = 'O' then 'Open'
when o_orderstatus = 'P' then 'Processing'
when o_orderstatus = 'F' then 'Fulfilled'
end
- name: order_priority
expr: split(o_orderpriority, '-')[1]
measures:
- name: count_orders
expr: count(1)
- name: total_revenue
expr: SUM(o_totalprice)
- name: total_revenue_per_customer
expr: SUM(o_totalprice) / count(distinct o_custkey)
"
Language YAML
Table Properties [metric_view.from.name=samples.tpch.orders, metric_view.from.type=ASSET, metric_view.where=o_orderdate > '1990-01-01']
-- Declare that each order in the `orders_mv` metric view matches one customer
-- in the `customers_mv` metric view, joined on the shared `customer_id` column.
> ALTER VIEW main.sales.orders_mv ADD CONSTRAINT orders_customer
MANY TO ONE RELATIONSHIP TO main.sales.customers_mv
USING (customer_id);
-- Declare a relationship that refers to the target by an alias in the ON condition.
> ALTER VIEW main.travel.flights_mv ADD CONSTRAINT departure_city
MANY TO ONE RELATIONSHIP TO main.travel.cities_mv AS c
ON flights_mv.departure_city_id = c.city_id;
-- Drop the relationship.
> ALTER VIEW main.travel.flights_mv DROP CONSTRAINT IF EXISTS departure_city;