OpenSharingのデータ受信者を作成する（Databricks間共有）

このページでは、Unityカタログで有効化されたAzure Databricksワークスペース上に受信者がある場合、OpenSharingで受信者を作成する方法を説明します。 表示、更新、削除、共有アクセスの許可、プロパティの管理、または既存の受信者の IP リストによるアクセスの制限については、「 OpenSharing のデータ受信者を管理する」を参照してください。

受信者は、共有データを使用するユーザーまたはユーザー のグループの ID を表す名前付きオブジェクトです。 受信者の作成方法は、受信者がUnity Catalogで有効になっているAzure Databricksワークスペースにアクセスできるかどうかによって異なります。

これら 2 つの共有モードの詳細と、どのような場合にどちらを選ぶべきかについては、「Databricks から Open Sharing への共有と Databricks 間の共有の比較」を参照してください。

Requirements

受信者を作成するには、次の要件を満たす必要があります。

  • 共有するデータが登録されている Unity カタログ メタストアの CREATE RECIPIENT 権限が必要です。
  • その Unity Catalog メタストアがアタッチされている Azure Databricks ワークスペースを使用して受信者を作成する必要があります。
  • Databricks ノートブックを使用して受信者を作成する場合、コンピューティングでは Databricks Runtime 11.3 LTS 以降と、標準アクセス モードまたは専用アクセス モード (以前の共有およびシングル ユーザー アクセス モード) を使用する必要があります。

他の受信者の操作 (表示、更新、削除、共有アクセス権の付与、プロパティの管理) に必要なアクセス許可については、「 OpenSharing のデータ受信者を管理する」を参照してください。

Azure Databricks ユーザー用の受信者オブジェクトを作成する

もしデータ受信者がUnity Catalogで有効化されたAzure Databricksワークスペースにアクセスできるなら、認証タイプのDATABRICKSで受信オブジェクトを作成できます。

認証の種類が DATABRICKS の受信者オブジェクトは、特定の Unity カタログ メタストア上のデータ受信者を表します。これは、メタストアのクラウド、リージョン、UUID で構成される 共有識別子 文字列によって受信者オブジェクト定義で識別されます。 この受信者と共有されるデータは、そのメタストアでのみアクセスできます。

DatabricksからDatabricksへの共有の受信機を作成するには、カタログエクスプローラー、Databricks CLI、またはAzure Databricksノートブック内のCREATE RECIPIENT SQLコマンド、またはDatabricks SQLクエリエディタを使用します。 REST APIで受信者を作成するには、メール受信者も含めて、「REST API参照で 受信者を作成する 」をご覧ください。

必要なアクセス許可: 共有するデータが登録されている Unity カタログ メタストアの CREATE RECIPIENT 特権を持つメタストア管理者またはユーザー。

カタログ エクスプローラー

  1. Azure Databricks ワークスペースで、Data icon.Catalog をクリックします。

  2. [カタログ] ウィンドウの上部にある歯車アイコンをクリックします。歯車アイコンをクリックし、[OpenSharing] を選択します。

    または、右上隅の [ 共有] > [OpenSharing] をクリックします。

  3. [自分と共有] タブで、[新しい受信者] をクリックします。

  4. 受取人が自分のシェアにアクセスする方法を選びましょう:

    • メールで共有(ベータ):これは受信者にメールを送信し、Azure Databricksアカウントにログインして希望するメタストアを選択するよう促します。 受信者は招待されたメールアドレスを使用するAzure Databricksアカウントでサインインする必要があります。 詳細や制限については、 メール共有をご覧ください。

      1. 受信者名を入力します。
      2. 受信者のメール アドレスを入力します。
      3. この 共有の利用方法を設定するには、「 Any supported OpenSharing クライアント 」または 「Databricks受信者への制限」を選択してください。 サポートされているOpenSharingクライアントは、受信者が認証情報ファイルをダウンロードし、Azure Databricks上の共有にアクセスできるようにします。
      4. (任意)「Allowed metastores(共有ID経由)」の「Add metastores」をクリックし、どのAzure Databricksメタストアが招待を受け入れられるかを制限するために共有識別子を入力してください。

      Note

      受信者をシェアに追加すると、OpenSharingは受信者に安全なアクティベーションリンクをメールで送り、別のシェアに追加するたびに新しいメールを送信します。 受信者がすでに共有している共有を再付与しても、重複メールは発生しません。 OpenSharing データ共有へのアクセスの管理 (プロバイダーの場合) を参照してください。

    • 共有識別子を使った共有:受信者の共有識別子をリクエストし入力する必要があります。

      1. 受信者名を入力します。

      2. [受信者の種類] で、[Databricks] を選択します。

      3. 受信者の 共有識別子を入力します。

        <cloud>:<region>:<uuid> 形式の共有識別子文字列全体を使用します。 たとえば、「 aws:us-west-2:19a84bee-54bc-43a2-87de-023d0ec16016 」のように入力します。

      4. (省略可能)コメントを入力します。

  5. Create をクリックしてください。

  6. (省略可能) カスタムの受信者のプロパティを作成します。

    受信者の「概要」タブで、「受信者のプロパティ」の横にある「編集」アイコンをクリックします。 次に、プロパティ名 (キー) と値を追加します。 詳細については、「受信者のプロパティを管理する」を参照してください。

SQL

ノートブックまたは Databricks SQL クエリ エディターで次のコマンドを実行します。

CREATE RECIPIENT [IF NOT EXISTS] <recipient-name>
USING ID '<sharing-identifier>'
[COMMENT "<comment>"];

<cloud>:<region>:<uuid> 形式の共有識別子文字列全体を使用します。 たとえば、「 aws:eu-west-1:g0c979c8-3e68-4cdf-94af-d05c120ed1ef 」のように入力します。

受信者のカスタム プロパティを追加することもできます。 詳細については、「受信者のプロパティを管理する」を参照してください。

CLI

Databricks CLI を使用して次のコマンドを実行します。 プレースホルダー値を次のように置き換えます。

  • <recipient-name>: 受信者の名前。
  • <sharing-identifier>: <cloud>:<region>:<uuid>形式の共有識別子文字列全体。 たとえば、「 aws:eu-west-1:g0c979c8-3e68-4cdf-94af-d05c120ed1ef 」のように入力します。
  • <authentication-type>: DATABRICKS の形式の共有識別子文字列を <cloud>:<region>:<uuid> に対して指定するときは、<sharing-identifier> に設定します。
databricks recipients create <recipient-name> <authentication-type> --sharing-code <sharing-identifier>

受信者のカスタム プロパティを追加することもできます。 詳細については、「受信者のプロパティを管理する」を参照してください。

受信者は、authentication_type の DATABRICKS で作成されます。

その他のリソース

  • 最終更新: