Condividi tramite

CREATE VIEW

Si applica a:check contrassegnato come sì controllo SQL di Databricks contrassegnato come sì Databricks Runtime

Costruisce una tabella virtuale senza dati fisici in base al set di risultati di una query SQL o a una vista metrica basata su una specifica yaml. ALTER VIEW e DROP VIEW modificano solo i metadati.

Per eseguire questa istruzione, è necessario essere un amministratore del metastore o avere privilegi USE CATALOG e USE SCHEMA sul catalogo e sullo schema, insieme a privilegi CREATE TABLE nello schema di destinazione.

L'utente che esegue questo comando diventerà il proprietario della visualizzazione.

Sintassi

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

Parametri

  • O SOSTITUISCI

    Se esiste già una visualizzazione con lo stesso nome, viene sostituita. Per sostituire una visualizzazione esistente, è necessario esserne il proprietario.

    La sostituzione di una vista esistente non mantiene i privilegi concessi nella visualizzazione originale o nell'oggetto table_id. Usare ALTER VIEW per mantenere i privilegi.

    CREATE OR REPLACE VIEW view_name equivale a DROP VIEW IF EXISTS view_name seguito da CREATE VIEW view_name.

  • PROVVISORIO

    TEMPORARY le visualizzazioni sono visibili solo alla sessione che le ha create e vengono eliminate al termine della sessione.

  • GLOBAL TEMPORARY

    Si applica a:check contrassegnato come sì Databricks Runtime

    GLOBAL TEMPORARY le viste sono associate a uno schema global_temptemporaneo mantenuto dal sistema.

  • SE NON ESISTE

    Crea la visualizzazione solo se non esiste. Se esiste già una vista con questo nome, l'istruzione CREATE VIEW viene ignorata.

    È possibile specificare al massimo uno di IF NOT EXISTS o OR REPLACE.

  • view_name

    Nome della vista appena creata. Il nome di una visualizzazione temporanea non deve essere qualificato. Il nome completo della vista deve essere univoco.

    I nomi di visualizzazione creati in hive_metastore possono contenere solo caratteri ASCII alfanumerici e caratteri di sottolineatura (INVALID_SCHEMA_OR_RELATION_NAME).

  • METRICHE

    Si applica a:selezionato con sì Databricks SQL selezionato con sì Databricks Runtime 16.4 e versioni successive selezionato con sì solo per Unity Catalog

    Identifica la visualizzazione come visualizzazione delle metriche. La vista deve essere definita con LANGUAGE YAML e il corpo della vista deve essere una specifica yaml valida.

    Questa clausola non è supportata per le visualizzazioni temporanee.

    Una visualizzazione delle metriche non supporta le clausole DEFAULT COLLATION e schema_binding.

    La specifica YAML della visualizzazione metrica definisce dimensions e measures. dimensions sono le colonne della vista attraverso cui l'invoker può aggregare le misure, mentre measures definisce le aggregazioni della vista.

    Chi richiama una vista metrica utilizza l'espressione measure per accedere alle misure definite della vista invece di specificare le funzioni di aggregazione.

  • schema_binding

    Si applica a:check contrassegnato con sì Databricks Runtime 15.3 e versioni successive

    Facoltativamente, specifica il modo in cui la vista si adatta alle modifiche allo schema della query a causa di modifiche apportate alle definizioni degli oggetti sottostanti.

    Questa clausola non è supportata per le visualizzazioni temporanee, le visualizzazioni delle metriche o le viste materializzate.

    • SCHEMA RILEGATURA

      La vista diventerà non valida se l'elenco di colonne della query cambia, a meno che non si verifichino le seguenti condizioni:

      • L'elenco di colonne include una clausola asterisco e ci sono colonne aggiuntive. Queste colonne aggiuntive vengono ignorate.
      • Il tipo di una o più colonne è stato modificato in modo che consenta un cast sicuro ai tipi di colonna originali usando regole di cast implicite.

      Questo è il comportamento predefinito.

    • SCHEMA COMPENSAZIONE

      La vista non sarà valida se l'elenco di colonne di query cambia, eccetto nei casi seguenti:

      • L'elenco di colonne include una clausola asterisco e ci sono colonne aggiuntive. Queste colonne aggiuntive vengono ignorate.
      • Il tipo di una o più colonne è stato modificato in modo tale da consentire il cast ai tipi di colonna originali utilizzando regole di cast ANSI esplicite.

    • SCHEMA EVOLUZIONE DEL TIPO

      La vista adotterà eventuali modifiche ai tipi nell'elenco di colonne di query nella propria definizione quando il compilatore SQL rileva tale modifica in risposta a un riferimento alla vista.

    • SCHEMA EVOLUZIONE

      • Questa modalità si comporta come SCHEMA TYPE EVOLUTIONe adotta anche modifiche nei nomi di colonna o nelle colonne aggiunte ed eliminate se la vista non include un column_listesplicito.
      • La vista diventerà invalida solo se la query non può più essere analizzata o se la vista facoltativa column_list non corrisponde più al numero di espressioni nella lista di selezione query.

  • column_list

    Etichetta le colonne nel risultato della query della visualizzazione, facoltativamente. Se si specifica un elenco di colonne, il numero di alias di colonna deve corrispondere al numero di espressioni nella query o, per le visualizzazioni delle metriche, la specifica YAML. Nel caso in cui nessun elenco di colonne sia specificato, gli alias vengono derivati dal corpo della visualizzazione.

    • column_alias

      Gli alias di colonna devono essere univoci.

    • column_comment

      Valore letterale facoltativo STRING che descrive l'alias di colonna.

  • view_comment

    Valore letterale facoltativo STRING che fornisce commenti a livello di visualizzazione.

  • REGOLE DI CONFRONTO PREDEFINITE collation_name

    Si applica a:contrassegnato con segno di spunta Databricks SQL contrassegnato con segno di spunta Databricks Runtime 16.3 e versioni successive

    Definisce le regole di confronto predefinite da usare all'interno di query. Se non specificato, la collazione predefinita è UTF8_BINARYa.

    Questa clausola non è supportata per le visualizzazioni delle metriche.

  • TBLPROPERTIES

    Facoltativamente, imposta una o più proprietà definite dall'utente.

  • AS Query

    Query che costruisce la vista da tabelle di base o da altre viste.

    Questa clausola non è supportata per le visualizzazioni delle metriche.

  • AS $$ yaml_string $$

    Specifica yaml che definisce una visualizzazione metrica.

Esempi

-- 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_p_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_p_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