次の方法で共有


CREATE RECIPIENT

適用対象: check marked yes 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

    指定した名前の受信者が存在しない場合は作成します。 同じ名前の受信者が既に存在する場合は、何も行いません。

  • recipient_name

    作成される受信者の名前。

  • sharing_identifier

    データの共有相手である Delta Sharing の受信者によって所有される Unity Catalog メタストアの省略可能なグローバル一意識別子。 これは、Delta Sharing の受信者によって実行される current_metastore 関数の出力です。

    このオプションを使うと、認証の種類が DATABRICKS に設定され、それ以外の場合は、認証の種類が TOKEN に設定され、共有された日付にアクセスするために、受信者にアクティブ化リンクを送信する必要があります。

  • comment

    STRING リテラル (省略可能)。 受信者の説明。

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

    適用対象: check marked yes 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