Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Dotyczy:
Databricks SQL
Databricks Runtime
Zmienia metadane skojarzone z widokiem. Może zmienić definicję widoku, zmienić nazwę widoku i ustawić lub nie ustawić metadanych przez ustawienie TBLPROPERTIES. W przypadku widoku metrycznego może także dodawać i usuwać relacje (Beta).
Aby dodać lub zmienić komentarz w widoku, użyj polecenia COMMENT ON.
Jeśli widok jest buforowany, polecenie czyści buforowane dane widoku i wszystkie jego zależności odwołujące się do niego. Pamięć podręczna widoku jest wypełniana z opóźnieniem, gdy widok będzie uzyskiwany do następnego dostępu. Polecenie pozostawia zależności widoku jako niebuforowane.
Wymagane uprawnienia
Jeśli używasz wykazu aparatu Unity, następujące operacje nie wymagają własności widoku:
-
SET TAGS: wymagaAPPLY TAGuprawnień. -
UNSET TAGS: wymagaAPPLY TAGuprawnień.
Następujące operacje wymagają własności widoku:
SET TBLPROPERTIESUNSET TBLPROPERTIES-
AS query(zmień definicję widoku) -
WITH SCHEMA(zmień powiązanie schematu)
RENAME TO
MANAGE wymaga uprawnień w widoku.
ADD CONSTRAINT oraz DROP CONSTRAINT wymagać MANAGE przywileju na widok metryczny lub własność do niej, plus USE CATALOG do USE SCHEMA katalogu i schematu.
ADD CONSTRAINT Dla relacji wymaga również uprawnień SELECT do widoku metryki docelowej, plus USE CATALOG oraz USE SCHEMA do katalogu i schematu docelowego.
W przypadku SET OWNER TOprogramu wymagane uprawnienia zależą od nowego właściciela:
- Jeśli podmiot zabezpieczeń jest sam, musisz mieć
MANAGEuprawnienia w widoku. - Jeśli podmiot zabezpieczeń jest grupą, musisz być członkiem tej grupy.
- We wszystkich innych przypadkach musisz być administratorem magazynu metadanych.
Składnia
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
Parametry
-
Identyfikuje widok, który ma zostać zmieniony. Jeśli nie można odnaleźć widoku, usługa Azure Databricks zgłasza błąd TABLE_OR_VIEW_NOT_FOUND .
ZMIEŃ NAZWĘ NA TO_VIEW_NAME
Zmienia nazwę istniejącego widoku na
to_view_name.W przypadku widoków Unity Catalog,
to_view_namemusi znajdować się w tym samym katalogu coview_name. W przypadku innych widoków,to_view_namemusi być w tym samym schemacie coview_name.Jeśli
to_view_namejest niekwalifikowany, jest niejawnie kwalifikowany przy użyciu bieżącego schematu.Nie można zmienić nazwy zmaterializowanych widoków.
-
Ustawia lub resetuje co najmniej jedną właściwości zdefiniowaną przez użytkownika.
NIEUSTALONE cechy TBLPROPERTIES
Usuwa co najmniej jedną właściwości zdefiniowaną przez użytkownika.
-
Zapytanie, które konstruuje widok z tabel podstawowych lub innych widoków.
AS querynie jest obsługiwana w przypadku widoków metryk.Ta klauzula jest równoważna instrukcji CREATE OR REPLACE VIEW w istniejącym widoku, z tą różnicą, że uprawnienia przyznane w widoku są zachowywane.
As yaml_definition
Dotyczy:
Databricks SQL,
Databricks Runtime 16.4 i nowsze,
tylko katalog UnityDefinicja YAML dla widoku metryki.
Ta klauzula jest równoważna instrukcji CREATE OR REPLACE VIEW w istniejącym widoku, z tą różnicą, że uprawnienia przyznane w widoku są zachowywane.
Ponowne określanie definicji YAML powoduje dodanie, porzucenie lub zmianę widoku
parametersmetryki bez żadnej zmiany składni. Aby uzyskać składnię parametrów, zobacz CREATE VIEW. Parametry wymagają środowiska Databricks Runtime 18.2 lub nowszego.-
Dotyczy:
Databricks SQL
Databricks Runtime 15.3 lub nowszyOkreśla, jak kolejne wykonywanie zapytań w widoku dostosowuje się do zmian w schemacie widoku ze względu na zmiany w definicjach obiektów bazowych. Zobacz CREATE VIEW... WITH SCHEMA , aby uzyskać szczegółowe informacje na temat trybów powiązań schematu.
Ta klauzula nie jest obsługiwana w przypadku widoków metryk.
[ SET ] WŁAŚCICIEL DO głównego podmiotu
Przenosi własność widoku na
principal. Chyba że widok jest zdefiniowany w elemeciehive_metastore, można przenieść własność tylko do grupy, do której należysz.Dotyczy:
Databricks SQL
Databricks Runtime 11.3 LTS i nowszeSETjest dozwolone jako opcjonalne słowo kluczowe.SET TAGI ( { tag_name = tag_value } [, ...] )
Stosuje tagi do widoku. Musisz mieć uprawnienia do dodawania
APPLY TAGtagów do widoku.Dotyczy:
Databricks SQL
Databricks Runtime 13.3 LTS i nowszeUNSET TAGS (TAG_NAME [, ...] )
Usuwa tagi z widoku. Musisz
APPLY TAGmieć uprawnienia do usuwania tagów z widoku.Dotyczy:
Databricks SQL
Databricks Runtime 13.3 LTS i nowszetag_name
Literał
STRING. Elementtag_namemusi być unikatowy w widoku.tag_value
Literał
STRING.add_constraint
Dotyczy do:
, Databricks SQL
, Databricks Runtime 19 i wyższe,
, tylko katalog Unity.Dodaje relację informacyjną z widoku metryki do widoku metryki docelowej. Ten zapis jest w fazie beta. Oba
view_namei muszątarget_viewbyć widokami metryk Unity Catalog. Tymczasowe widoki metryczne nie są obsługiwane. Azure Databricks nie wymusza relacji. Zobacz Relacje między widokami metrycznymi.CONSTRAINT Nazwa
Opcjonalnie nazywa relację. Nazwa musi być unikalna wśród wszystkich ograniczeń w schemacie. Jeśli pominiesz tę informację, Azure Databricks nazywa relację
<source>_to_<target>, używając niezastrzeżonych nazw obu widoków metrycznych.kardynalności
MANY TO ONEJeden z ,ONE TO MANY,ONE TO ONElubMANY TO MANY. Azure Databricks nie sprawdza danych pod kątem ich mocy.DO target_view
Identyfikuje widok docelowej metryki. Celem może być dowolny katalog lub schemat tego samego metastore.
JAK target_alias
opcjonalnie nazywa cel w
condition. Relacja z perspektywy metrycznej do siebie wymaga aliasu różniącego się od nazwyview_name.NA warunku
Deterministyczne wyrażenie
BOOLEANnad kolumnami iview_nametarget_view, o tych samych regułach co klauzulaONpołączenia. Wyrażenie nie może odnosić się do miary. Nie może wywołać funkcji agregatującej, w tym MEASURE i AGG, funkcji okienkowej ani generatora. Może mieć do 1 024 znaków.USING ( kolumna [, ...] )
Od jednej do 20 kolumn o tej samej nazwie w obu widokach metrycznych.
drop_constraint
Dotyczy do:
, Databricks SQL
, Databricks Runtime 19 i wyższe,
, tylko katalog Unity.Usuwa relację
namez widoku metryki. Ten zapis jest w fazie beta. Jeśli określiszIF EXISTS, zdanie odnosi się do skutku, gdy nie istnieje żadna relacja z tą nazwą. W przeciwnym razie nie udaje się zNO_SUCH_CONSTRAINT_EXCEPTION.Warning
Nie precyzuj
RESTRICT, kiedyCASCADEkończysz związek. W przeciwieństwie do ALTER TABLE DROP CONSTRAINT, te słowa kluczowe nie mają określonego zachowania dla relacji i ich zachowanie może się zmienić w przyszłych wydaniach.
Przykłady
-- 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;