Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gilt für:
Databricks SQL
Databricks Runtime
Erstellt eine virtuelle Tabelle ohne physische Daten basierend auf dem Resultset einer SQL-Abfrage oder einer Metrikansicht basierend auf einer Yaml-Spezifikation. ALTER VIEW und DROP VIEW ändern nur die Metadaten.
Um diese Anweisung auszuführen, müssen Sie entweder ein Metastore-Administrator sein oder über USE CATALOG und USE SCHEMA Berechtigungen für den Katalog und das Schema sowie CREATE TABLE Berechtigungen im Zielschema verfügen.
Der Benutzer, der diesen Befehl ausführt, wird der Besitzer der Ansicht.
Syntax
CREATE [ OR REPLACE ] [ TEMPORARY ] VIEW [ IF NOT EXISTS ] view_name
[ column_list ]
[ with_clause |
COMMENT view_comment |
DEFAULT COLLATION collation_name |
TBLPROPERTIES clause |
LANGUAGE YAML ] [...]
AS { query | $$ yaml_string $$ }
with_clause
WITH { { schema_binding | METRICS } |
( { schema_binding | METRICS } [, ...] } )
schema_binding
WITH SCHEMA { BINDING | COMPENSATION | [ TYPE ] EVOLUTION }
column_list
( { column_alias [ COMMENT column_comment ] } [, ...] )
Parameter
ODER ERSETZEN
Wenn bereits eine Ansicht mit demselben Namen vorhanden ist, wird sie ersetzt. Um eine vorhandene Ansicht zu ersetzen, müssen Sie deren Besitzer sein.
Durch das Ersetzen einer vorhandenen Ansicht bleiben die Berechtigungen, die der ursprünglichen Ansicht oder dem
table_idgewährt wurden, nicht erhalten. Verwenden Sie ALTER VIEW, um Berechtigungen beizubehalten.CREATE OR REPLACE VIEW view_nameentsprichtDROP VIEW IF EXISTS view_namegefolgt vonCREATE VIEW view_name.TEMPORARY
TEMPORARYAnsichten sind nur für die Sitzung sichtbar, die sie erstellt hat, und werden gelöscht, wenn die Sitzung endet.GLOBAL TEMPORÄR
Gilt für:
Databricks RuntimeGLOBAL TEMPORARYAnsichten sind an ein vom System beibehaltenes temporäres Schemaglobal_tempgebunden.WENN NICHT EXISTIERT
Erstellt die Ansicht nur, wenn sie nicht vorhanden ist. Wenn bereits eine Sicht mit diesem Namen vorhanden ist, wird die
CREATE VIEW-Anweisung ignoriert.Sie können nur
IF NOT EXISTSoderOR REPLACEangeben.-
Der Name der neu erstellten Sicht. Der Name einer temporären Ansicht darf nicht qualifiziert sein. Der vollqualifizierte Anzeigename muss eindeutig sein.
Ansichtsnamen, die in
hive_metastoreerstellt wurden, dürfen nur alphanumerische ASCII-Zeichen und Unterstriche (INVALID_SCHEMA_OR_RELATION_NAME) enthalten. METRIKEN
Gilt für:
Databricks SQL
Databricks Runtime 16.4 und höher
nur Unity CatalogIdentifiziert die Ansicht als Metrikansicht. Die Ansicht muss mit
LANGUAGE YAMLdefiniert sein, und der Textkörper der Ansicht muss eine gültige YAML-Spezifikation sein.Vor Databricks Runtime 17.2 wird diese Klausel für temporäre Ansichten nicht unterstützt.
Eine metrische Ansicht unterstützt die
DEFAULT COLLATION- undschema_binding-Klauseln nicht.Die YAML-Spezifikation der Metrikansicht definiert
dimensionsundmeasures. Diedimensionssind die Spalten der Ansicht, nach denen der Aufrufer die Messungen aggregieren kann, während diemeasuresdie Aggregationen der Ansicht definieren.Der Aufrufer einer Metrikansicht verwendet den Measure-Ausdruck, um auf die definierten Maßstäbe zuzugreifen, anstatt Aggregationsfunktionen anzugeben.
schema_binding
Gilt für:
Databricks Runtime 15.3 und höherGibt optional an, wie sich die Ansicht aufgrund von Änderungen in den zugrunde liegenden Objektdefinitionen an das Schema der Abfrage anpasst.
Diese Klausel wird für temporäre Ansichten, Metrikansichten oder materialisierte Ansichten nicht unterstützt.
SCHEMA VERBINDLICH
Die Ansicht wird ungültig, wenn sich die Abfragespaltenliste mit Ausnahme der folgenden Bedingungen ändert:
- Die Spaltenliste enthält eine Sternklausel, und es gibt zusätzliche Spalten. Diese zusätzlichen Spalten werden ignoriert.
- Der Typ einer oder mehrerer Spalten wurde so geändert, dass sie mithilfe impliziter Umwandlungsregeln sicher in die ursprünglichen Spaltentypen umgewandelt werden können.
SCHEMA KOMPENSATION
Die Ansicht wird ungültig, wenn sich die Abfragespaltenliste mit Ausnahme der folgenden Bedingungen ändert:
- Die Spaltenliste enthält eine Sternklausel, und es gibt zusätzliche Spalten. Diese zusätzlichen Spalten werden ignoriert.
- Der Typ einer oder mehrerer Spalten wurde so geändert, dass sie mithilfe expliziter ANSI-Umwandlungsregeln in die ursprünglichen Spaltentypen umgewandelt werden können.
Dies ist die Standardeinstellung.
SCHEMA TYPENTWICKLUNG
Die Ansicht übernimmt Änderungen an Typen in der Abfragespaltenliste in eine eigene Definition, wenn der SQL-Compiler eine solche Änderung als Reaktion auf einen Verweis auf die Ansicht erkennt.
SCHEMA EVOLUTION
- Dieser Modus verhält sich wie
SCHEMA TYPE EVOLUTION, und übernimmt auch Änderungen in Spaltennamen oder hinzugefügten und abgelegten Spalten, wenn die Ansicht keine explizitecolumn_listenthält. - Die Ansicht wird nur ungültig, wenn die Abfrage nicht mehr analysiert werden kann, oder die optionale Ansicht
column_listnicht mehr mit der Anzahl der Ausdrücke in derqueryAuswahlliste übereinstimmen.
- Dieser Modus verhält sich wie
column_list
Bezeichnet optional die Spalten im Abfrageergebnis der Sicht. Wenn Sie eine Spaltenliste angeben, muss die Anzahl der Spaltenaliasen mit der Anzahl der Ausdrücke in der Abfrage übereinstimmen, oder für Metrikansichten die YAML-Spezifikation. Für den Fall, dass keine Spaltenliste angegeben ist, werden Aliase vom Text der Ansicht abgeleitet.
-
Die Spaltenaliase müssen eindeutig sein.
column_comment
Ein optionales
STRING-Literal, das den Spaltenalias beschreibt.
-
view_comment
Ein optionales
STRING-Literal, das Kommentare auf Ansichtsebene angibt.STANDARDSORTIERUNGs-collation_name
Gilt für:
Databricks SQL
Databricks Runtime 16.3 und höherDefiniert die standardmäßige Sortierung, die innerhalb
queryverwendet werden soll. Wenn nicht angegeben, wird die Standardsortierung vom Schema abgeleitet, in dem die Ansicht erstellt wird.Diese Klausel wird für Metrikansichten nicht unterstützt.
-
Legt optional eine oder mehrere benutzerdefinierte Eigenschaften fest.
-
Eine Abfrage, die die Sicht aus Basistabellen oder anderen Sichten erstellt.
Diese Klausel wird für Metrikansichten nicht unterstützt.
AS $ yaml_string $
Eine Yaml-Spezifikation, die eine Metrikansicht definiert.
Beispiele
-- Create or replace view for `experienced_employee` with comments.
> CREATE OR REPLACE VIEW experienced_employee
(id COMMENT 'Unique identification number', Name)
COMMENT 'View for experienced employees'
AS SELECT id, name
FROM all_employee
WHERE working_years > 5;
-- Create a temporary view `subscribed_movies`.
> CREATE TEMPORARY VIEW subscribed_movies
AS SELECT mo.member_id, mb.full_name, mo.movie_title
FROM movies AS mo
INNER JOIN members AS mb
ON mo.member_id = mb.id;
-- Create a view with schema binding (default)
> CREATE TABLE emp(name STRING, income INT);
> CREATE VIEW emp_v WITH SCHEMA BINDING AS SELECT * FROM emp;
– The view ignores adding a column to the base table
> ALTER TABLE emp ADD COLUMN bonus SMALLINT;
> SELECT * FROM emp_v;
name income
---- ------
-- The view tolerates narrowing the underlying type
> CREATE OR REPLACE TABLE emp(name STRING, income SMALLINT, bonus SMALLINT);
> SELECT typeof(income) FROM emp_v;
INTEGER
– The view does not tolerate widening the underlying type
CREATE OR REPLACE TABLE emp(name STRING, income BIGINT, bonus SMALLINT);
> SELECT typeof(income) FROM emp_v;
Error
– Create a view with SCHEMA COMPENSATION
> CREATE TABLE emp(name STRING, income SMALLINT, bonus SMALLINT);
> CREATE VIEW emp_v WITH SCHEMA COMPENSATION AS SELECT * FROM emp;
-- The view tolerates widening the underlying type but keeps its own signature fixed
CREATE OR REPLACE TABLE emp(name STRING, income INTEGER, bonus INTEGER);
> SELECT typeof(income) FROM emp_v;
INTEGER
-- The view does not tolerate dropping a needed column
ALTER TABLE emp DROP COLUMN bonus;
> SELECT * FROM emp_v;
Error
– Create a view with SCHEMA EVOLUTION
> CREATE TABLE emp(name STRING, income SMALLINT);
> CREATE VIEW emp_v WITH SCHEMA EVOLUTION AS SELECT * FROM emp;
-- The view picks up additional columns
> ALTER TABLE emp ADD COLUMN bonus SMALLINT
> SELECT * FROM emp_v;
name income bonus
---- ------ -----
-- The view picks up renamed columns as well
> ALTER TABLE emp RENAME COLUMN income TO salary SMALLINT;
> SELECT * FROM emp_v;
name salary bonus
---- ------ -----
-- The view picks up changes to column types and dropped columns
> CREATE OR REPLACE TABLE emp(name STRING, salary BIGINT);
> SELECT *, typeof(salary)AS salary_type FROM emp_v;
name salary
---- ------
-- Create a view using a default collation of UTF8_BINARY
> CREATE VIEW v DEFAULT COLLATION UTF8_BINARY
AS SELECT 5::STRING AS text;
-- Creates a Metric View as specified in the YAML definition, with three dimensions and four measures representing the count of orders.
> CREATE OR REPLACE VIEW region_sales_metrics
(month COMMENT 'Month order was made',
status,
order_priority,
count_orders COMMENT 'Count of orders',
total_Revenue,
total_revenue_per_customer,
total_revenue_for_open_orders)
WITH METRICS
LANGUAGE YAML
COMMENT 'A Metric View for regional 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: prder_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)
- name: total_revenue_for_open_orders
expr: SUM(o_totalprice) filter (where o_orderstatus='O')
$$;
> 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
total_revenue_for_open_orders decimal(28,2) measure
# Detailed Table Information
Catalog main
Database default
Table region_sales_metrics
Owner alf@melmak.et
Created Time Thu May 15 13:03:01 UTC 2025
Last Access UNKNOWN
Created By Spark
Type METRIC_VIEW
Comment A Metric View for regional sales metrics.
Use Remote Filtering false
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)
- name: Total_Revenue_for_Open_Orders
expr: SUM(o_totalprice) filter (where o_orderstatus='O')
"
Language YAML
Table Properties [metric_view.from.name=samples.tpch.orders, metric_view.from.type=ASSET, metric_view.where=o_orderdate > '1990-01-01']
-- Tracking total_revenue_per_customer by month in 1995
> SELECT extract(month from month) as month,
measure(total_revenue_per_customer)::bigint AS total_revenue_per_customer
FROM region_sales_metrics
WHERE extract(year FROM month) = 1995
GROUP BY ALL
ORDER BY ALL;
month total_revenue_per_customer
----- --------------------------
1 167727
2 166237
3 167349
4 167604
5 166483
6 167402
7 167272
8 167435
9 166633
10 167441
11 167286
12 167542
-- Tracking total_revenue_per_customer by month and status in 1995
> SELECT extract(month from month) as month,
status,
measure(total_revenue_per_customer)::bigint AS total_revenue_per_customer
FROM region_sales_metrics
WHERE extract(year FROM month) = 1995
GROUP BY ALL
ORDER BY ALL;
month status total_revenue_per_customer
----- --------- --------------------------
1 Fulfilled 167727
2 Fulfilled 161720
2 Open 40203
2 Processing 193412
3 Fulfilled 121816
3 Open 52424
3 Processing 196304
4 Fulfilled 80405
4 Open 75630
4 Processing 196136
5 Fulfilled 53460
5 Open 115344
5 Processing 196147
6 Fulfilled 42479
6 Open 160390
6 Processing 193461
7 Open 167272
8 Open 167435
9 Open 166633
10 Open 167441
11 Open 167286
12 Open 167542