適用対象:
、Databricks、SQL
、Databricksランタイム。
SQL クエリの結果セットまたは yaml 仕様に基づくメトリック ビューに基づいて、物理データを持たない仮想テーブルを構築します。 ALTER VIEW そして DROP VIEW はメタデータだけを変更する。
このステートメントを実行するには、メタストア管理者であるか、ターゲット スキーマのUSE CATALOG権限と共に、カタログとスキーマに対するUSE SCHEMAおよびCREATE TABLE権限を持っている必要があります。
このコマンドを実行しているユーザーは、ビューの所有者になります。
Warning
CHAR また、 VARCHAR の長さセマンティクス( CHAR(n) スペースパディングを含む)はテーブル境界でのみ適用されます。 ビューは、変更されずに渡された列に対してのみ保持されます。列の式 ( CAST、関数、エイリアス、追加されたコメントなど) は、プレーンな STRINGを返します。
CHAR値はスペース埋め込みであるため、比較はベース テーブルとは異なる場合があります。 たとえば、 CHAR(10) 値 'COLLEGE' は 'COLLEGE 'として格納されるため、 column = 'COLLEGE' はテーブルの true を返しますが、ビューを介して false します。
構文
-- Query-backed or metric view
CREATE [ OR REPLACE ] [ [ GLOBAL ] TEMPORARY ] VIEW [ IF NOT EXISTS ] view_name
[ column_list ]
[ with_clause |
COMMENT view_comment |
DEFAULT COLLATION collation_name |
TBLPROPERTIES clause |
{ COPY | NOCOPY } * |
LANGUAGE YAML ] [...]
AS { query | $$ yaml_string $$ }
-- Temporary view backed by a data source
CREATE [ OR REPLACE ] [ GLOBAL ] TEMPORARY VIEW [ IF NOT EXISTS ] view_name
[ column_list ]
USING data_source [ OPTIONS ( option_key [ = ] option_value [, ...] ) ]
with_clause
WITH { { schema_binding | METRICS } |
( { schema_binding | METRICS } [, ...] } )
schema_binding
WITH SCHEMA { BINDING | COMPENSATION | [ TYPE ] EVOLUTION }
column_list
( { column_alias [ COMMENT column_comment ] } [, ...] )
パラメーター
または置き換え
同じ名前のビューが既に存在する場合は、そのビューが置き換えられます。 交換するには所有者か、 MANAGE がビューにいる必要があります。 ビューを置き換えたユーザーが新しい所有者となります。
Unity Catalog管理ビューの場合、
COPY *条項またはNOCOPY *条項を使って、付与、コメント、タグなど既存のビューのメタデータを保持するかどうかを制御します。その他の見解については、それを置き換えても元の見解や
table_idで付与された特権は保持されず、DROP VIEW IF EXISTS view_nameの後に続くのと同じくCREATE VIEW view_name。 ALTER VIEWを使って、その権限を失わずにその場でビューを変更できます。一時的な
TEMPORARYビューは作成したセッションにのみ表示され、セッション終了時に削除されます。system.sessionスキーマ内で一時的なビューが作成されます。グローバル・テンポラリー
適用対象:
はい Databricks ランタイムGLOBAL TEMPORARYビューはシステムに保存された一時スキーマsystem.global_tempに紐づけられています。 名前をglobal_tempとして付けることも可能です。存在しない場合
存在しない場合にのみビューを作成します。 この名前のビューが既に存在する場合、
CREATE VIEWステートメントは無視されます。IF NOT EXISTSかOR REPLACEのいずれか 1 つだけを指定できます。-
新しく作成されたビューの名前。
名前が条件付けされていなければ、現在のスキーマで永続的なビューが作成されます。
- 永続ビュー:Databricks SQL および Databricks Runtime 19 以降では、ターゲットスキーマを選択するために PATH は使用されません。
-
一時表示:Databricks SQL および Databricks Runtime 18.0 以降では、名前を
system.sessionまたはsessionでのみ限定できます。 グローバル一時的なビューはsystem.global_tempまたはglobal_tempのみ認定できます。 以前のバージョンでは、一時的なビューの名前は限定されてはいけません。
完全修飾のビュー名は一意にする必要があります。
hive_metastoreで作成されたビュー名には、英数字の ASCII 文字とアンダースコア (INVALID_SCHEMA_OR_RELATION_NAME) のみを含めることができます。 指標
適用対象:
] Databricks SQL
] Databricks ランタイム 16.4 以上
Unity カタログのみビューをメトリック ビューとして識別します。 ビューは
LANGUAGE YAMLで定義する必要があり、ビューの本文は有効な yaml 仕様である必要があります。Databricks Runtime 17.2 より前のバージョンでは、この句は一時ビューではサポートされていません。
メトリック ビューでは、
DEFAULT COLLATION句とschema_binding句はサポートされていません。メトリック ビューの YAML 仕様では、
dimensions、measures、および省略可能なparametersが定義されます。dimensionsは、呼び出し元がメジャーを集計できるビューの列であり、measuresはビューの集計を定義します。メトリック ビューの呼び出し側は、集計関数を指定する代わりに、 メジャー 式を使用して定義されたメジャーにアクセスします。
Important
この機能は パブリック プレビュー段階です。
必要に応じて、YAML 仕様では、呼び出し側がクエリ時にバインドする名前付き値という
parametersを定義します。 各パラメーターには、名前、データ型、および省略可能な既定値があります。dimensions式とmeasures式の名前でパラメーターを参照し、テーブル値関数としてビューにクエリを実行するときに、名前付き引数として値を渡します。 パラメーターには、Databricks Runtime 18.2 以降が必要です。 YAML 構文については、 パラメーターを参照してください。schema_binding
対象:
Databricks ランタイム 15.3 以上オプションで、基礎となるオブジェクト定義の変更によるクエリのスキーマの変更にビューがどのように適応するかを指定します。
この句は、一時ビュー、メトリック ビュー、または具体化されたビューではサポートされていません。
SCHEMA バインド
次の条件を除き、クエリ列リストが変更されると、ビューは無効になります。
- 列リストには star 句が含まれており、追加の列があります。 これらの追加の列は無視されます。
- 暗黙的なキャスト ルールを使用して元の列の型に安全にキャストできる方法で 1 つ以上の列の方が変更されました。
SCHEMA 報酬
次の条件を除き、クエリ列リストが変更されると、ビューは無効になります。
- 列リストには star 句が含まれており、追加の列があります。 これらの追加の列は無視されます。
- 明示的な ANSI のキャスト ルールを使用して元の列の型にキャストできる方法で 1 つ以上の列の型が変更されました。
これが既定の動作です。
SCHEMA タイプ進化
ビューは、SQL コンパイラがビューへの参照に応じてこのような変更を検出したときに、クエリ列リスト内の型に対する変更を独自の定義に採用します。
SCHEMA 進化
- このモードは
SCHEMA TYPE EVOLUTIONのように動作し、ビューに明示的なcolumn_listが含まれていない場合は、列名、列コメント、または追加および削除された列の変更も採用します。 - クエリが解析できなくなった場合、またはオプションのビュー
column_listがquery選択リストの式数と一致しなくなった場合にのみビューが無効になります。
- このモードは
Note
SCHEMA TYPE EVOLUTIONまたはSCHEMA EVOLUTIONモードのUnityカタログビューには、クエリの出力と一致しなくなる保存スキーマが存在する場合があります。 そのようなビューがクエリされると、Azure Databricksはクエリユーザーとして保存されたスキーマを更新します。 更新に失敗した場合、クエリは FAILED_UPDATE_VIEW_SCHEMA エラーを返します。 Unity Catalog は、ビューオーナーまたは権限を強制する compute からの更新のみを受け入れます。 その結果、ビューを所有していないユーザーからのクエリは、保存されたスキーマが更新されるまで 専用のコンピュート で失敗することがあります。カタログがワークスペースに読み取り専用としてバインドされている場合、そのワークスペース内の専用コンピュートは、ビュー所有者であっても保存されたスキーマを更新できません。 その場合は、権限を強制する compute からビューをクエリするか、カタログへの読み書きアクセスを持つワークスペースから以下の所有者手順を実行します。
この失敗を防ぐには、次のいずれかを実行します。
- サーバーレス計算、 標準アクセスモード 計算、またはSQLウェアハウスのいずれかに権限を強制するビューをクエリします。 標準アクセスモードの計算にはDatabricks Runtime 17.1.1以上が必要です。
- 基盤となるスキーマが変更された後にビューオーナーにビューをクエリさせます。 所有者のクエリは、保存されたスキーマを更新します。
-
ALTER VIEW ...クエリプリンシパルが所属するグループに OWNER TO を OWNER TO で移転します。 ビュー所有者または
MANAGE権限を持つユーザーは、自分が所属するグループにのみ所有権を移転できます。 クエリを行っているユーザーなど、他のプリンシパルに所有権を移転できるのはメタストア管理者のみです。 ビューに対するクエリは所有者の権限を使用するため、新しい所有者はビューの基盤オブジェクトに対して必要な権限を持つ必要があります。 - ビューの所有者にビューを
SCHEMA BINDINGに変更してもらうか、ALTER VIEW でSCHEMA COMPENSATIONするよう依頼してください。 その後、ビューはスキーマの変更を採用するのを停止します。 変更が新しいモードと互換性がない場合、無効になります。
column_list
必要に応じて、ビューのクエリ結果内の列にラベルを付けます。 列リストを指定する場合、列エイリアスの数はクエリ内の式の数と一致する必要があります。メトリック ビューの場合は YAML 仕様です。 列リストが指定されていない場合、別名はビューの本体から引き出されます。
-
列の別名は一意にする必要があります。
column_comment
列のエイリアスを示す省略可能な
STRING文字列リテラルです。
-
view_comment
ビューレベルのコメントを提供する省略可能な
STRING文字列リテラルです。デフォルトの照合 順序collation_name
対象:
」 Databricks SQL
」 Databricks ランタイム 16.3 以上query内で使用する既定の照合順序を定義します。 指定しない場合、既定の照合順序は、ビューが作成されるスキーマから派生します。この句は、メトリック ビューではサポートされていません。
-
必要に応じて、1 つ以上のユーザー定義プロパティを設定します。
コピー * または NOCOPY *
適用対象:
Databricks SQL
Databricks ランタイム 18.3 以上
Unity カタログのみ既存のビューを
OR REPLACEに置き換えても、その既存ビューのメタデータ(付与、コメント、タグなど)が保持されるかどうかを制御します。- COPY * は既存のビューのメタデータを保持します。
- NOCOPY * は既存のビューのメタデータを削除します。 置き換えは新しい定義のメタデータのみを保持します。
サポートされているのは
*形式のみであり、この節は保存可能なメタデータのすべてのカテゴリに適用され、部分集合には適用されません。 この条項はUnity Catalog管理ビューのみ、しかもOR REPLACEでのみサポートされます。 他のビューで使うとエラーが発生します。節を省略すると、デフォルトは実行時間に依存します:
- Databricks Runtime 18.3では、既存のビューのメタデータは保持されず、
NOCOPY *と同様に保存されません。 保存COPY *を指定します。 - Databricks Runtime 19以降では、既存のビューのメタデータはデフォルトで保持されており、
COPY *と同じです。NOCOPY *をドロップするかどうかを指定してください。
AS クエリ
ベース テーブルまたはその他のビューからビューを構築するクエリです。
Databricks SQLおよびDatabricks Runtime 19以降では、永続的なビューは作成時にセッション PATH を取得し、このクエリ内の無条件の名前をそのキャプチャされたパスに対して解決します。呼び出し元のセッションパスではありません。
current_path()クエリ内のcurrent_schema()は依然として呼び出し者のセッション値を返します。 「 捕獲されたパス」を参照してください。この句は、メトリック ビューではサポートされていません。
AS $$ yaml_string $$
メトリック ビューを定義する yaml 仕様。
data_sourceの使用
クエリではなくデータソースでビューを直接裏付けるため、テーブルを定義せずにファイルをクエリできます。 この条項は
TEMPORARYおよびGLOBAL TEMPORARYの視点にのみ対応されており、ASと組み合わせることはできません。data_sourceファイル形式でなければなりません。CSV、JSON、PARQUET、AVRO、ORC、またはTEXTなどです。 サポートされているファイル形式の全リストについては、[ CREATE TABLE [USING]をご覧ください。オプション
ファイル
path、ファイルにheaderがあるかどうか、パーサmodeなど、1つ以上のデータソースオプションをキーと値のペアとして設定します。 各フォーマットでサポートされているオプションについては、対応するフォーマットの参照を参照してください。例えば 、CSVファイルのRead and Writeなどです。
例
-- 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;
-- Replace a Unity Catalog view while preserving its grants, comments, and tags.
> CREATE OR REPLACE VIEW experienced_employee COPY *
AS SELECT id, name, department
FROM all_employee
WHERE working_years > 5;
-- Replace the same view but drop its existing metadata, keeping only the new definition.
> CREATE OR REPLACE VIEW experienced_employee NOCOPY *
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 temporary view over a CSV file so you can query it with SQL.
> CREATE TEMPORARY VIEW diamonds
USING CSV
OPTIONS (path '/databricks-datasets/Rdatasets/data-001/csv/ggplot2/diamonds.csv',
header 'true',
mode 'FAILFAST');
> SELECT carat, cut, price FROM diamonds LIMIT 5;
-- 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']
-- Create a parameterized metric view (requires DBR 18.2 and above)
-- The `discount` parameter is bound at query time and referenced in a measure.
> CREATE OR REPLACE VIEW discounted_sales_metrics
WITH METRICS
LANGUAGE YAML
AS $$
version: 1.1
source: samples.tpch.orders
parameters:
- name: discount
data_type: double
default: 0
dimensions:
- name: order_priority
expr: o_orderpriority
measures:
- name: discounted_revenue
expr: SUM((1 - discount) * o_totalprice)
$$;
-- Query the parameterized metric view, passing `discount` as a named argument
> SELECT order_priority, measure(discounted_revenue)
FROM discounted_sales_metrics(discount => 0.15)
GROUP BY ALL;
-- Omit the argument to use the default value of 0
> SELECT order_priority, measure(discounted_revenue)
FROM discounted_sales_metrics
GROUP BY ALL;
-- 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