Partager via

CREATE VIEW

S’applique à :coché Databricks SQL coché Databricks Runtime

Construit une table virtuelle qui n’a pas de données physiques en fonction du jeu de résultats d’une requête SQL ou d’une vue de métrique basée sur une spécification yaml. ALTER VIEW et DROP VIEW modifient uniquement les métadonnées.

Pour exécuter cette instruction, vous devez être administrateur de metastore ou avoir des privilèges USE CATALOG et USE SCHEMA sur le catalogue et le schéma, ainsi que des privilèges CREATE TABLE dans le schéma cible.

L’utilisateur qui exécute cette commande deviendra le propriétaire de la vue.

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

Parameters

  • OU REMPLACER

    Si une vue du même nom existe déjà, elle est remplacée. Pour remplacer une vue existante, vous devez en être le propriétaire.

    Le remplacement d’une vue existante ne conserve pas les privilèges accordés sur la vue d’origine ou le table_id. Utilisez ALTER VIEW pour conserver les privilèges.

    CREATE OR REPLACE VIEW view_name équivaut à DROP VIEW IF EXISTS view_name suivi de CREATE VIEW view_name.

  • TEMPORARY

    TEMPORARY Les vues sont visibles uniquement pour la session qui les a créées et sont supprimées lorsque la session se termine.

  • GLOBAL TEMPORARY

    S’applique à :coché Databricks Runtime

    GLOBAL TEMPORARY les vues sont liées à un schéma global_temptemporaire conservé par le système.

  • SI N'EXISTE PAS

    Crée la vue uniquement si elle n’existe pas. Si une vue portant ce nom existe déjà, l’instruction CREATE VIEW est ignorée.

    Vous pouvez spécifier au maximum un seul des paramètres IF NOT EXISTS ou OR REPLACE.

  • view_name

    Nom de la vue nouvellement créée. Le nom d’une vue temporaire ne doit pas avoir de qualificatif. Le nom complet de la vue doit être unique.

    Les noms d’affichage créés dans hive_metastore ne peuvent contenir que des caractères ASCII alphanumériques et des traits de soulignement (INVALID_SCHEMA_OR_RELATION_NAME).

  • MÉTRIQUE

    S’applique à :coche marqué oui Databricks SQL coche marqué oui Databricks Runtime 16.4 et versions ultérieures coche marqué oui Unity Catalog uniquement

    Identifie la vue comme une vue métrique. La vue doit être définie avec LANGUAGE YAML et le corps de la vue doit être une spécification yaml valide.

    Avant Databricks Runtime 17.2, cette clause n’est pas prise en charge pour les vues temporaires.

    Une vue de métriques ne prend pas en charge les clauses DEFAULT COLLATION et schema_binding.

    La spécification YAML de la vue de métrique définit dimensions et measures. dimensions représentent les colonnes de la vue par lesquelles l'appelant peut agréger les mesures, alors que measures définit les agrégations de la vue.

    L’appelant d’une vue métrique utilise l’expression measure pour accéder aux mesures définies par les vues plutôt que de spécifier des fonctions d’agrégation.

  • schema_binding

    S’applique à :coché Databricks Runtime 15.3 et versions ultérieures

    Spécifie éventuellement comment la vue s’adapte aux modifications apportées au schéma de la requête du fait des modifications apportées aux définitions d’objet sous-jacentes.

    Cette clause n’est pas prise en charge pour les vues temporaires, les vues métriques ou les vues matérialisées.

    • SCHEMA RELIURE

      La vue devient non valide si la liste des colonnes de requête change, sauf dans les conditions suivantes :

      • La liste des colonnes inclut une clause « star » ainsi que des colonnes supplémentaires. Ces colonnes supplémentaires sont ignorées.
      • Le type d’une ou plusieurs colonnes a été modifié de manière à permettre leur transtypage en toute sécurité vers les types de colonnes d’origine à l’aide de règles de conversion implicites.

    • SCHEMA COMPENSATION

      La vue devient non valide si la liste des colonnes de requête change, sauf dans les conditions suivantes :

      • La liste des colonnes inclut une clause « star » ainsi que des colonnes supplémentaires. Ces colonnes supplémentaires sont ignorées.
      • Le type d’une ou plusieurs colonnes a été modifié de manière à permettre leur transtypage vers les types de colonnes d’origine à l’aide de règles de conversion ANSI explicites.

      Il s'agit du comportement par défaut.

    • SCHEMA ÉVOLUTION DE TYPE

      La vue adopte toutes les modifications apportées aux types de la liste de colonnes de requête dans sa propre définition lorsque le compilateur SQL détecte une telle modification en réponse à une référence à la vue.

    • SCHEMA ÉVOLUTION

      • Ce mode se comporte comme SCHEMA TYPE EVOLUTION. Il adopte également les modifications apportées aux noms de colonnes ou les colonnes ajoutées et supprimées si la vue n’inclut pas de column_list explicite.
      • La vue devient non valide uniquement si la requête ne peut plus être analysée ou si la vue facultative column_list ne correspond plus au nombre d’expressions dans la liste de sélection query.

  • column_list

    Étiquette au choix les colonnes dans le résultat de la requête de la vue. Si vous fournissez une liste de colonnes, le nombre d’alias de colonne doit correspondre au nombre d’expressions dans la requête ou, pour les vues de métriques, la spécification YAML. Si aucune liste de colonnes n’est spécifiée, les alias sont dérivés du corps de la vue.

    • column_alias

      Les alias de colonnes doivent être uniques.

    • column_comment

      Littéral STRING facultatif qui décrit l’alias de la colonne.

  • view_comment

    Littéral STRING facultatif qui fournit des commentaires au niveau de la vue.

  • CLASSEMENT PAR DÉFAUT collation_name

    S’applique à :coche marquée oui Databricks SQL coche marquée oui Databricks Runtime 16.3 et versions ultérieures

    Définit le classement par défaut à utiliser dans query. S’il n’est pas spécifié, le classement par défaut est dérivé du schéma dans lequel la vue est créée.

    Cette clause n'est pas prise en charge pour les vues métriques.

  • TBLPROPERTIES

    (Facultatif) Définit une ou plusieurs propriétés définies par l’utilisateur.

  • AS Requête

    Requête qui construit l’affichage à partir de tables de base ou d’autres affichages.

    Cette clause n'est pas prise en charge pour les vues métriques.

  • AS $$ yaml_string $$

    Une spécification YAML qui définit une vue métrique.

Exemples

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