Delta Sharingの株式を管理する

このページでは、Databricks で既存の Delta Sharing の共有フォルダを表示、更新、削除する方法について説明します。 共有と は、Unity Catalogにおけるセキュリティ保護可能なオブジェクトであり、テーブル、ビュー、ボリューム、ノートブック、AIモデル、その他のデータ資産をまとめて、1人または複数の受信者と共有するためのものです。

新しい共有を作成したり、既存の共有にデータ資産を追加したりするには、 Delta Sharing用の共有を作成する」を参照してください。 受信者に共有へのアクセス権を付与するには、 「Delta Sharing データ共有へのアクセスを管理する (プロバイダー向け)」を参照してください。共有するデータ受信者を管理するには、 「Delta Sharing のデータ受信者の管理」を参照してください。

共有モデルの詳細については、共有、プロバイダー、および受信者を参照してください。

要件

完了したい各タスクについて、記載されている要件を満たしていることを確認してください。

タスク	要件
受信者に共有へのアクセス権限を付与する	メタストアの管理者になる。 または 共有オブジェクトと受信者オブジェクトの両方に対して委任された権限または所有権を持つユーザーであること。つまり、ユーザーは以下の両方の要件を満たす必要があります。 USE SHAREとSET SHARE PERMISSION両方の権限を持っているか、または共有者の所有者であること USE RECIPIENT権限を持っているか、または受信者の所有者であること
シェアを表示	メタストア管理者になる（すべて閲覧可能）。 または USE SHARE権限（すべて閲覧可能）を持つユーザーであること。 または 共有オブジェクトの所有者になる。
シェア所有者を更新する	メタストアの管理者になる。
共有名を更新する	CREATE SHARE権限を持つ。 株主になりましょう。
その他の共有プロパティを更新する	株主になりましょう。
共有を削除する	共有オブジェクトの所有者になる。

株式と株式の詳細を表示する

株式および株式の詳細を閲覧する前に、要件を満たしていることを確認してください。

共有のリストまたは共有に関する詳細を表示するには、カタログ エクスプローラー、 Databricks Unity Catalog CLI 、またはDatabricksノートブックまたはDatabricks SQLクエリ エディターのSQLコマンドを使用します。

共有内容の詳細は以下のとおりです。

• 共有の所有者、作成者、作成タイムスタンプ、更新者、更新タイムスタンプ、コメント。
• 共有フォルダ内のデータ資産。
• 共有情報へのアクセス権を持つ受信者。

Catalog Explorer

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

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

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

3. 株式一覧を表示するには、「 株式」 タブを開いてください。

4. 共有の詳細については、「 詳細」 タブをご覧ください。

SQL

共有情報の一覧を表示するには、ノートブックまたはDatabricks SQLクエリ エディタで次のコマンドを実行します。必要に応じて、 <pattern> LIKE述語に置き換えます。

SQL

SHOW SHARES [LIKE <pattern>];

特定の共有に関する詳細を表示するには、次のコマンドを実行します。

SQL

DESCRIBE SHARE <share-name>;

共有フォルダ内のすべてのテーブル、ビュー、ボリュームの詳細を表示するには、次のコマンドを実行します。

SQL

SHOW ALL IN SHARE <share-name>;

CLI

共有の一覧を表示するには、 Databricks CLIを使用して次のコマンドを実行します。

Bash

databricks shares list

特定の共有に関する詳細を表示するには、次のコマンドを実行します。

Bash

databricks shares get <share-name>

共有に対するアクセス許可を持つ受信者を表示する

受信者リストを表示する前に、要件を満たしていることを確認してください。

受信者にアクセスが許可されている共有のリストを表示するには、カタログ エクスプローラー、 Databricks Unity Catalog 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 ON SHARE <share-name>;

CLI

Databricks CLIを使用して、以下のコマンドを実行してください。

Bash

databricks shares share-permissions <share-name>

更新情報

シェアを更新する前に、要件を満たしていることを確認してください。

共有情報を更新するには、以下の方法があります。

• 株式の名前を変更します。
• 共有フォルダからテーブル、ビュー、ボリューム、スキーマを削除します。
• シェアした投稿にコメントを追加または更新します。
• テーブルのエイリアス（受信者に表示されるテーブル名）を変更します。
• テーブルの履歴データへのアクセスを有効または無効にすることで、受信者がタイムトラベルクエリを実行したり、テーブルのストリーミング読み取りを実行したりできるようにします。
• パーティション定義を追加、更新、または削除します。
• 株主名を変更する。

共有に対してこれらの更新を行うには、カタログ エクスプローラー、 Databricks Unity Catalog CLI 、またはDatabricksノートブックまたはDatabricks SQLクエリ エディターのSQLコマンドを使用します。 ただし、カタログエクスプローラーを使用して共有フォルダの名前を変更することはできません。

Catalog Explorer

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

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

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

3. 自分が共有 タブで、更新する共有を見つけて、その名前をクリックします。

共有詳細ページで、以下の操作を行ってください。

• クリック所有者またはコメント欄の横にある編集アイコンをクリックして、これらの値を更新してください。
• ケバブメニューをクリックしてくださいアセット行にあるボタンをクリックして削除します。
• 「アセットの管理」＞「アセットの編集」 をクリックして、他のすべてのプロパティを更新します。
  • アセットを削除するには、アセットの横にあるチェックボックスをオフにします。
  • パーティション定義を追加、更新、または削除するには、 「詳細オプション」 をクリックします。

SQL

以下のコマンドをノートブックまたはDatabricks SQLエディタで実行してください。

共有名の変更:

SQL

ALTER SHARE <share-name> RENAME TO <new-share-name>;

共有フォルダからテーブルを削除する：

SQL

ALTER SHARE share_name REMOVE TABLE <table-name>;

共有フォルダからボリュームを削除する：

SQL

ALTER SHARE share_name REMOVE VOLUME <volume-name>;

シェアした投稿にコメントを追加または更新する：

SQL

COMMENT ON SHARE <share-name> IS '<comment>';

共有内のテーブルのパーティションを追加または変更する：

SQL

ALTER SHARE <share-name> ADD TABLE <table-name> PARTITION(<clause>);

株主を変更する:

SQL

ALTER SHARE <share-name> OWNER TO  '<principal>'

-- Principal must be an account-level user email address or group name.

テーブル履歴の共有を有効にします。

SQL

ALTER SHARE <share-name> ADD TABLE <table-name> WITH HISTORY;

ALTER SHARE問題の詳細については、 ALTER SHARE参照してください。

CLI

Databricks CLIを使用して、以下のコマンドを実行してください。

共有名の変更:

Bash

databricks shares update <share-name> --name <new-share-name>

共有フォルダからテーブルを削除する：

Bash

databricks shares update <share-name> \
  --json '{
    "updates": [
      {
        "action": "REMOVE",
        "data_object": {
          "name": "<table-full-name>",
          "data_object_type": "TABLE",
          "shared_as": "<table-alias>"
        }
      }
    ]
  }'

共有フォルダからボリュームを削除する（Databricks CLI 0.210以降を使用）：

Bash

databricks shares update <share-name> \
  --json '{
    "updates": [
      {
        "action": "REMOVE",
        "data_object": {
          "name": "<volume-full-name>",
          "data_object_type": "VOLUME",
          "string_shared_as": "<volume-alias>"
        }
      }
    ]
  }'

注記

ボリュームにエイリアスがない場合は、 nameプロパティを使用してください。エイリアスがある場合はstring_shared_asを使用してください。

シェアした投稿にコメントを追加または更新する：

Bash

databricks shares update <share-name> --comment '<comment>'

株主を変更する:

Bash

databricks  shares update <share-name> --owner '<principal>'

プリンシパルは、アカウント レベルのユーザーの電子メール アドレスまたはグループ名である必要があります。

株主名簿を更新する際の考慮事項

株主が誰であるかによって、ABACなどの認証およびセキュリティ機能の評価方法に影響します。 ABACで保護されたテーブルまたはスキーマがある場合、共有所有権を過剰な権限を持つユーザーに譲渡すると、受信者は過剰な権限を持つアクセス権限を取得できます。 。

共有を削除する

共有を削除すると、受信者は共有データにアクセスできなくなります。共有オブジェクトを削除する前に、要件を満たしていることを確認してください。

共有を削除するには、カタログ エクスプローラー、 Databricks Unity Catalog CLI 、またはDatabricksノートブックまたはDatabricks SQLクエリ エディターのDELETE SHARE SQLコマンドを使用します。 あなたは当該株式の所有者でなければなりません。

Catalog Explorer

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

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

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

3. 「自分が共有したアイテム」 タブで、削除したい共有アイテムを見つけて、その名前をクリックします。

4. クリックケバブメニューを選択し、 削除 を選択します。

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

SQL

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

SQL

DROP SHARE [IF EXISTS] <share-name>;

CLI

Databricks CLIを使用して、以下のコマンドを実行してください。

Bash

databricks shares delete <share-name>