建立收件者
適用於：
Databricks SQL Databricks Runtime 10.4 LTS 和更新版本僅限 Unity 目錄
使用指定的名稱建立 Delta Sharing 收件者，並產生啟用連結。 如果具有相同名稱的收件者已經存在，則會擲回例外狀況。
若要建立和管理收件者，您必須是中繼存放區系統管理員，或具有 CREATE RECIPIENT 中繼存放區的許可權。
使用 DESCRIBE RECIPIENT 來擷取啟用連結。
語法
CREATE RECIPIENT [ IF NOT EXISTS ] recipient_name
[ USING ID sharing_identifier ]
[ COMMENT comment ]
[ SET PROPERTIES ( property_key [ = ] property_value [, ...] ) ]
參數
如果不存在
如果指定名稱不存在，請建立收件者。 如果具有相同名稱的收件者已經存在，則不會發生任何事。
-
要建立之收件者的名稱。
sharing_identifier
Delta Sharing 收件者擁有的 Unity 目錄中繼存放區選擇性全域唯一標識碼，您想要與其共用數據。 這是 Delta Sharing 收件者所執行current_metastore函式的輸出。
使用此選項會將驗證類型設定為
DATABRICKS，否則驗證類型會設定為TOKEN，要求您將啟用連結傳送給收件者，讓他們存取共用日期。comment
選擇性常
STRING值。 收件者的描述。SET 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