تغيير طريقة العرض

ينطبق على: Databricks SQL Databricks Runtime

تغيير بيانات التعريف المقترنة بالعرض. يمكنه تغيير تعريف طريقة العرض، وتغيير اسم طريقة العرض إلى اسم مختلف، وتعيين بيانات تعريف طريقة العرض وإلغاء تعيينها عن طريق تعيين TBLPROPERTIES.

إذا تم تخزين طريقة العرض مؤقتا، يقوم الأمر بمسح البيانات المخزنة مؤقتا من طريقة العرض وكافة التوابع الخاصة بها التي تشير إليها. سيتم ملء ذاكرة التخزين المؤقت لعرض بشكل كبير عند الوصول إلى طريقة العرض في المرة التالية. يترك الأمر توابع طريقة العرض على أنها غير موصولة.

بناء الجملة

ALTER VIEW view_name
  { rename |
    SET TBLPROPERTIES clause |
    UNSET TBLPROPERTIES clause |
    alter_body |
    schema_binding |
    owner_to |
    SET TAGS clause |
    UNSET TAGS clause }

rename
  RENAME TO to_view_name

alter_body
  AS query

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

property_key
  { idenitifier [. ...] | string_literal }

owner_to
  [ SET ] OWNER TO principal

المعلمات

• view_name

  يحدد طريقة العرض التي سيتم تغييرها. إذا تعذر العثور على طريقة العرض، فإن Azure Databricks يثير خطأ TABLE_OR_VIEW_NOT_FOUND .

• إعادة التسمية إلى to_view_name

  إعادة تسمية طريقة العرض الموجودة داخل المخطط. لا يمكن إعادة تسمية طرق العرض المجسدة.

  يحدد to_view_name الاسم الجديد لعرض . to_view_name إذا كان موجودا بالفعل، TableAlreadyExistsException يتم طرح . إذا كان to_view_name مؤهلا، فيجب أن يتطابق مع اسم view_name مخطط .

• تعيين TBLPROPERTIES

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

• إلغاء تعيين TBLPROPERTIES

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

• استعلام AS

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

  هذه العبارة تعادل عبارة CREATE OR REPLACE VIEW في طريقة عرض موجودة، باستثناء أنه يتم الاحتفاظ بالامتيازات الممنوحة في طريقة العرض.

• schema_binding

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

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

• [ SET ] المالك إلى الأساسي

  نقل ملكية طريقة العرض إلى principal. ما لم يتم تعريف طريقة العرض في hive_metastore ، يمكنك فقط نقل الملكية إلى مجموعة تنتمي إليها.

  ينطبق على: Databricks SQL Databricks Runtime 11.3 LTS وما فوق

  SET مسموح به ككلمة أساسية اختيارية.

• SET TAGS ( { tag_name = tag_value } [, ...] )

  تطبيق العلامات على طريقة العرض. يجب أن يكون لديك APPLY TAG إذن لإضافة علامات إلى طريقة العرض.

  ينطبق على: Databricks SQL Databricks Runtime 13.3 LTS وما فوق

• UNSET TAGS ( tag_name [, ...] )

  إزالة العلامات من الجدول. يجب أن يكون لديك APPLY TAG إذن لإزالة العلامات من طريقة العرض.

  ينطبق على: Databricks SQL Databricks Runtime 13.3 LTS وما فوق

• tag_name

  قيمة حرفية STRING. tag_name يجب أن يكون فريدا داخل طريقة العرض.

• tag_value

  قيمة حرفية STRING.

الأمثلة

-- Rename only changes the view name.
-- The source and target schemas of the view have to be the same.
-- Use qualified or unqualified name for the source and target view.
> ALTER VIEW tempsc1.v1 RENAME TO tempsc1.v2;

-- Verify that the new view is created.
> DESCRIBE TABLE EXTENDED tempsc1.v2;
                            c1       int   NULL
                            c2    string   NULL

  # Detailed Table Information
                      Database   tempsc1
                         Table        v2

-- Before ALTER VIEW SET TBLPROPERTIES
> DESCRIBE TABLE EXTENDED tempsc1.v2;
                            c1       int   null
                            c2    string   null

  # Detailed Table Information
                      Database   tempsc1
                         Table        v2
              Table Properties    [....]

-- Set properties in TBLPROPERTIES
> ALTER VIEW tempsc1.v2 SET TBLPROPERTIES ('created.by.user' = "John", 'created.date' = '01-01-2001' );

-- Use `DESCRIBE TABLE EXTENDED tempsc1.v2` to verify
> DESCRIBE TABLE EXTENDED tempsc1.v2;
                            c1                                                   int   NULL
                            c2                                                string   NULL

  # Detailed Table Information
                      Database                                               tempsc1
                         Table                                                    v2
              Table Properties [created.by.user=John, created.date=01-01-2001, ....]

-- Remove the key created.by.user and created.date from `TBLPROPERTIES`
> ALTER VIEW tempsc1.v2 UNSET TBLPROPERTIES (`created`.`by`.`user`, created.date);

-- Use `DESCRIBE TABLE EXTENDED tempsc1.v2` to verify the changes
> DESCRIBE TABLE EXTENDED tempsc1.v2;
                            c1       int   NULL
                            c2    string   NULL

  # Detailed Table Information
                      Database   tempsc1
                         Table        v2
              Table Properties    [....]

-- Change the view definition
> ALTER VIEW tempsc1.v2 AS SELECT * FROM tempsc1.v1;

-- Use `DESCRIBE TABLE EXTENDED` to verify
> DESCRIBE TABLE EXTENDED tempsc1.v2;
                            c1                        int   NULL
                            c2                     string   NULL

  # Detailed Table Information
                      Database                    tempsc1
                         Table                         v2
                          Type                       VIEW
                     View Text   select * from tempsc1.v1
            View Original Text   select * from tempsc1.v1

-- Transfer ownership of a view to another user
> ALTER VIEW v1 OWNER TO `alf@melmak.et`

-- Change the view schema binding to adopt type evolution
> ALTER VIEW v1 WITH SCHEMA TYPE EVOLUTION;

-- Applies three tags to the view named `test`.
> ALTER VIEW test SET TAGS ('tag1' = 'val1', 'tag2' = 'val2', 'tag3' = 'val3');

-- Removes three tags from the view named `test`.
> ALTER VIEW test UNSET TAGS ('tag1', 'tag2', 'tag3');

المقالات ذات الصلة

• وصف الجدول
• CREATE VIEW
• إنشاء طريقة عرض مجسدة
• إسقاط عرض
• إظهار طرق العرض