CREATE RECIPIENT

適用於：核取記號為「是」Databricks SQL 核取記號為「是」Databricks Runtime 10.4 LTS 和更新版本核取記號為「是」僅限 Unity 目錄

建立一個指定名稱的 OpenSharing 收件人，並產生啟動連結。 如果具有相同名稱的收件者已經存在，則會擲回例外狀況。

使用 DESCRIBE RECIPIENT 來擷取啟用連結。

許可

要建立收件人，你必須是元商店管理員或擁有 CREATE RECIPIENT 元商店的權限。 建立後，只有接收者的擁有者能管理（參見 ALTER RECIPIENT 和 DROP RECIPIENT）。

語法

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

參數

  • 若不存在

    如果指定名稱不存在，請建立收件者。 如果具有相同名稱的收件者已經存在，則不會發生任何事。

  • recipient_name

    要建立之收件者的名稱。

  • sharing_identifier

    一個可選的全球唯一識別碼，指由你喜歡分享資料的 OpenSharing 接收者所擁有的 Unity 目錄中繼儲存庫。 這是 OpenSharing 接收者執行的 current_metastore 函式的輸出。

    使用此選項將驗證類型設為 DATABRICKS，否則認證類型將設為 TOKEN，要求你傳送啟動連結給收件人，讓他們能存取共享日期。

  • comment

    選擇性常 STRING 值。 收件者的描述。

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

    適用於：核取記號為「是」Databricks SQL 核取記號為「是」 Databricks Runtime 12.2 LTS 和更新版本。

    設定收件者上的自定義屬性。

    接收者屬性可用於使用同一共享物件，與不同的接收者共享不同的表格分割區。 請參閱 管理接收者屬性 及 使用接收者屬性進行分割區過濾。

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

property_value
{ string_literal }

範例

-- 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
  • Last updated on