CREATE VIEW

適用対象:チェックマーク、はい 、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 つだけを指定できます。

  • view_name

    新しく作成されたビューの名前。

    名前が条件付けされていなければ、現在のスキーマで永続的なビューが作成されます。

    • 永続ビュー: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_alias

      列の別名は一意にする必要があります。

    • column_comment

      列のエイリアスを示す省略可能な STRING 文字列リテラルです。

  • view_comment

    ビューレベルのコメントを提供する省略可能な STRING 文字列リテラルです。

  • デフォルトの照合 順序collation_name

    対象:チェックマークが「はい 」 Databricks SQL チェック 「はい 」 Databricks ランタイム 16.3 以上

    query内で使用する既定の照合順序を定義します。 指定しない場合、既定の照合順序は、ビューが作成されるスキーマから派生します。

    この句は、メトリック ビューではサポートされていません。

  • TBLPROPERTIES

    必要に応じて、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