ALTER SCHEMA

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

Şemanın sahibini değiştirir, şemanın yönetilen depolama konumunu değiştirir, tahmine dayalı iyileştirme davranışını ayarlar, ayarlayarak DBPROPERTIESşemayla ilişkili meta verileri değiştirir veya bırakılan yönetilen tablolar için kurtarma süresini ayarlar. Belirtilen özellik değerleri, aynı özellik adına sahip mevcut değerleri geçersiz kılar.

SCHEMA ve DATABASE değiştirilebilir şekilde kullanılabilirken, SCHEMA tercih edilir.

Sözdizimi

ALTER SCHEMA schema_name
    { DEFAULT COLLATION default_collation_name |
      SET DBPROPERTIES ( { key = val } [, ...] ) |
      [ SET ] OWNER TO principal
      SET TAGS ( { tag_name = tag_value } [, ...] ) |
      UNSET TAGS ( tag_name [, ...] ) |
      { ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION |
      SET MANAGED LOCATION location |
      [ SET ] RETAIN DROPPED TO number { HOUR | HOURS | DAY | DAYS | WEEK | WEEKS } }

Parametreler

schema_name

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

Şunun için geçerlidir: Databricks SQL Databricks Runtime 17.1 ve üzeri

Şema içinde tanımlanan yeni nesneler için varsayılan harmanlamayı değiştirir. Şemadaki mevcut nesnelerin varsayılan harmanlaması değiştirilmez.
DBPROPERTIES ( anahtar = val [, ...] )

Ayarlanacak veya ayardan kaldırılacak şema özellikleri.
[ SET ] SAHİBİNDEN ana

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

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

Şemaya etiket uygulama. Şemaya bir etiket uygulamanız gerekir USE SCHEMA .

Şunlar için geçerlidir: Databricks SQL Databricks Runtime 13.3 LTS ve üzeri
ETIKETLERİN KÜMESİNİ KALDIR ( tag_name [, ...] )

Şemadan etiketleri kaldırın. Şemadan bir etiketi kaldırmak için USE SCHEMA'e sahip olmanız gerekir.

Şunlar için geçerlidir: Databricks SQL 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 BIRAK | DEVİR AL } TAHMİNE DAYALI İYİLEŞTİRME

Şunlar için geçerlidir: Databricks SQL Databricks Runtime 12.2 LTS ve üzeri yalnızca Unity Katalog

Şemayı istenen tahmine dayalı iyileştirme ayarıyla değiştirir. Varsayılan olarak, şemalar oluşturulduğunda davranış INHERIT katalogdan seçmektir. 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 OpenSharing olmayan, Unity Kataloğu'ndaki yönetilen kataloglardaki şemalar tahmine dayalı iyileştirme için uygundur.
SET YÖNETİLEMİ KONUMU

Şunun için geçerlidir: Databricks SQL Databricks Runtime 18.1 ve üzeri

Standart şemanın yönetilen depolama konumunu değiştirir. Şemada 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: Databricks Runtime 17.3 ve üzeri yalnızca Unity Kataloğu

Önemli

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

Şemada bırakılan yönetilen tablolar için kurtarma süresini ayarlar; bırakılan tabloların kurtarılma süresi komutu kullanılarak UNDROP TABLE gerçekleştirilir. Varsayılan değer üst katalogdan devralır (ayarlanmadıysa 7 gün). 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.

Şema düzeyinde kurtarma süresi, şemadaki tablolar için herhangi bir katalog düzeyi ayarından ö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 Şemada ayrıcalık veya sahiplik gerektirir. Ayrıca bkz . Yönetilen tabloyu bırakma.

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

-- Alter the default collation of a schema
> ALTER SCHEMA my_schema DEFAULT COLLATION UNICODE_CI_AI;

-- Change the managed storage location of a schema
> ALTER SCHEMA my_catalog.my_schema SET MANAGED LOCATION 's3://my-bucket/schemas/my_schema/';

-- Set a 14-day recovery period for dropped managed tables in a schema
> ALTER SCHEMA my_catalog.my_schema RETAIN DROPPED TO 14 DAYS;

-- Set a 7-day recovery period (overrides any catalog-level setting)
> ALTER SCHEMA my_catalog.my_schema SET RETAIN DROPPED TO 7 DAYS;

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2026-06-24