ALTER CATALOG
Şunlar için geçerlidir: Yalnızca Databricks SQL Databricks Runtime 10.4 LTS ve üzeri 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
-
Değiştirilecek kataloğun adı. Ad sağlamazsanız varsayılan değer olur
hive_metastore
. -
Kataloğun sahipliğini öğesine
principal
aktarır.Şunlar için geçerlidir: Databricks SQL 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: Databricks SQL 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: Databricks SQL Databricks Runtime 13.3 LTS ve üzeri
tag_name
Değişmez değer
STRING
. katalogtag_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: Databricks SQL Databricks Runtime 12.2 LTS ve üzeri
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
veyaDISABLE
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)