إنشاء طريقة عرض

ينطبق على: وضع علامة Databricks SQL وضع علامة Databricks Runtime

إنشاء جدول ظاهري لا يحتوي على بيانات فعلية استنادا إلى مجموعة نتائج استعلام SQL. ALTER VIEW وتغيير DROP VIEW بيانات التعريف فقط.

بناء الجملة

CREATE [ OR REPLACE ] [ TEMPORARY ] VIEW [ IF NOT EXISTS ] view_name
    [ column_list ]
    [ schema_binding ]
    [ COMMENT view_comment ]
    [ TBLPROPERTIES clause ]
    AS query

schema_binding
   WITH SCHEMA { BINDING | COMPENSATION | [ TYPE ] EVOLUTION }

column_list
   ( { column_alias [ COMMENT column_comment ] } [, ...] )

المعلمات

  • أو استبدال

    إذا كانت طريقة عرض الاسم نفسه موجودة بالفعل، يتم استبدالها. لاستبدال طريقة عرض موجودة، يجب أن تكون مالكها.

    لا يحافظ استبدال طريقة عرض موجودة على الامتيازات الممنوحة في طريقة العرض الأصلية. استخدم ALTER VIEW للحفاظ على الامتيازات.

  • مؤقت

    تكون طرق العرض المؤقتة مرئية فقط لجلسة العمل التي أنشأتها ويتم إسقاطها عند انتهاء جلسة العمل.

  • مؤقت عمومي

    ينطبق على: وضع علامة Databricks Runtime

    ترتبط طرق العرض المؤقتة العمومية بمخطط global_tempمؤقت محفوظ من قبل النظام .

  • إذا لم يكن موجودا

    إنشاء طريقة العرض فقط إذا لم تكن موجودة. إذا كانت طريقة عرض بهذا الاسم موجودة بالفعل، CREATE VIEW يتم تجاهل العبارة.

    يمكنك تحديد واحد على الأكثر من IF NOT EXISTS أو OR REPLACE.

  • view_name

    اسم طريقة العرض التي تم إنشاؤها حديثا. يجب ألا يكون اسم طريقة العرض المؤقتة مؤهلا. يجب أن يكون اسم طريقة العرض المؤهل بالكامل فريدا.

    يمكن أن تحتوي طرق العرض التي تم إنشاؤها في hive_metastore على أحرف ASCII أبجدية رقمية فقط وتسطير أسفل السطر (INVALID_SCHEMA_OR_RELATION_NAME).

  • schema_binding

    ينطبق على: وضع علامة Databricks Runtime 15.3 وما فوق

    يحدد اختياريا كيفية تكيف طريقة العرض مع التغييرات في مخطط الاستعلام بسبب التغييرات في تعريفات الكائنات الأساسية.

    هذه العبارة غير معتمدة لطرق العرض المؤقتة أو طرق العرض المجسدة.

    • مع ربط المخطط

      ستصبح طريقة العرض غير صالحة إذا تغيرت قائمة أعمدة الاستعلام باستثناء الشروط التالية:

      • تتضمن قائمة الأعمدة عبارة نجمية، وهناك أعمدة إضافية. يتم تجاهل هذه الأعمدة الإضافية.
      • تم تغيير نوع عمود واحد أو أكثر بطريقة تسمح لها بأن يتم تحويلها بأمان إلى أنواع الأعمدة الأصلية باستخدام قواعد التحويل الضمنية.

      هذا هو السلوك الافتراضي.

    • مع تعويض المخطط

      ستصبح طريقة العرض غير صالحة إذا تغيرت قائمة أعمدة الاستعلام باستثناء الشروط التالية:

      • تتضمن قائمة الأعمدة عبارة نجمية، وهناك أعمدة إضافية. يتم تجاهل هذه الأعمدة الإضافية.
      • تم تغيير نوع عمود واحد أو أكثر بطريقة تسمح بصبها على أنواع الأعمدة الأصلية باستخدام قواعد تحويل ANSI الصريحة.
    • مع تطور نوع المخطط

      ستعتمد طريقة العرض أي تغييرات على الأنواع في قائمة أعمدة الاستعلام في تعريفها الخاص عندما يكتشف المحول البرمجي SQL مثل هذا التغيير استجابة لمرجع إلى طريقة العرض.

    • مع تطور المخطط

      • يتصرف هذا الوضع مثل WITH SCHEMA TYPE EVOLUTION، ويتبنى أيضا تغييرات في أسماء الأعمدة أو الأعمدة المضافة والمسقطة إذا لم تتضمن طريقة العرض بشكل صريح column_list.
      • ستصبح طريقة العرض غير صالحة فقط إذا لم يعد من الممكن تحليل الاستعلام، أو إذا لم تعد طريقة العرض column_list الاختيارية تطابق عدد التعبيرات في query قائمة التحديد.
  • column_list

    تسمية الأعمدة في نتيجة الاستعلام الخاصة بطريقة العرض اختياريا. إذا قمت بتوفير قائمة أعمدة، يجب أن يتطابق عدد الأسماء المستعارة للعمود مع عدد التعبيرات في الاستعلام. في حالة عدم تحديد قائمة أعمدة، يتم اشتقاق الأسماء المستعارة من نص طريقة العرض.

    • column_alias

      يجب أن تكون الأسماء المستعارة للعمود فريدة.

    • column_comment

      قيمة حرفية اختيارية STRING تصف الاسم المستعار للعمود.

  • view_comment

    قيمة حرفية اختيارية STRING توفر تعليقات على مستوى العرض.

  • TBLPROPERTIES

    تعيين خاصية واحدة أو أكثر من الخصائص المعرفة من قبل المستخدم اختياريا.

  • استعلام AS

    استعلام يقوم بإنشاء طريقة العرض من الجداول الأساسية أو طرق العرض الأخرى.

الأمثلة

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