Baca dalam bahasa Inggris

Bagikan melalui

CREATE RECIPIENT

  • Artikel
  • 22/03/2025

Berlaku untuk:dicentang ya Databricks SQL dicentang ya Databricks Runtime 10.4 LTS ke atas dicentang 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 DESCRIBE RECIPIENT untuk mengambil tautan aktivasi.

Sintaks

CREATE RECIPIENT [ IF NOT EXISTS ] recipient_name
    [ USING ID sharing_identifier ]
    [ COMMENT comment ]
    [ 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 Anda ingin 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 tautan aktivasi ke penerima untuk mengakses tanggal bersama.

  • komentar

    Teks literal opsional STRING. Deskripsi untuk penerima.

  • 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

Sumber Daya Tambahan:

Dokumentasi