UBAH KATALOG

  • Artikel

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

Mentransfer kepemilikan katalog ke perwakilan baru, menerapkan tag ke katalog, atau mengaktifkan atau menonaktifkan pengoptimalan prediktif untuk katalog.

Sintaks

ALTER CATALOG [ catalog_name ]
 { [ SET ] OWNER TO principal
   SET TAGS ( { tag_name = tag_value } [, ...] ) |
   UNSET TAGS ( tag_name [, ...] ) } |
   { ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION }

Parameter

  • catalog_name

    Nama katalog yang akan diubah. Jika Anda tidak menyediakan nama, hive_metastore adalah default.

  • [ SET ] OWNER TO principal

    Mentransfer kepemilikan katalog 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 katalog. Anda harus memiliki use_catalog izin untuk menerapkan tag ke katalog. Lihat MENGGUNAKAN KATALOG.

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

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

    Hapus tag dari katalog. Anda harus memiliki use_catalog izin untuk menerapkan tag ke katalog.

    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 katalog.

  • tag_value

    Harfiah STRING.

  • { AKTIFKAN | NONAKTIFKAN | MEWARISI } PENGOPTIMALAN PREDIKTIF

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

    Penting

    Fitur ini ada di Pratinjau Publik.

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

    Jika katalog diubah, perilaku akan berskala ke semua skema dan objeknya, yang mewarisi pengoptimalan prediktif. Objek dalam skema yang tidak mewarisi pengoptimalan prediktif atau objek yang secara ENABLE eksplisit atau DISABLE prediktif pengoptimalan tidak terpengaruh oleh pengaturan katalog.

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

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

Contoh

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