Delta Sharing データ共有へのアクセスを管理する (プロバイダー向け)

この記事では、データ受信者に Delta Sharing 共有へのアクセス権を付与する方法について説明します。 また、アクセスを表示、更新、および取り消す方法についても説明します。

必要条件

受信者とデータを共有するには:

• Unity Catalog メタストアがアタッチされている Databricks ワークスペースを使用する必要があります。
• Unity-Catalog 対応のクラスター アクセス モードを使用する SQLウェアハウスまたはクラスターを使用する必要があります。
• 共有と受取人はすでに定義されている必要があります。
• 次のいずれかである必要があります。
  • メタストア管理者。
  • 共有オブジェクトと受信者オブジェクト (USE SHARE + SET SHARE PERMISSION) または共有の所有者) および (USE RECIPIENT または受信者の所有者) の両方に対する委任されたアクセス許可または所有権を持つユーザー。

共有するためのアクセス権を受信者に付与する

受信者に共有アクセス権を付与するには、カタログ エクスプローラー、DatabricksUnity CatalogCLI 、またはSQL DatabricksノートブックまたはDatabricks SQL クエリ エディターの コマンドを使用できます。

必要な権限 : 次のいずれかです。

• メタストア管理者。
• 共有オブジェクトと受信者オブジェクト ((USE SHARE + SET SHARE PERMISSION) または共有の所有者) および (USE RECIPIENT または受信者の所有者) の両方に対する委任されたアクセス許可または所有権。

Catalog Explorer

共有に受信者を追加するには、共有 v から開始します。

1. Databricks ワークスペースで、 カタログ をクリックします。

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

   または、[ クイック アクセス ] ページで [Delta Sharing > ] ボタンをクリックします。

3. [ 自分が共有] タブで、共有を見つけて選択します。

4. [ 受信者を追加 ] をクリックします。

5. [ 受信者の追加 ] ダイアログで、受信者の名前の入力を開始するか、ドロップダウン メニューをクリックして共有に追加する受信者を選択します。

6. [ 追加 ] をクリックします。

受信者に共有アクセス権を付与するには、受信者から開始します。

1. Databricks ワークスペースで、 カタログ をクリックします。

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

   または、[ クイック アクセス ] ページで [Delta Sharing > ] ボタンをクリックします。

3. [ 自分が共有] タブで、[ 受信者 ] をクリックし、受信者を選択します。

4. [ 共有の許可 ] をクリックします。

5. [ 共有の付与 ] ダイアログで、共有名の入力を開始するか、ドロップダウン メニューをクリックして付与する共有を選択します。

6. 付与 をクリックします。

SQL

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

SQL

GRANT SELECT ON SHARE <share-name> TO RECIPIENT <recipient-name>;

SELECT は、共有の受信者に付与できる唯一の権限です。

CLI

Databricks CLI を使用して次のコマンドを実行します。<share-name> を受信者に付与する共有の名前に置き換え、<recipient-name> を受信者の名前に置き換えます。SELECT は、共有に対して付与できる唯一の権限です。

Bash

databricks shares update-permissions <share-name> \
--json='{
  "changes": [
    {
      "principal": "<recipient-name>",
      "add": [
        "SELECT"
      ]
    }
  ]
}'

共有への受信者のアクセスを取り消す

共有への受信者のアクセスを取り消すには、Catalog Explorer、Databricks Unity Catalog CLI、または Databricks ノートブックまたは Databricks SQL クエリエディターの REVOKE ON SHARE SQL コマンドを使用できます。

必要なアクセス許可 : メタストア管理者、 USE SHARE 権限を持つユーザー、または共有オブジェクトの所有者。

Catalog Explorer

共有の画面からスタートして、受信者の共有へのアクセスを取り消すには:

1. Databricks ワークスペースで、 カタログ をクリックします。

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

   または、[ クイック アクセス ] ページで [Delta Sharing > ] ボタンをクリックします。

3. [ 自分が共有] タブで、共有を見つけて選択します。

4. [ 受信者] タブで、受信者を見つけます。

5. ケバブメニューをクリックし、「 取り消し」 を選択します。

6. 確認ダイアログで、[ Revoke ] をクリックします。

共有への受信者のアクセスを取り消すには、受信者から開始します。

1. Databricks ワークスペースで、 カタログ をクリックします。

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

   または、[ クイック アクセス ] ページで [Delta Sharing > ] ボタンをクリックします。

3. [ 自分が共有] タブで、[ 受信者 ] をクリックし、受信者を選択します。

4. [共有] タブで、共有を見つけます。

5. 共有行の ケバブメニューをクリックし、「 取り消し」 を選択します。

6. 確認ダイアログで、[ Revoke ] をクリックします。

SQL

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

SQL

REVOKE SELECT ON SHARE <share-name> FROM RECIPIENT <recipient-name>;

CLI

Databricks CLI を使用して次のコマンドを実行します。<share-name> を受信者から削除する共有の名前に置き換え、<recipient-name> を受信者の名前に置き換えます。SELECT は、受信者に対して削除できる唯一の権限です。

Bash

databricks shares update-permissions <share-name> \
--json='{
  "changes": [
    {
      "principal": "<recipient-name>",
      "remove": [
        "SELECT"
      ]
    }
  ]
}'

株式の交付金や受取人が保有する助成金を表示します

共有の現在の許可を表示するには、Catalog Explorer、Databricks Unity Catalog CLI、または Databricks ノートブックまたは Databricks SQL クエリエディターの SHOW GRANTS ON SHARE SQL コマンドを使用できます。

必要なアクセス許可 : 共有へのアクセス権を付与された受信者を表示する場合は、メタストア管理者、 USE SHARE 権限を持つユーザー、または共有オブジェクトの所有者である必要があります。 受信者に付与された共有を表示する場合は、メタストア管理者、 USE RECIPIENT 権限を持つユーザー、または受信者オブジェクトの所有者である必要があります。

Catalog Explorer

共有へのアクセス権を持つ受信者を表示するには:

1. Databricks ワークスペースで、 カタログ をクリックします。

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

   または、[ クイック アクセス ] ページで [Delta Sharing > ] ボタンをクリックします。

3. [ 自分が共有] タブで、共有を見つけて選択します。

4. [ 受信者] タブに移動して、共有にアクセスできるすべての受信者を表示します。

SQL

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

SQL

SHOW GRANT ON SHARE <share-name>;

CLI

Databricks CLI を使用して次のコマンドを実行します。

Bash

databricks shares share-permissions <share-name>

受信者が現在所有している共有権限を表示するには、カタログ エクスプローラー、Databricks CLI、または Databricks ノートブックまたは Databricks SQL クエリ エディターの SHOW GRANTS TO RECIPIENT SQL コマンドを使用できます。

Catalog Explorer

受信者に付与された共有を表示するには:

1. Databricks ワークスペースで、 カタログ をクリックします。

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

   または、[ クイック アクセス ] ページで [Delta Sharing > ] ボタンをクリックします。

3. [ 自分が共有] タブで、[ 受信者 ] をクリックし、受信者を選択します。

4. [共有 ] タブに移動して、受信者がアクセスできるすべての共有を表示します。

SQL

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

SQL

SHOW GRANTS TO RECIPIENT <recipient-name>;

CLI

Databricks CLI を使用して次のコマンドを実行します。

Bash

databricks recipients share-permissions <recipient-name>