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

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

要件

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

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

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

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

必要なアクセス許可 ：次のいずれか。

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

重要

共有の所有者は、受信者がアクセスできるように、共有内のすべてのアセットに対して十分なアクセス権を持っている必要があります。オブジェクトの作成者は、スキーマに追加された新アセットに対するアクセス権を付与する必要があります。各共有データアセットに必要なアクセス権のリストについては、「要件」を参照してください。

Catalog Explorer

共有の画面から開始して、受信者を共有に追加するには：

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

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

   または、右上隅の Share > OpenSharing をクリックします。

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

4. 受信者の追加 をクリックしてください。

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

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

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

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

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

   または、右上隅の Share > OpenSharing をクリックします。

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"
      ]
    }
  ]
}'

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

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

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

Catalog Explorer

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

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

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

   または、右上隅の Share > OpenSharing をクリックします。

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

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

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

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

受信者から始めて、共有への受信者のアクセスを取り消すには:

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

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

   または、右上隅の Share > OpenSharing をクリックします。

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

4. 共有 タブで、共有を見つけてください。

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

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

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"
      ]
    }
  ]
}'

受信者が保有する権限、共有の権限を参照します

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

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

Catalog Explorer

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

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

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

   または、右上隅の Share > OpenSharing をクリックします。

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

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

SQL

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

SQL

SHOW GRANT ON SHARE <share-name>;

CLI

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

Bash

databricks shares share-permissions <share-name>

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

Catalog Explorer

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

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

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

   または、右上隅の Share > OpenSharing をクリックします。

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

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

SQL

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

SQL

SHOW GRANTS TO RECIPIENT <recipient-name>;

CLI

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

Bash

databricks recipients share-permissions <recipient-name>

その他のリソース

• OpenSharing を使用して共有されているデータにアクセスする (受信者向け)
• OpenSharing の共有を管理します
• データ共有の監査と監視