Bagikan melalui

CREATE VIEW

Berlaku untuk:centang ditandai ya Databricks SQL centang ditandai ya Databricks Runtime

Membuat tabel virtual yang tidak memiliki data fisik berdasarkan kumpulan hasil kueri SQL atau tampilan metrik berdasarkan spesifikasi yaml. ALTER VIEW dan DROP VIEW hanya mengubah metadata.

Untuk menjalankan pernyataan ini, Anda harus menjadi administrator metastore atau memiliki USE CATALOG hak istimewa dan USE SCHEMA pada katalog dan skema, bersama dengan CREATE TABLE hak istimewa dalam skema target.

Pengguna yang menjalankan perintah ini akan menjadi pemilik tampilan.

Sintaks

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

Parameter

  • ATAU GANTIKAN

    Jika tampilan dengan nama yang sama sudah ada, nama tampilan tersebut akan diganti. Untuk mengganti tampilan yang ada, Anda harus menjadi pemiliknya.

    Mengganti tampilan yang ada tidak mempertahankan hak istimewa yang diberikan pada tampilan asli atau table_id. Gunakan ALTER VIEW untuk mempertahankan hak istimewa.

    CREATE OR REPLACE VIEW view_name setara dengan DROP VIEW IF EXISTS view_name diikuti oleh CREATE VIEW view_name.

  • SEMENTARA

    TEMPORARY tampilan hanya terlihat oleh sesi yang membuatnya dan dihilangkan saat sesi berakhir.

  • GLOBAL SEMENTARA

    Berlaku untuk:centang ditandai ya Databricks Runtime

    GLOBAL TEMPORARY tampilan terkait dengan skema sementara yang dipertahankan sistem global_temp.

  • JIKA BELUM ADA

    Membuat tampilan hanya jika tidak ada. Jika tampilan dengan nama ini sudah ada, pernyataan CREATE VIEW diabaikan.

    Anda dapat menentukan paling banyak salah satu IF NOT EXISTS atau OR REPLACE.

  • view_name

    Nama tampilan baru yang dibuat. Nama tampilan sementara tidak boleh diberi kualifikasi. Nama tampilan yang sepenuhnya memenuhi syarat harus unik.

    Nama tampilan yang dibuat di hive_metastore hanya dapat berisi karakter ASCII alfanumerik dan garis bawah (_) (INVALID_SCHEMA_OR_RELATION_NAME).

  • METRIK

    Berlaku untuk:ditandai ya Databricks SQL ditandai ya Databricks Runtime 16.4 ke atas ditandai ya Unity Catalog saja

    Mengidentifikasi tampilan sebagai tampilan metrik. Tampilan harus didefinisikan dengan LANGUAGE YAML dan isi tampilan harus berupa spesifikasi yaml yang valid.

    Sebelum Databricks Runtime 17.2, klausul ini tidak didukung untuk tampilan sementara.

    Tampilan metrik tidak mendukung DEFAULT COLLATION klausa dan schema_binding .

    Spesifikasi YAML dari tampilan metrik menentukan dimensions dan measures. dimensions adalah kolom tampilan tempat pemanggil dapat mengagregasi pengukuran, sementara measures menentukan agregasi tampilan.

    Pemanggil tampilan metrik menggunakan ekspresi pengukuran untuk mengakses tampilan yang ditentukan, bukan menentukan fungsi agregasi.

  • schema_binding

    Berlaku untuk:centang ditandai ya Databricks Runtime 15.3 ke atas

    Secara opsional menentukan bagaimana tampilan beradaptasi dengan perubahan pada skema kueri karena perubahan dalam definisi objek yang mendasar.

    Klausa ini tidak didukung untuk tampilan sementara, tampilan metrik, atau tampilan materialisasi.

    • SCHEMA MENGIKAT

      Tampilan akan menjadi tidak valid jika daftar kolom kueri berubah kecuali untuk kondisi berikut:

      • Daftar kolom menyertakan klausa bintang, dan ada kolom tambahan. Kolom tambahan ini diabaikan.
      • Jenis satu atau beberapa kolom berubah sehingga dapat diubah dengan aman ke jenis kolom asli menggunakan aturan transmisi implisit.

    • SCHEMA KOMPENSASI

      Tampilan akan menjadi tidak valid jika daftar kolom kueri berubah kecuali untuk kondisi berikut:

      • Daftar kolom menyertakan klausa bintang, dan ada kolom tambahan. Kolom tambahan ini diabaikan.
      • Jenis satu atau beberapa kolom berubah dengan cara yang memungkinkan kolom tersebut diubah ke jenis kolom asli menggunakan aturan kast ANSI eksplisit.

      Ini adalah perilaku default.

    • SCHEMA JENIS EVOLUSI

      Tampilan akan mengadopsi perubahan apa pun pada jenis dalam daftar kolom kueri ke dalam definisinya sendiri ketika pengkompilasi SQL mendeteksi perubahan seperti itu sebagai respons terhadap referensi ke tampilan.

    • SCHEMA EVOLUSI

      • Mode ini berprilaku seperti SCHEMA TYPE EVOLUTION, dan juga mengadopsi perubahan dalam nama kolom atau kolom yang ditambahkan dan dihilangkan jika tampilan tidak menyertakan eksplisit column_list.
      • Tampilan hanya akan menjadi tidak valid jika kueri tidak lagi dapat diurai, atau tampilan column_list opsional tidak cocok dengan jumlah ekspresi dalam daftar pilih query lagi.

  • column_list

    Secara opsional, beri label pada kolom dalam hasil kueri tampilan. Jika Anda menyediakan daftar kolom, jumlah alias kolom harus cocok dengan jumlah ekspresi dalam kueri atau, untuk tampilan metrik, spesifikasi YAML. Jika tidak ada daftar kolom yang ditentukan, alias berasal dari isi tampilan.

    • column_alias

      Alias kolom harus unik.

    • column_comment

      Literal opsional STRING yang menjelaskan alias kolom.

  • view_comment

    Literal opsional STRING yang menyediakan komentar pada tingkat tampilan.

  • KOLASI DEFAULT collation_name

    Berlaku untuk:bercentang ya Databricks SQL bercentang ya Databricks Runtime 16.3 ke atas

    Menentukan kolatasi default yang akan digunakan dalam query. Jika tidak ditentukan, kolaborasi default berasal dari skema tempat tampilan dibuat.

    Klausa ini tidak didukung untuk tampilan metrik.

  • TBLPROPERTIES

    Secara opsional, atur satu atau beberapa properti yang ditentukan pengguna.

  • AS kueri

    Kueri yang membuat tampilan dari tabel dasar atau tampilan lainnya.

    Klausa ini tidak didukung untuk tampilan metrik.

  • AS $$ yaml_string $$

    Spesifikasi yaml yang menentukan tampilan metrik.

Contoh

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