ALTER CATALOG

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

Kataloğun sahipliğini yeni bir sorumluya aktarır, kataloğun yönetilen depolama konumunu değiştirir, bir kataloğa etiketler uygular, bir katalog için tahmine dayalı iyileştirmeyi etkinleştirir veya devre dışı bırakır ya da bırakılan yönetilen tablolar için kurtarma süresini ayarlar.

Important

Parola veya belirteç gibi bir kimlik bilgilerini taşıyan katalog seçeneklerini, bunların güvenliğini sağlamak için ayarladığınızdasecret, değişmez değeri doğrudan yan tümcesine girmek yerine işlevini kullanarak OPTIONS değeri sağlayın. Bu, deyiminize kimlik bilgisi değeri dahil olmak yerine Databricks gizli dizi hizmetinde depolanan bir gizli diziye başvurmanızı sağlar.

Sözdizimi

ALTER CATALOG [ catalog_name ]
 { DEFAULT COLLATION default_collation_name |
   [ SET ] OWNER TO principal
   SET TAGS ( { tag_name = tag_value } [, ...] ) |
   UNSET TAGS ( tag_name [, ...] ) |
   { ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION |
   OPTIONS (option value [, ...] ) |
   SET MANAGED LOCATION location |
   [ SET ] RETAIN DROPPED TO number { HOUR | HOURS | DAY | DAYS | WEEK | WEEKS } }

Parametreler

  • catalog_name

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

  • VARSAYıLAN HARMANLAMA default_collation_name

    Şunun için geçerlidir:evet olarak işaretlendi Databricks SQL denetimi evet olarak işaretlendi Databricks Runtime 17.1 ve üzeri

    Katalogda tanımlanan yeni şemalar için varsayılan harmanlamayı değiştirir. Katalogdaki mevcut şemaların ve nesnelerin varsayılan harmanlaması değiştirilmez.

  • [ SET ] SAHİBİ principal

    Kataloğun sahipliğini principal'a devreder.

    Ş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 ETİKETLER ( { tag_name = tag_value } [, ...] )

    Etiketleri kataloğa uygulayın. Bir kataloğa etiket uygulamak için USE CATALOG izniniz olmalıdır. Bkz. 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

  • ETİKETLERİ TEMİZLE ( tag_name [, ...] )

    Etiketleri katalogdan kaldırın. Bir kataloğa etiket uygulamak için USE CATALOG izniniz olmalıdır.

    Ş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

    Tam bir STRING. tag_name katalog içinde benzersiz olmalıdır.

  • tag_value

    Tam bir STRING.

  • { ETKİNLEŞTİR | DEVRE DIŞI BIRAK | DEVRAL } TAHMİNE DAYALI İYİLEŞTİRME

    Ş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

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

    Katalog değiştirildiğinde, davranış, tahmine dayalı optimizasyonu devralan tüm şemalara ve nesnelerine zincirleme biçimde yansır. Şemalardaki tahmine dayalı iyileştirmeyi devralmayan nesneler veya açıkça ENABLE veya DISABLE tahmine dayalı iyileştirme nesneler, katalog ayarından etkilenmez.

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

    Unity Kataloğu'nda yalnızca OpenSharing olmayan, yönetilen kataloglar tahmine dayalı iyileştirme için uygundur.

  • SEÇENEKLER

    Kataloğa özgü parametreleri ayarlar. Mevcut seçenek listesini yeni bir seçenek listesiyle değiştirir.

    Hive meta veri deposu federasyonu kullanılarak oluşturulan yabancı kataloglar için OPTIONS'i ayarlamak amacıyla authorized paths'ı kullanın.

    • seçenek

      Özellik anahtarı. Anahtar, nokta ile ayrılmış bir veya daha fazla tanımlayıcı veya bir STRING literal değerden oluşabilir.

      Özellik anahtarları benzersiz olmalı ve büyük/küçük harfe duyarlı olmalıdır.

    • değer

      bir özelliğin değeri. Değer bir BOOLEAN, STRING, INTEGERveya DECIMALsabit ifadesi olmalıdır.

  • SET YÖNETİLEMİ KONUMU

    Şunun için geçerlidir:evet olarak işaretlendi Databricks SQL denetimi evet olarak işaretlendi Databricks Runtime 18.1 ve üzeri denetim evet yalnızca Unity Kataloğu olarak işaretlendi

    Kataloğun yönetilen depolama konumunu değiştirir. Katalogda oluşturulan yeni yönetilen tablolar ve yönetilen birimler güncelleştirilmiş konumu kullanır. Databricks var olan nesneleri taşımaz.

    • lokasyon

      Yeni yönetilen depolama konumu için bulut depolama yolu. Bir dış konumda yer almalıdır.

  • [ SET ] BıRAKıLANı { HOUR | numarasıNA KADAR KORUYUN SAAT | GÜN | GÜN | HAFTA | HAFTALAR }

    Şunun için geçerlidir:evet olarak işaretlendi Databricks Runtime 17.3 ve üzeri onay onay işareti evet yalnızca Unity Kataloğu

    Important

    Bu özellik Genel Önizleme aşamasındadır.

    Katalogda bırakılan yönetilen tablolar için kurtarma süresini ayarlar. Bırakılan tabloların kurtarılma süresi komutuyla UNDROP TABLE gerçekleştirilir. Varsayılan değer 7 gündür. Değer 0 saat (kurtarmayı devre dışı bırakmak için) veya 7-30 gün (dahil) arasında olmalıdır.

    Kurtarma süresini 0 olarak ayarlamak, bırakılan tabloların kullanılarak UNDROP kurtarılmaması ve veri dosyalarının 48 saat içinde bulut depolama alanından silinmesi anlamına gelir.

    Bir alt şemada da kurtarma süresi ayarlanırsa, şema düzeyi ayarı bu şemadaki tablolar için önceliklidir. Bu ayar yalnızca kurtarma dönemi yapılandırıldıktan sonra bırakılan tablolar için geçerlidir. Kurtarma süresi sona erdikten sonra, yönetilen tablolara ait veri dosyaları 48 saat içinde bulut depolama alanınızdan silinir.

    SET isteğe bağlı anahtar sözcük olarak izin verilir. MANAGE Katalogda ayrıcalık veya sahiplik gerektirir. Ayrıca bkz . Yönetilen tabloyu bırakma.

Ö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');

-- Change the default collation of a catalog to case sensitive unicode
> ALTER CATALOG test DEFAULT COLLATION UNICODE_CS;

-- Adds an authorized path to a foreign catalog created using :re[HMS] federation.
> ALTER CATALOG my_federated_catalog OPTIONS (authorized_paths 'path/to/dir1, path/to/dir2');

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

-- Change the managed storage location of a catalog
> ALTER CATALOG my_catalog SET MANAGED LOCATION 's3://my-bucket/managed/';

-- Set a 30-day recovery period for dropped managed tables in a catalog
> ALTER CATALOG my_catalog RETAIN DROPPED TO 30 DAYS;

-- Set the recovery period to 0 (tables are not recoverable after drop)
> ALTER CATALOG my_catalog SET RETAIN DROPPED TO 0 DAYS;
  • Last updated on