CREATE RECIPIENT
適用対象: Databricks SQL Databricks Runtime 10.4 LTS 以上 Unity Catalog のみ
指定された名前で Delta Sharing の受信者を作成し、アクティブ化リンクを生成します。 同じ名前の受信者が既に存在する場合は、例外がスローされます。
受信者を作成および管理するには、メタストア管理者であるか、メタストアに対する CREATE RECIPIENT
特権を持っている必要があります。
DESCRIBE RECIPIENT を使用して、アクティブ化リンクを取得します。
構文
CREATE RECIPIENT [ IF NOT EXISTS ] recipient_name
[ USING ID sharing_identifier ]
[ COMMENT comment ]
[ PROPERTIES ( property_key [ = ] property_value [, ...] ) ]
パラメーター
IF NOT EXISTS
指定した名前の受信者が存在しない場合は作成します。 同じ名前の受信者が既に存在する場合は、何も行いません。
-
作成される受信者の名前。
sharing_identifier
データの共有相手である Delta Sharing の受信者によって所有される Unity Catalog メタストアの省略可能なグローバル一意識別子。 これは、Delta Sharing の受信者によって実行される 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