MENGUBAH PENERIMA

  • Artikel

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

Mengganti nama penerima. Mentransfer kepemilikan penerima ke prinsipal baru.

Sintaks

ALTER RECIPIENT recipient_name
  { RENAME TO to_recipient_name |
    [ SET ] OWNER TO principal |
    SET PROPERTIES ( property_key [ = ] property_value [, ...] ) |
    UNSET PROPERTIES ( property_key [, ...] ) }

Parameter

  • recipient_name

    Nama penerima yang akan diubah.

  • RENAME TO to_recipient_name

    Mengganti nama penerima. Nama harus unik di antara semua penerima di metastore. Untuk menjalankan pernyataan ini, Anda harus menjadi pemilik penerima dan memiliki CREATE RECIPIENT hak istimewa di metastore.

  • [ SET ] OWNER TO principal

    Mentransfer kepemilikan penerima ke principal. Untuk menjalankan pernyataan ini, Anda harus menjadi pemilik penerima.

    Berlaku untuk:centang ditandai ya Gudang SQL SQL Databricks versi 2022.35 atau lebih tinggi centang ditandai ya Databricks Runtime 11.3 LTS ke atas

    SET diperbolehkan sebagai kata kunci opsional.

  • SET PROPERTIES ( property_key [ = ] property_value [, ...] )

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

    Mengatur properti kustom pada penerima. Untuk menjalankan pernyataan ini, Anda harus menjadi pemilik penerima dan memiliki CREATE RECIPIENT hak istimewa di metastore.

    Properti penerima dapat digunakan untuk berbagi partisi tabel yang berbeda dengan penerima yang berbeda menggunakan objek berbagi yang sama. Lihat Mengelola properti penerima dan Menggunakan properti penerima untuk melakukan pemfilteran partisi.

    property_key
{ identifier [. ...] | string_literal }

property_value
{ string_literal }

  • UNSET PROPERTIES ( '<property-key>' )

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

    Menghapus properti kustom dari penerima. Untuk menjalankan pernyataan ini, Anda harus menjadi pemilik penerima dan memiliki CREATE RECIPIENT hak istimewa di metastore.

    property_key
{ identifier [. ...] | string_literal }

Contoh

-- Rename a recipient
> ALTER RECIPIENT `Center for Disease Control` RENAME TO cdc;

-- Change ownership of the recipient
> ALTER RECIPIENT cdc OWNER TO `alf@melmak.et`;

-- Change recipient properties
> ALTER RECIPIENT cdc SET PROPERTIES ( 'country' = 'US' );