CREATE RECIPIENT (Databricks SQL)

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

若要建立和管理收件者,您必須是中繼存放區管理員,且 Databricks SQL 必須設定為 Unity 目錄中繼存放區。

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

語法

CREATE RECPIENT [ IF NOT EXISTS ] recipient_name
    [ USING ID sharing_identifier ]
    [ COMMENT comment ]

參數

  • 如果不存在

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

  • recipient_name

    要建立之收件者的名稱。

  • sharing_identifier

    您想要與其共用資料之 Delta 共用收件者所擁有的 Unity 目錄中繼存放區選擇性全域唯一識別碼。 這是差異共用收件者所執行 之current_metastore 函式的輸出。

    使用此選項會將驗證類型設定為 ,否則驗證類型 DATABRICKS 會設定 TOKEN 為 ,要求您將啟用連結傳送給收件者,以便他們存取共用日期。

  • 評論

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

範例

-- A recipient created for Databricks to Databricks sharing
> CREATE RECIPIENT other_databricks_org USING ID 'azure:westus:f64dcb39-5046-4d4c-9588-c6ac84f9b38a';
> 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          f64dcb39-5046-4d4c-9588-c6ac84f9b38a

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