ALTER CATALOG

  • Makale

Şunlar için geçerlidir:onay işareti evet olarak işaretlenmiş Yalnızca Databricks SQL onay işareti evet olarak işaretlenmiş Databricks Runtime 10.4 LTS ve üzeri onay işareti evet olarak işaretlenmiş Unity Kataloğu

Kataloğun sahipliğini yeni bir sorumluya aktarır, bir kataloğa etiketler uygular veya katalog için tahmine dayalı iyileştirmeyi etkinleştirir veya devre dışı bırakır.

Sözdizimi

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

Parametreler

  • Catalog_name

    Değiştirilecek kataloğun adı. Ad sağlamazsanız varsayılan değer olur hive_metastore.

  • [ SET ] SAHIPDEN sorumluya

    Kataloğun sahipliğini öğesine principalaktarır.

    Şunlar için geçerlidir:onay işareti evet olarak işaretlenmiş Databricks SQL onay işareti evet olarak işaretlenmiş Databricks Runtime 11.3 LTS ve üzeri

    SET isteğe bağlı anahtar sözcük olarak izin verilir.

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

    Etiketleri kataloğa uygulayın. Bir kataloğa etiket uygulama izniniz olmalıdır use_catalog . Bkz . KATALOĞU KULLANMA.

    Şunlar için geçerlidir:onay işareti evet olarak işaretlenmiş Databricks SQL onay işareti evet olarak işaretlenmiş Databricks Runtime 13.3 LTS ve üzeri

  • ETIKETLERIN KÜMESINI KALDıR ( tag_name [, ...] )

    Etiketleri katalogdan kaldırın. Bir kataloğa etiket uygulama izniniz olmalıdır use_catalog .

    Şunlar için geçerlidir:onay işareti evet olarak işaretlenmiş Databricks SQL onay işareti evet olarak işaretlenmiş Databricks Runtime 13.3 LTS ve üzeri

  • tag_name

    Değişmez değer STRING. katalog tag_name içinde benzersiz olmalıdır.

  • tag_value

    Değişmez değer STRING.

  • { ETKİnLEŞTİr | DEVRE DIŞI BIRAKIN | DEVRAL } TAHMINE DAYALı IYILEŞTIRME

    Şunlar için geçerlidir:onay işareti evet olarak işaretlenmiş Databricks SQL onay işareti evet olarak işaretlenmiş Databricks Runtime 12.2 LTS ve üzeri

    Önemli

    Bu özellik Genel Önizlemededir.

    Kataloğu istenen tahmine dayalı iyileştirme ayarıyla değiştirir. Varsayılan olarak, kataloglar oluşturulduğunda davranış INHERIT hesaptan yapılır. Varsayılan olarak, katalogda oluşturulan yeni nesneler ayarı katalogdan devralır.

    Katalog değiştirilirse, davranış tahmine dayalı iyileştirmeyi devralan tüm şemalara ve nesnelerine art arda eklenir. Şemalardaki tahmine dayalı iyileştirmeyi devralmayan nesneler veya açıkça ENABLE veya DISABLE tahmine dayalı iyileştirmeyi devralmayan nesneler katalog ayarından etkilenmez.

    Bir katalog için tahmine dayalı iyileştirmeyi ayarlamak için kullanıcının katalog üzerinde izni olmalıdır CREATE .

    Yalnızca Delta Olmayan Paylaşım, Unity Kataloğu'ndaki yönetilen kataloglar tahmine dayalı iyileştirme için uygundur.

Örnekler

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