Aracılığıyla paylaş

ŞEMAYı DEĞIŞTIRME

  • Makale

Şunlar için geçerlidir:onay işareti evet olarak işaretlenmiş Databricks SQL onay işareti evet olarak işaretlenmiş Databricks Runtime

Bir şemanın sahibini değiştirir, tahmine dayalı iyileştirme davranışını ayarlar veya ayarlayarak DBPROPERTIESşemayla ilişkili meta verileri değiştirir. Belirtilen özellik değerleri, aynı özellik adına sahip mevcut değerleri geçersiz kılar.

ve DATABASE kullanımı SCHEMA birbirinin yerine kullanılabilir olsa da SCHEMA tercih edilir.

Sözdizimi

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

Parametreler

  • Schema_name

    Değiştirilecek şemanın adı. Şema bulunamazsa Azure Databricks bir SCHEMA_NOT_FOUND hatası oluşturur.

  • DBPROPERTIES ( anahtar = val [, ...] )

    Ayarlanacak veya ayardan kaldırılacak şema özellikleri.

  • [ SET ] SAHIPDEN sorumluya

    Şemanın sahipliğini öğesine aktarır principal.

    Ş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 } [, ...] )

    Şemaya etiket uygulama. Şemaya bir etiket uygulamanız gerekir use_schema .

    Ş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 [, ...] )

    Şemadan etiketleri kaldırın. Şemadan bir etiketi kaldırmanız gerekir use_schema .

    Ş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. tag_name şeması 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ş Yalnızca Databricks SQL onay işareti evet olarak işaretlenmiş Databricks Runtime 12.2 LTS ve üzeri onay işareti evet olarak işaretlenmiş Unity Kataloğu

    Önemli

    Bu özellik Genel Önizlemededir.

    Şemayı istenen tahmine dayalı iyileştirme ayarıyla değiştirir. Varsayılan olarak, şemalar oluşturulduğunda davranış INHERIT katalogdan yapılır. Varsayılan olarak, şemada oluşturulan yeni nesneler ayarı şemadan devralır.

    Şema değiştirilirse, davranış tahmine dayalı iyileştirmeyi devralan tüm nesnelere art arda eklenir. Açıkça ENABLE veya DISABLE tahmine dayalı iyileştirme yapan nesneler şema ayarından etkilenmez.

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

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

Örnekler

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