ALTER CATALOG

Berlaku untuk:centang ditandai ya Databricks SQL centang ditandai ya Databricks Runtime 10.4 LTS ke atas centang ditandai ya hanya untuk Unity Catalog

Mentransfer kepemilikan katalog ke prinsip baru, mengubah lokasi penyimpanan terkelola katalog, menerapkan tag ke katalog, mengaktifkan atau menonaktifkan pengoptimalan prediktif untuk katalog, atau mengatur periode pemulihan untuk tabel terkelola yang dihilangkan.

Important

Saat Anda mengatur opsi katalog yang membawa kredensial, seperti kata sandi atau token, untuk menjaganya tetap aman, berikan nilai menggunakan secret fungsi daripada memasukkan nilai harfiah langsung dalam OPTIONS klausul. Ini memungkinkan Anda mereferensikan rahasia yang disimpan di layanan rahasia Databricks alih-alih menyertakan nilai kredensial dalam pernyataan Anda.

Sintaks

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

Parameter

  • catalog_name

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

  • KOLASI DEFAULT default_collation_name

    Berlaku untuk:check ditandai ya pemeriksaan Databricks SQL ditandai ya Databricks Runtime 17.1 ke atas

    Mengubah kolatasi default untuk skema baru yang ditentukan dalam katalog. Kolatasi default skema dan objek yang ada dalam katalog tidak diubah.

  • [ SET ] PEMILIK KE utama

    Memindahkan 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 izin USE CATALOG untuk menerapkan tag ke katalog. Lihat USE CATALOG.

    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 izin USE CATALOG untuk menerapkan tag ke katalog.

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

  • tag_name

    Secara harfiah STRING. tag_name harus unik dalam katalog.

  • tag_value

    Secara harfiah STRING.

  • { AKTIFKAN | NONAKTIFKAN | MEWARISI } PENGOPTIMALAN PREDIKTIF

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

    Mengubah katalog ke pengaturan pengoptimalan prediktif yang diinginkan. Secara default, saat katalog dibuat, perilakunya adalah INHERIT dari 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 eksplisit ditetapkan sebagai ENABLE atau DISABLE dalam pengoptimalan prediktif tidak terpengaruh oleh pengaturan katalog.

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

    Hanya katalog terkelola non-OpenSharing di Unity Catalog yang memenuhi syarat untuk pengoptimalan prediktif.

  • OPSI

    Mengatur parameter yang spesifik untuk katalog. Mengganti daftar opsi yang ada dengan daftar opsi baru.

    Gunakan OPTIONS untuk mengatur authorized paths untuk katalog asing yang dibuat menggunakan federasi metastore Hive.

    • pilihan

      Kunci untuk properti. Kunci dapat terdiri dari satu atau beberapa pengidentifikasi yang dipisahkan oleh titik, atau STRING harfiah.

      Kunci properti harus unik dan sensitif terhadap huruf besar dan kecil.

    • nilai

      Nilai dari properti. Nilai harus berupa BOOLEANekspresi , STRING, INTEGER, atau DECIMALkonstanta.

  • SET Lokasi TERKELOLA

    Berlaku untuk:check ditandai ya pemeriksaan Databricks SQL ditandai ya Databricks Runtime 18.1 ke atas centang ditandai ya Unity Catalog saja

    Mengubah lokasi penyimpanan terkelola untuk katalog. Tabel terkelola baru dan volume terkelola yang dibuat di katalog menggunakan lokasi yang diperbarui. Databricks tidak memindahkan objek yang ada.

    • Lokasi

      Jalur penyimpanan cloud untuk lokasi penyimpanan terkelola baru. Ini harus terkandung dalam lokasi eksternal.

  • [ SET ] PERTAHANKAN DIJATUHKAN KE nomor { HOUR | JAM | HARI | HARI | MINGGU | MINGGU }

    Berlaku untuk:check ditandai ya Databricks Runtime 17.3 ke atas centang ditandai ya Unity Catalog saja

    Important

    Fitur ini ada di Pratinjau Umum.

    Mengatur periode pemulihan untuk tabel terkelola yang dihilangkan dalam katalog, periode di mana tabel yang dihilangkan dapat dipulihkan menggunakan UNDROP TABLE perintah . Defaultnya adalah 7 hari. Nilainya harus 0 jam (untuk menonaktifkan pemulihan) atau antara 7–30 hari, inklusif.

    Mengatur periode pemulihan ke 0 berarti tabel yang dihilangkan tidak dapat dipulihkan menggunakan UNDROP dan file data dihapus dari penyimpanan cloud dalam waktu 48 jam.

    Jika periode pemulihan juga diatur pada skema anak, pengaturan tingkat skema lebih diutamakan untuk tabel dalam skema tersebut. Pengaturan ini hanya berlaku untuk tabel yang dihilangkan setelah periode pemulihan dikonfigurasi. Setelah periode pemulihan berakhir, file data untuk tabel terkelola dihapus dari penyimpanan cloud Anda dalam waktu 48 jam.

    SET diperbolehkan sebagai kata kunci opsional. MANAGE Memerlukan hak istimewa atau kepemilikan pada katalog. Lihat juga Menghilangkan tabel terkelola.

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

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