ALTER SCHEMA

  • Artikel

Berlaku untuk:centang ditandai ya Databricks SQL centang ditandai ya Databricks Runtime

Mengubah pemilik skema, mengatur perilaku pengoptimalan prediktif, atau mengubah metadata yang terkait dengan skema dengan mengatur DBPROPERTIES. Nilai properti yang ditentukan mengambil alih nilai yang ada dengan nama properti yang sama.

Meskipun penggunaan SCHEMA dan DATABASE dapat dipertukarkan, SCHEMA lebih disukai.

Sintaks

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

Parameter

  • schema_name

    Nama skema yang akan diubah. Jika skema tidak dapat ditemukan, Azure Databricks menimbulkan kesalahan SCHEMA_NOT_FOUND .

  • DBPROPERTIES ( key = val [, …] )

    Properti skema yang akan diatur atau tidak diatur.

  • [ SET ] OWNER TO principal

    Mentransfer kepemilikan skema ke principal.

    Berlaku untuk:centang ditandai ya Databricks SQL centang ditandai ya Databricks Runtime 11.3 LTS ke atas

    SET diperbolehkan sebagai kata kunci opsional.

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

    Terapkan tag ke skema. Anda harus use_schema menerapkan tag ke skema.

    Berlaku untuk:centang ditandai ya Databricks SQL centang ditandai ya Databricks Runtime 13.3 LTS ke atas

  • UNSET TAGS ( tag_name [, ...] )

    Hapus tag dari skema. Anda harus use_schema menghapus tag dari skema.

    Berlaku untuk:centang ditandai ya Databricks SQL centang ditandai ya Databricks Runtime 13.3 LTS ke atas

  • tag_name

    Harfiah STRING. tag_name harus unik dalam skema.

  • tag_value

    Harfiah STRING.

  • { AKTIFKAN | NONAKTIFKAN | MEWARISI } PENGOPTIMALAN PREDIKTIF

    Berlaku untuk:centang ditandai ya Databricks SQL centang ditandai ya Databricks Runtime 12.2 LTS dan di atas centang ditandai ya Unity Catalog saja

    Penting

    Fitur ini ada di Pratinjau Publik.

    Mengubah skema ke pengaturan pengoptimalan prediktif yang diinginkan. Secara default, ketika skema dibuat, perilakunya adalah dari INHERIT katalog. Secara default, objek baru yang dibuat dalam skema akan mewarisi pengaturan dari skema.

    Jika skema diubah, perilaku akan bersifat kaskade ke semua objek yang mewarisi pengoptimalan prediktif. Objek yang secara ENABLE eksplisit atau DISABLE pengoptimalan prediktif tidak terpengaruh oleh pengaturan skema.

    Untuk mengatur pengoptimalan prediktif untuk skema, pengguna harus memiliki CREATE izin pada skema.

    Hanya skema dalam Berbagi non-Delta, katalog terkelola di Unity Catalog yang memenuhi syarat untuk pengoptimalan prediktif.

Contoh

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