BUAT PENERIMA

  • 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

Membuat penerima Delta Sharing dengan nama yang ditentukan dan menghasilkan link aktivasi. Jika penerima dengan nama yang sama sudah ada, pengecualian akan dilemparkan.

Untuk membuat dan mengelola penerima, Anda harus menjadi administrator metastore atau memiliki CREATE RECIPIENT hak istimewa di metastore.

Gunakan JELASKAN PENERIMA untuk mengambil tautan aktivasi.

Sintaks

CREATE RECIPIENT [ IF NOT EXISTS ] recipient_name
    [ USING ID sharing_identifier ]
    [ COMMENT comment ]
    [ SET PROPERTIES ( property_key [ = ] property_value [, ...] ) ]

Parameter

  • IF NOT EXISTS

    Membuat penerima dengan nama yang diberikan jika tidak ada. Jika penerima dengan nama yang sama sudah ada, tidak akan terjadi apa-apa.

  • recipient_name

    Nama penerima yang akan dibuat.

  • sharing_identifier

    Pengidentifikasi unik global opsional dari metastore Unity Catalog yang dimiliki oleh penerima Delta Sharing yang ingin Anda ajak berbagi data. Ini adalah output dari fungsi current_metastore yang dijalankan oleh penerima Delta Sharing.

    Menggunakan opsi ini mengatur jenis autentikasi ke DATABRICKS, jika tidak, jenis autentikasi diatur ke TOKEN, mengharuskan Anda mengirim link aktivasi ke penerima agar mereka dapat mengakses data bersama.

  • komentar

    Harfiah opsional STRING. Deskripsi untuk penerima.

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

    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 }

Contoh

-- A recipient created for Databricks to Databricks sharing
> CREATE RECIPIENT other_databricks_org USING ID 'azure:westus:f12dcb34-5678-9d4c-1234-c5ac67f8b90a';
> DESCRIBE RECIPIENT other_databricks_org;
 info_name           info_value
 -------------       ----------
 recipient_name      other_databricks_org
 authentication_type DATABRICKS
 owner               alwaysworks@databricks.com
 created_by          alwaysworks@databricks.com
 create_at           2022-01-01T00:00:00.000+0000
 updated_by          alwayswork@databricks.com
 updated_at          2022-01-05T12:00:00.000+0000
 comment
 cloud               azure
 region              westus
 metastore_id        f12dcb34-5678-9d4c-1234-c5ac67f8b90a

-- A recipient created for sharing outside of Databricks
> CREATE RECIPIENT other_org;
> DESCRIBE RECIPIENT other_org;
 info_name               info_value
 ----------------------- ----------
 recipient_name          other_org
 authentication_type     TOKEN
 owner                   alwaysworks@databricks.com
 created_by              alwaysworks@databricks.com
 create_at               2022-01-01T00:00:00.000+0000
 updated_by              alwayswork@databricks.com
 updated_at              2022-01-05T12:00:00.000+0000
 comment                 This is Other Corp
 active_token_id         0160c81f-5262-40bb-9b03-3ee12e6d98d7
 active_token_expiration 2023-01-05T12:00:00.000+0000
 activation_link         https://send/this