Sdílet prostřednictvím

CREATE VIEW

Platí pro:zaškrtnuté ano Databricks SQL zaškrtnuté ano Databricks Runtime

Vytvoří virtuální tabulku, která nemá žádná fyzická data na základě sady výsledků dotazu SQL nebo zobrazení metriky na základě specifikace yaml. ALTER VIEW a DROP VIEW mění pouze metadata.

Chcete-li tento příkaz spustit, musíte být správcem metastoru nebo mít USE CATALOGUSE SCHEMA oprávnění ke katalogu a schématu spolu s oprávněními CREATE TABLE v cílovém schématu.

Uživatel, který tento příkaz spouští, se stane vlastníkem zobrazení.

Syntaxe

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 ] } [, ...] )

Parametry

  • NEBO NAHRADIT

    Pokud zobrazení stejného názvu již existuje, bude nahrazeno. Pokud chcete nahradit existující zobrazení, musíte být jeho vlastníkem.

    Nahrazení existujícího zobrazení nezachová oprávnění udělená v původním zobrazení nebo table_id. K zachování oprávnění použijte ALTER VIEW.

    CREATE OR REPLACE VIEW view_name je ekvivalentní k DROP VIEW IF EXISTS view_name následováno CREATE VIEW view_name.

  • DOČASNÝ

    TEMPORARY zobrazení jsou viditelná pouze pro relaci, která je vytvořila, a po skončení relace jsou odstraněna.

  • GLOBAL TEMPORARY

    Platí pro:zaškrtnuto ano Databricks Runtime

    GLOBAL TEMPORARY zobrazení jsou svázaná s dočasným schématem, které je zachováno systémem global_temp.

  • POKUD NEEXISTUJE

    Vytvoří zobrazení pouze v případě, že neexistuje. Pokud zobrazení podle tohoto názvu již existuje, CREATE VIEW příkaz je ignorován.

    Můžete zadat nejvýše jednu z IF NOT EXISTS nebo OR REPLACE.

  • view_name

    Název nově vytvořeného zobrazení Název dočasného zobrazení nesmí být kvalifikovaný. Plně kvalifikovaný název zobrazení musí být jedinečný.

    Názvy zobrazení vytvořené v hive_metastore mohou obsahovat pouze alfanumerické znaky ASCII a podtržítka (INVALID_SCHEMA_OR_RELATION_NAME).

  • METRIKY

    Platí pro:zaškrtnuto ano Databricks SQL zaškrtnuto ano Databricks Runtime 16.4 a vyšší zaškrtnuto ano pouze Unity Catalog

    Identifikuje zobrazení jako metriku. Zobrazení musí být definováno pomocí LANGUAGE YAML a tělo zobrazení musí být platnou yaml specifikací.

    Před modulem Databricks Runtime 17.2 se tato klauzule nepodporuje pro dočasná zobrazení.

    Zobrazení metrik nepodporuje DEFAULT COLLATION klauzule a schema_binding klauzule.

    Specifikace YAML zobrazení metriky definuje dimensions a measures. Jedná se dimensions o sloupce zobrazení, podle kterého může invoker agregovat míry, zatímco measures definuje agregace zobrazení.

    Invokér zobrazení metrik používá výraz measure pro přístup k definovaným opatřením zobrazení místo zadávání agregačních funkcí.

  • schema_binding

    Platí pro:zaškrtnuto ano Databricks Runtime 15.3 a vyšší

    Volitelně určuje, jak se zobrazení přizpůsobí změnám schématu dotazu kvůli změnám v definicích podkladových objektů.

    Tato klauzule není podporována pro dočasná zobrazení, zobrazení metrik nebo materializovaná zobrazení.

    • SCHEMA ZÁVAZNÝ

      Zobrazení bude neplatné, pokud se seznam sloupců dotazu změní s výjimkou následujících podmínek:

      • Seznam sloupců obsahuje hvězdicovou klauzuli a další sloupce. Tyto další sloupce se ignorují.
      • Typ jednoho nebo více sloupců se změnil způsobem, který umožňuje bezpečné přetypování na původní typy sloupců pomocí implicitních pravidel přetypování.

    • SCHEMA KOMPENZACE

      Zobrazení bude neplatné, pokud se seznam sloupců dotazu změní s výjimkou následujících podmínek:

      • Seznam sloupců obsahuje hvězdicovou klauzuli a další sloupce. Tyto další sloupce se ignorují.
      • Typ jednoho nebo více sloupců se změnil tak, že umožňuje přetypování na původní typy sloupců pomocí explicitních pravidel přetypování ANSI.

      Toto je výchozí chování.

    • SCHEMA VÝVOJ TYPŮ

      Zobrazení přijme všechny změny typů v seznamu sloupců dotazu do vlastní definice, když kompilátor SQL zjistí takovou změnu v reakci na odkaz na zobrazení.

    • SCHEMA EVOLUCE

      • Tento režim se chová jako SCHEMA TYPE EVOLUTIONa také přijímá změny v názvech sloupců nebo přidané a vyřazené sloupce, pokud zobrazení neobsahuje explicitní column_list.
      • Zobrazení bude neplatné pouze v případě, že už nelze dotaz analyzovat, nebo pokud nepovinné zobrazení column_list již neodpovídá počtu výrazů v seznamu výběru query.

  • column_list

    Volitelně označí sloupce ve výsledku dotazu zobrazení. Pokud zadáte seznam sloupců, musí se počet aliasů sloupců shodovat s počtem výrazů v dotazu nebo pro zobrazení metrik specifikace YAML. V případě, že není zadaný žádný seznam sloupců, se odvozují z textu zobrazení.

    • column_alias

      Aliasy sloupců musí být jedinečné.

    • column_comment

      Volitelný STRING literál popisující alias sloupce.

  • view_comment

    Volitelný STRING literál poskytující komentáře na úrovni zobrazení.

  • výchozí collation_name

    Platí pro:zaškrtnuto jako ano Databricks SQL zaškrtnuto jako ano Databricks Runtime 16.3 a vyšší

    V rámci querydefinuje výchozí kolaci, která se má použít. Pokud není zadáno, výchozí kolace je odvozena ze schématu, ve kterém je zobrazení vytvořeno.

    Tato klauzule není podporována pro zobrazení metrik.

  • TBLPROPERTIES

    Volitelně nastaví jednu nebo více uživatelem definovaných vlastností.

  • Dotaz AS

    Dotaz, který sestaví zobrazení ze základních tabulek nebo jiných zobrazení.

    Tato klauzule není podporována pro zobrazení metrik.

  • AS $$ yaml_string $$

    Specifikace YAML, která definuje pohled na metriky.

Příklady

-- 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
  • Last updated on