تغيير الكتالوج

  • مقالة

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

نقل ملكية كتالوج إلى كيان جديد، أو تطبيق العلامات على كتالوج، أو تمكين التحسين التنبؤي للكتالوج أو تعطيله.

بناء الجملة

ALTER CATALOG [ catalog_name ]
 { [ SET ] OWNER TO principal
   SET TAGS ( { tag_name = tag_value } [, ...] ) |
   UNSET TAGS ( tag_name [, ...] ) } |
   { ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION }

المعلمات

  • catalog_name

    اسم الكتالوج الذي سيتم تغييره. إذا لم تقدم أي اسم، فإن الاسم الافتراضي هو hive_metastore.

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

    نقل ملكية الكتالوج إلى principal.

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

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

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

    تطبيق العلامات على الكتالوج. يجب أن يكون لديك use_catalog إذن لتطبيق علامة على كتالوج. راجع استخدام الكتالوج.

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

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

    إزالة العلامات من الكتالوج. يجب أن يكون لديك use_catalog إذن لتطبيق علامة على كتالوج.

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

  • tag_name

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

  • tag_value

    قيمة حرفية STRING.

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

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

    هام

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

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

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

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

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

الأمثلة

-- Creates a catalog named `some_cat`.
> CREATE CATALOG some_cat;

-- Transfer ownership of the catalog to another user
> ALTER CATALOG some_cat OWNER TO `alf@melmak.et`;

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

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

–– Enables predictive optimization for catalog main
> ALTER CATALOG main ENABLE PREDICTIVE OPTIMIZATION;
> DESCRIBE CATALOG EXTENDED main;
  Key                        value
  ------------------------    ---------
  < other rows of describe extended >
  Predictive Optimization    ENABLE

-- Sets catalog main to inherit setting from parent object (metastore)
> ALTER CATALOG main INHERIT PREDICTIVE OPTIMIZATION;
> DESCRIBE CATALOG EXTENDED main;
  Key                         value
  ------------------------    ----------------------------------------
  < other rows of describe extended >
  Predictive Optimization     ENABLE (inherited from METASTORE metastore_name)