مشاركة عبر

ALTER SCHEMA

  • مقالة

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

تغيير مالك المخطط أو تعيين سلوك التحسين التنبؤي أو تغيير بيانات التعريف المقترنة بمخطط عن طريق تعيين DBPROPERTIES. تتجاوز قيم الخاصية المحددة أي قيمة موجودة بنفس اسم الخاصية.

في حين أن استخدام SCHEMA و DATABASE قابل للتبديل، SCHEMA يفضل.

بناء الجملة

ALTER SCHEMA schema_name
   { SET DBPROPERTIES ( { key = val } [, ...] ) |
    [ SET ] OWNER TO principal
    SET TAGS ( { tag_name = tag_value } [, ...] ) |
    UNSET TAGS ( tag_name [, ...] ) |
    { ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION } }

المعلمات

  • schema_name

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

  • DBPROPERTIES ( مفتاح = val [, ...] )

    خصائص المخطط المراد تعيينها أو إلغاء تعيينها.

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

    نقل ملكية المخطط إلى principal.

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

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

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

    تطبيق العلامات على المخطط. يجب عليك use_schema تطبيق علامة على المخطط.

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

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

    إزالة العلامات من المخطط. يجب use_schema عليك إزالة علامة من المخطط.

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

  • tag_name

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

  • tag_value

    قيمة حرفية STRING.

  • { ENABLE | تعطيل | INHERIT } تحسين تنبؤي

    ينطبق على:وضع علامة Databricks SQL وضع علامة Databricks Runtime 12.2 LTS وما فوق وضع علامة كتالوج Unity فقط

    هام

    هذه الميزة في المعاينة العامة.

    تغيير المخطط إلى إعداد التحسين التنبؤي المطلوب. بشكل افتراضي، عند إنشاء المخططات، يكون السلوك من INHERIT الكتالوج. بشكل افتراضي، سترث الكائنات الجديدة التي تم إنشاؤها في المخطط الإعداد من المخطط.

    إذا تم تغيير المخطط، فسيتالي السلوك إلى كافة الكائنات التي ترث التحسين التنبؤي. لا تتأثر الكائنات التي بشكل صريح ENABLE أو DISABLE تنبؤي بالتحسين بإعداد المخطط.

    لتعيين التحسين التنبؤي لمخطط، يجب أن يكون لدى CREATE المستخدم إذن على المخطط.

    المخططات فقط في المشاركة غير المتعلقة ب Delta، والكتالوجات المدارة في كتالوج Unity مؤهلة للتحسين التنبؤي.

الأمثلة

-- Creates a schema named `inventory`.
> CREATE SCHEMA inventory;

-- Alters the schema to set properties `Edited-by` and `Edit-date`.
> ALTER SCHEMA inventory SET DBPROPERTIES ('Edited-by' = 'John', 'Edit-date' = '01/01/2001');

-- Verify that properties are set.
> DESCRIBE SCHEMA EXTENDED inventory;
 database_description_item                 database_description_value
 ------------------------- ------------------------------------------
             Database Name                                  inventory
               Description
                  Location    file:/temp/spark-warehouse/inventory.db
                Properties ((Edit-date,01/01/2001), (Edited-by,John))

-- Transfer ownership of the schema to another user
> ALTER SCHEMA inventory OWNER TO `alf@melmak.et`

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

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

-- Enables predictive optimization for objects in schema my_schema
> ALTER SCHEMA my_schema ENABLE PREDICTIVE OPTIMIZATION;