Delta Sharing の共有の作成と管理

この記事では、 Delta Sharingの共有を作成および管理する方法について説明します。

共有は、次のデータ資産を 1 人以上の受信者と共有するために使用できる Unity Catalog のセキュリティ保護可能なオブジェクトです。

テーブルとテーブルパーティション
ビュー (行レベルと列レベルでアクセスを制限する動的ビューを含む)
ボリューム
ノートブック
AIモデル

スキーマ (データベース) 全体を共有すると、受信者は共有した時点でスキーマ内のすべてのテーブル、ビュー、モデル、ボリュームにアクセスできるほか、今後スキーマに追加されたデータや AI アセットにもアクセスできます。

共有には、1 つの Unity Catalog メタストアからのデータと AI アセットのみを含めることができます。いつでも共有に対してデータと AI アセットを追加または削除できます。

詳細については、「共有、プロバイダー、受信者」を参照してください。

要件

共有を作成するには、次のことを行う必要があります。

メタストア管理者であるか、共有するデータが登録されている Unity Catalog メタストアに対する CREATE SHARE 特権を持っていること。
その Unity Catalog メタストアがアタッチされている Databricks ワークスペースを使用して共有を作成します。

共有にテーブルまたはビューを追加するには、次の操作を行う必要があります。

共有の所有者になります。
表またはビューを含むカタログおよびスキーマに対する USE CATALOG および USE SCHEMA 特権、またはカタログまたはスキーマの所有権を持っている。
表またはビューに対する SELECT 特権を持っている。テーブルまたはビューを引き続き共有するには、その特権を保持する必要があります。紛失した場合、受信者は共有を介してテーブルまたはビューにアクセスできません。そのため、Databricks では、共有所有者としてグループを使用することをお勧めします。

共有にボリュームを追加するには、次の操作を行う必要があります。

共有の所有者になります。
ボリュームを含むカタログおよびスキーマに対する USE CATALOG および USE SCHEMA 特権、またはカタログまたはスキーマの所有権を持っている。
ボリュームに対する READ VOLUME 権限を持っている。ボリュームを引き続き共有するには、その特権を保持する必要があります。紛失した場合、受信者は共有を介してボリュームにアクセスできません。そのため、Databricks では、共有所有者としてグループを使用することをお勧めします。

共有にモデルを追加するには、次のことを行う必要があります。

共有の所有者になります。
モデルを含むカタログおよびスキーマに対する USE CATALOG および USE SCHEMA 特権、またはカタログまたはスキーマの所有権を持っている。
モデルに対する EXECUTE 権限を持っている。モデルを引き続き共有するには、その権限を保持する必要があります。紛失した場合、受信者は共有を介してモデルにアクセスできません。そのため、Databricks では、共有所有者としてグループを使用することをお勧めします。

スキーマ全体を共有するには、次の操作を行う必要があります。

共有とスキーマの所有者であるか、右の権限を持っている USE SCHEMA.
テーブルを共有するスキーマに対する SELECT 権限がある。
ボリュームを共有するスキーマに対する READ VOLUME 権限がある。

ノートブックファイルを共有に追加するには、次の操作を行う必要があります。

共有所有者であり、ノートブックに対する CAN READ 権限を持っています。

受信者に共有へのアクセスを許可するには、次のいずれかである必要があります。

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

共有を表示するには、次のいずれかである必要があります。

メタストア管理者 (すべて表示可能)
USE SHARE 権限を持つユーザー (すべて表示可能)
共有オブジェクトの所有者

コンピュートの要件:

Databricks ノートブックを使用して共有を作成する場合、クラスターでは Databricks Runtime 11.3 LTS 以上と、共有またはシングルユーザークラスターアクセスモードを使用する必要があります。
SQLステートメントを使用して共有にスキーマを追加する場合 (またはスキーマを更新または削除する場合)、 Databricks Runtime 13.3 LTS以上を実行している SQL ウェアハウスまたはコンピュートを使用する必要があります。 Catalog Explorer を使用して同じことを実行する場合、コンピュートの要件はありません。

共有オブジェクトを作成する

共有を作成するには、カタログエクスプローラー、Databricks Unity Catalog CLI、または Databricks ノートブックまたは Databricks SQL クエリーエディターの CREATE SHARE SQL コマンドを使用できます。

必要なアクセス許可: メタストア管理者またはメタストアの CREATE SHARE 権限を持つユーザー。

Databricks ワークスペースで、[ カタログ] をクリックします。
カタログパネルの上部にある歯車アイコンをクリックし、 Delta Sharingを選択します。

または、クイックアクセスページでDelta Sharing >]ボタンをクリックします。
[共有済み]タブで、 [データの共有]ボタンをクリックします。
[ 共有の作成 ] ページで、共有の [名前 ] とオプションのコメントを入力します。
「 保存して続行」をクリックします。

データ資産の追加を続行することも、停止して後で戻ることもできます。
[データアセットの追加]タブで、共有するテーブル、ボリューム、ビュー、モデルを選択します。

詳細な手順については、以下を参照してください。
「 保存して続行」をクリックします。
[ノートブックの追加]タブで、共有するノートブックを選択します。

詳細な手順については、「ノートブックファイルを共有に追加する」を参照してください。
「 保存して続行」をクリックします。
[受信者の追加]タブで、共有する受信者を選択します。

詳細な手順については、「Delta Sharing データ共有へのアクセスの管理 (プロバイダー向け)」を参照してください。
[ データの共有 ] をクリックして、受信者とデータを共有します。

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

CREATE SHARE [IF NOT EXISTS] <share-name>
[COMMENT "<comment>"];

これで、テーブル、ボリューム、ビュー、およびモデルを共有に追加できます。

詳細な手順については、以下を参照してください。

共有にテーブルを追加する
共有にボリュームを追加する
共有にビューを追加する
共有にモデルを追加する

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

databricks shares create <share-name>

--comment を使用してコメントを追加したり、--jsonを使用してアセットを共有に追加したりできます。詳細については、以下のセクションを参照してください。

これで、テーブル、ボリューム、ビュー、およびモデルを共有に追加できます。

詳細な手順については、以下を参照してください。

共有にテーブルを追加する
共有にボリュームを追加する
共有にビューを追加する
共有にモデルを追加する

共有にテーブルを追加する

共有にテーブルを追加するには、カタログエクスプローラー、Databricks Unity Catalog CLI、または Databricks ノートブックまたは Databricks SQL クエリーエディターの SQL コマンドを使用できます。

注

2024 年 7 月 25 日以降に共有を使用して受信者と共有される共有には、テーブルコメント、列コメント、および主キー制約が含まれます。Databricks-to-Databricksリリース日より前に受信者と共有された共有を通じてコメントと制約の共有を開始する場合は、コメントと制約の共有をトリガーするために、受信者のアクセス権を取り消して再付与する必要があります。

必要な権限: 共有オブジェクトの所有者、テーブルを含むカタログとスキーマの USE CATALOG と USE SCHEMA 、およびテーブルに対する SELECT 権限。表を共用する限り、 SELECT 特権を維持する必要があります。詳細については、「要件」を参照してください。

注

ワークスペース管理者であり、ワークスペース管理者グループからテーブルを含むスキーマとカタログに対する USE SCHEMA と USE CATALOG のアクセス許可を継承した場合、テーブルを共有に追加することはできません。まず、スキーマとカタログに対する USE SCHEMA と USE CATALOG のアクセス許可を自分自身に付与する必要があります。

Databricks ワークスペースで、[ カタログ] をクリックします。
カタログパネルの上部にある歯車アイコンをクリックし、 Delta Sharingを選択します。

または、クイックアクセスページでDelta Sharing >]ボタンをクリックします。
[共有済み]タブで、テーブルを追加する共有を見つけて、その名前をクリックします。
「 資産の管理」>「データ資産の追加」をクリックします。
[ テーブルの追加 ] ページで、スキーマ全体 (データベース) または個々のテーブルとビューを選択します。
- テーブルまたはビューを選択するには、まずカタログを選択し、次にテーブルまたはビューを含むスキーマを選択し、次にテーブルまたはビュー自体を選択します。
  
  ワークスペース検索を使用して、名前、列名、またはコメントでテーブルを検索できます。ワークスペースオブジェクトの検索を参照してください。
- スキーマを選択するには、まずカタログを選択し、次にスキーマを選択します。
  
  スキーマの共有の詳細については、「共有へのスキーマの追加」を参照してください。
(オプション)[ 詳細設定のテーブルオプション ] をクリックして、次のオプションを指定します。別名とパーティションは、スキーマ全体を選択した場合は使用できません。テーブル履歴は、スキーマ全体を選択した場合にデフォルトで含まれます。
- エイリアス: テーブル名を読みやすくするための代替テーブル名。エイリアスは、受信者に表示されるテーブル名であり、クエリーで使用する必要があります。エイリアスが指定されている場合、受信者は実際のテーブル名を使用できません。
- パーティション: テーブルの一部のみを共有します。たとえば、 (column = 'value')です。「共有するテーブルパーティションを指定する」および「受信者のプロパティを使用してパーティションフィルター処理を行う」を参照してください。
- 履歴の共有: テーブル履歴を共有して、受信者がタイムトラベルクエリを実行したり、 Spark構造化ストリーミングでテーブルを読み取ったりできるようにします。 Databricks Runtime 12.2 LTS 以上が必要です。
  
  注
  
  タイムトラベルクエリーとストリーミング読み取りに加えて、顧客が table_changes() 関数を使用してテーブルのチェンジデータフィード (CDF) をクエリーできるようにする場合は、テーブルを共有する前にテーブルで CDF を有効にする必要があります WITH HISTORY。
[保存]をクリックします。

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

ALTER SHARE <share-name> ADD TABLE <catalog-name>.<schema-name>.<table-name>  [COMMENT "<comment>"]
   [PARTITION(<clause>)] [AS <alias>]
   [WITH HISTORY | WITHOUT HISTORY];

スキーマ全体を追加するには、以下を実行します。 ADD SCHEMA コマンドには、 Databricks Runtime 13.3 LTS以上を実行している SQL ウェアハウスまたはコンピュートが必要です。スキーマの共有の詳細については、「共有にスキーマを追加する」を参照してください。

ALTER SHARE <share-name> ADD SCHEMA <catalog-name>.<schema-name>
[COMMENT "<comment>"];

オプションは次のとおりです。 PARTITION と AS <alias> は、スキーマ全体を選択した場合は使用できません。 WITH HISTORY は、スキーマ全体を選択した場合、すべてのテーブルに対してデフォルトで選択されます。

PARTITION(<clause>): テーブルの一部のみを共有する場合は、パーティションを指定できます。たとえば、「共有するテーブルパーティションを指定する」および「受信者プロパティを使用してパーティションフィルター処理を行う」(column = 'value') 。
AS <alias>: 代替テーブル名、またはテーブル名を読みやすくするための エイリアス 。エイリアスは、受信者に表示され、クエリで使用する必要があるテーブル名です。エイリアスが指定されている場合、受信者は実際のテーブル名を使用できません。 <schema-name>.<table-name>という形式を使用します。
WITH HISTORY またはWITHOUT HISTORY : WITH HISTORYが指定されている場合は、完全な履歴を含むテーブルが共有され、受信者がタイムトラベルクエリとストリーミング読み取りを実行できるようになります。テーブル共有のデフォルトの動作はWITHOUT HISTORYで、スキーマ共有のデフォルトの動作はWITH HISTORYです。 Databricks Runtime 12.2 LTS 以上が必要です。

注

タイムトラベルクエリーとストリーミング読み取りに加えて、顧客が table_changes() 関数を使用してテーブルのチェンジデータフィード (CDF) をクエリーできるようにする場合は、テーブルを共有する前にテーブルで CDF を有効にする必要があります WITH HISTORY。

ALTER SHARE オプションの詳細については、「 ALTER SHARE 」を参照してください。

テーブルを追加するには、 Databricks CLI を使用して次のコマンドを実行します。

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

スキーマを追加するには、次の Databricks CLI コマンドを実行します。

databricks shares update <share-name> \
  --json '{
    "updates": [
      {
        "action": "ADD",
        "data_object": {
          "name": "<schema-full-name>",
          "data_object_type": "SCHEMA"
        }
      }
    ]
  }'

注

テーブルの場合、およびテーブルのみの場合は、 "data_object_type"を省略できます。

この例にリストされているオプションについては、「SQL」タブの手順を参照してください。

その他のパラメーターについては、 databricks shares update --help を実行するか、REST API リファレンスの PATCH /api/2.1/unity-catalog/shares/ を参照してください。

共有からのテーブルの削除に関する情報については、「共有の更新」を参照してください。

共有するテーブルパーティションを指定する

テーブルを共有に追加するときに、テーブルの一部のみを共有するには、パーティション仕様を指定します。パーティションは、カタログエクスプローラー、Databricks Unity Catalog CLI、または Databricks ノートブックまたは Databricks SQL クエリーエディターの SQL コマンドを使用して、共有にテーブルを追加するとき、または共有を更新するときに指定できます。「共有にテーブルを追加する」および「共有を更新する」を参照してください。

基本的な例

次の SQL 例では、 year、month、および date 列でパーティション分割された inventory テーブル内のデータの一部を共有します。

2021年のデータ。
2020年12月のデータ。
2019年12月25日のデータ。

ALTER SHARE share_name
ADD TABLE inventory
PARTITION (year = "2021"),
          (year = "2020", month = "Dec"),
          (year = "2019", month = "Dec", date = "2019-12-25");

受信者のプロパティを使用してパーティションフィルタリングを実行する

データ受信者のプロパティに一致するテーブルパーティションを共有できます (パラメーター化されたパーティション共有とも呼ばれます)。

デフォルトプロパティは次のとおりです。

databricks.accountId: データ受信者が属する Databricks アカウント (データブリック間の共有のみ)。
databricks.metastoreId: データ受信者が属する Unity Catalog メタストア (DatabricksDatabricks 共有のみ)。
databricks.name: データ受信者の名前。

任意のカスタムプロパティは、受信者を作成または更新するときに作成できます。

受信者プロパティによるフィルター処理を使用すると、複数の Databricks アカウント、ワークスペース、およびユーザー間で同じテーブルを、それらの間のデータ境界を維持しながら、同じ共有を使用して共有できます。

たとえば、テーブルに Databricks アカウント ID 列が含まれている場合は、Databricks アカウント ID で定義されたテーブルパーティションを持つ単一の共有を作成できます。共有すると、 Delta Sharing は各受信者に Databricks アカウントに関連付けられているデータのみを動的に配信します。

プロパティごとに動的にパーティション分割する機能がない場合は、受信者ごとに個別の共有を作成する必要があります。

共有を作成または更新するときに受信者のプロパティでフィルター処理するパーティションを指定するには、カタログエクスプローラーを使用するか、Databricks ノートブックまたは Databricks SQL クエリーエディターで CURRENT_RECIPIENT SQL 関数を使用できます。

注

受信者プロパティは、 Databricks Runtime 12.2 以降で使用できます。

Databricks ワークスペースで、[ カタログ] をクリックします。
カタログパネルの上部にある歯車アイコンをクリックし、 Delta Sharingを選択します。

または、クイックアクセスページでDelta Sharing >]ボタンをクリックします。
「私が共有」タブで、更新する共有を見つけて、その名前をクリックします。
「 資産の管理」>「データ資産の追加」をクリックします。
[ テーブルの追加 ] ページで、テーブルを含むカタログとデータベースを選択し、テーブルを選択します。

テーブルが含まれているカタログとデータベースがわからない場合は、ワークスペース検索を使用して、名前、列名、またはコメントでテーブルを検索できます。ワークスペースオブジェクトの検索を参照してください。
(オプション)「 拡張表オプション 」をクリックして 、パーティション 指定を追加します。

[ テーブルへのパーティションの追加 ] ダイアログで、次の構文を使用してプロパティベースのパーティション指定を追加します。
```
(<column-name> = CURRENT_RECIPIENT().<property-key>)
```
例えば
```
(country = CURRENT_RECIPIENT().'country')
```
[保存]をクリックします。

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

ALTER SHARE <share-name> ADD TABLE <catalog-name>.<schema-name>.<table-name>
   PARTITION (<column-name> = CURRENT_RECIPIENT().<property-key>);

例えば

ALTER SHARE acme ADD TABLE acme.default.some_table
  PARTITION (country = CURRENT_RECIPIENT().'country');

共有にビューを追加する

プレビュー

この機能はパブリックプレビュー段階です。

ビューは、1 つ以上のテーブルまたは他のビューから作成される読み取り専用オブジェクトです。 Unity Catalogメタストア内の複数のスキーマとカタログに含まれるテーブルやその他のビューからビューを作成できます。「ビューの作成と管理」を参照してください。

このセクションでは、カタログエクスプローラー、Databricks CLI、または Databricks ノートブックまたは Databricks SQL クエリエディターの SQL コマンドを使用して、共有にビューを追加する方法について説明します。 Unity Catalog REST API を使用する場合は、REST API リファレンスの「PATCH /api/2.1/unity-catalog/shares/」を参照してください。

必要なアクセス許可: 共有オブジェクトの所有者、ビューを含むカタログとスキーマの USE CATALOG と USE SCHEMA 、およびビューの SELECT 。ビューを共有する限り、 SELECT 権限を維持する必要があります。詳細については、「要件」を参照してください。

追加要件:

ビューの共有は、 DatabricksDatabricks 共有でのみサポートされます。
共有可能なビューは、Delta テーブルまたはその他の共有可能なビューで定義する必要があります。
共有テーブルまたは共有ビューを参照するビューは共有できません。
共有にビューを追加する場合は、 Databricks Runtime 13.3 LTS以降で SQL ウェアハウスまたはクラスターを使用する必要があります。
受信者によるビューの使用に関する要件と制限については、「共有ビューの読み取り」を参照してください。

共有にビューを追加するには:

Databricks ワークスペースで、[ カタログ] をクリックします。
カタログパネルの上部にある歯車アイコンをクリックし、 Delta Sharingを選択します。

または、クイックアクセスページでDelta Sharing >]ボタンをクリックします。
[共有済み]タブで、ビューを追加する共有を見つけて、その名前をクリックします。
「 資産の管理」>「データ資産の追加」をクリックします。
[ テーブルの追加 ] ページで、共有するビューを検索または参照して選択します。
(オプション)[ 高度なテーブルオプション ] をクリックして エイリアスまたは代替ビュー名を指定し、ビュー名を読みやすくします。エイリアスは、受信者に表示される名前であり、クエリーで使用する必要があります。エイリアスが指定されている場合、受信者は実際のビュー名を使用できません。
[保存]をクリックします。

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

ALTER SHARE <share-name> ADD VIEW <catalog-name>.<schema-name>.<view-name>
   [COMMENT "<comment>"]
   [AS <alias>];

オプションは次のとおりです。

AS <alias>: ビュー名を読みやすくするための代替ビュー名またはエイリアス。エイリアスは、受信者に表示され、クエリで使用する必要があるビュー名です。エイリアスが指定されている場合、受信者は実際のビュー名を使用できません。 <schema-name>.<view-name>という形式を使用します。
COMMENT "<comment>": コメントは、カタログエクスプローラの UI に表示され、SQL ステートメントを使用してビューの詳細を一覧表示および表示するときに表示されます。

ALTER SHARE オプションの詳細については、「 ALTER SHARE 」を参照してください。

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

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

"shared_as": "<view-alias>" はオプションであり、ビュー名を読みやすくするための代替ビュー名またはエイリアスを提供します。エイリアスは、受信者に表示され、クエリで使用する必要があるビュー名です。エイリアスが指定されている場合、受信者は実際のビュー名を使用できません。 <schema-name>.<view-name>という形式を使用します。

その他のパラメーターについては、 databricks shares update --help を実行するか、REST API リファレンスの PATCH /api/2.1/unity-catalog/shares/ を参照してください。

共有からビューを削除する方法については、「共有の更新」を参照してください。

動的ビューを共有に追加して行と列をフィルター処理する

プレビュー

この機能はパブリックプレビュー段階です。

動的ビューを使用して、次のようなテーブルデータに対するきめ細かなアクセス制御を構成できます。

列または行レベルでのセキュリティ。
データマスキング。

CURRENT_RECIPIENT() 関数を使用する動的ビューを作成する場合は、受信者定義で指定したプロパティに従って受信者のアクセスを制限できます。

このセクションでは、動的ビューを使用して、行レベルと列レベルの両方でテーブルデータへの受信者のアクセスを制限する例を示します。

要件

Databricks Runtime バージョン: CURRENT_RECIPIENT 関数は、Databricks Runtime 14.2 以降でサポートされています。
権限:
- ビューを作成するには、共有オブジェクトの所有者であり、ビューを含むカタログとスキーマの USE CATALOG と USE SCHEMA 、およびビューの SELECT を持っている必要があります。ビューを共有する限り、 SELECT 権限を維持する必要があります。
- 受信者にプロパティを設定するには、受信者オブジェクトの所有者である必要があります。
制限事項: Databricks 間の共有に対する制限を含む、ビュー共有に関するすべての制限に加えて、次の制限事項があります。
- プロバイダーが CURRENT_RECIPIENT 関数を使用するビューを共有する場合、プロバイダーは共有コンテキストのため、ビューを直接クエリすることはできません。このような動的ビューをテストするには、プロバイダーがビューを自分自身と共有し、受信者としてビューを照会する必要があります。
- プロバイダーは、動的ビューを参照するビューを作成できません。

受信者のプロパティを設定する

これらの例では、共有されるテーブルに countryという名前の列があり、 country プロパティが一致する受信者のみが特定の行または列を表示できます。

受信者のプロパティは、カタログエクスプローラー、Databricks ノートブックの SQL コマンド、または SQL クエリエディターを使用して設定できます。

Databricks ワークスペースで、[ カタログ] をクリックします。
カタログパネルの上部にある歯車アイコンをクリックし、 Delta Sharingを選択します。

または、クイックアクセスページでDelta Sharing >]ボタンをクリックします。
[ 受信者 ] タブで、プロパティを追加する受信者を検索し、その名前をクリックします。
[ プロパティの編集] をクリックします。
受信者 のプロパティを編集 ダイアログで、列名をキー(この場合は country)として入力し、フィルタリングする値を値(例: CA)として入力します。
[保存]をクリックします。

受信者にプロパティを設定するには、 ALTER RECIPIENTを使用します。この例では、 country プロパティが CAに設定されています。

ALTER RECIPIENT recipient1 SET PROPERTIES ('country' = 'CA');

受信者に対する行レベルのアクセス許可を持つ動的ビューを作成する

この例では、 country プロパティが一致する受信者のみが特定の行を表示できます。

CREATE VIEW my_catalog.default.view1 AS
  SELECT * FROM my_catalog.default.my_table
  WHERE country = CURRENT_RECIPIENT('country');

また、データプロバイダーは、ファクトテーブルフィールドを受信者プロパティにマップする別のマッピングテーブルを保持し、受信者プロパティとファクトテーブルフィールドを分離して柔軟性を高めることもできます。

受信者に対する列レベルのアクセス許可を持つ動的ビューを作成する

この例では、 country プロパティに一致する受信者のみが特定の列を表示できます。他のユーザーは、返されるデータを次のように REDACTEDします。

CREATE VIEW my_catalog.default.view2 AS
  SELECT
  CASE
    WHEN CURRENT_RECIPIENT('country') = 'US' THEN pii
    ELSE 'REDACTED'
  END AS pii
  FROM my_catalog.default.my_table;

共有にボリュームを追加する

ボリュームは、クラウドオブジェクトのストレージ場所にあるストレージの論理ボリュームを表すUnity Catalogオブジェクトです。これらは主に、表形式以外のデータ資産に対するガバナンスを提供することを目的としています。 Unity Catalogボリュームとは何ですか?」を参照してください。

このセクションでは、カタログエクスプローラー、Databricks CLI、または Databricks ノートブックまたは SQL クエリエディターの SQL コマンドを使用して、共有にボリュームを追加する方法について説明します。 Unity Catalog REST API を使用する場合は、REST API リファレンスの「PATCH /api/2.1/unity-catalog/shares/」を参照してください。

注

ボリュームコメントは、2024 年 7 月 25 日以降にDatabricks-to-Databricks共有を使用して受信者と共有される共有に含まれます。リリース日より前に受信者と共有された共有を通じてコメントの共有を開始する場合、コメント共有をトリガーするには、受信者のアクセス権を取り消して再付与する必要があります。

必要なアクセス許可: 共有オブジェクトの所有者、ボリュームを含むカタログとスキーマの USE CATALOG と USE SCHEMA 、およびボリュームの READ VOLUME 。ボリュームを共用する限り、 READ VOLUME 特権を維持する必要があります。詳細については、「要件」を参照してください。

追加要件:

ボリューム共有は、Databricks 間共有でのみサポートされます。
共有にボリュームを追加する場合は、バージョン 2023.50 以降の SQLウェアハウス、または Databricks Runtime 14.1 以降のクラスターを使用する必要があります。
プロバイダー側のボリュームストレージにカスタムネットワーク構成 (ファイアウォールやプライベートリンクなど) がある場合、プロバイダーは、受信者のコントロールプレーンとデータプレーンのアドレスが適切に許可リストに登録され、ボリュームのストレージの場所に接続できるようにする必要があります。

ボリュームを共有に追加するには、以下の手順に従ってください。

Databricks ワークスペースで、[ カタログ] をクリックします。
カタログパネルの上部にある歯車アイコンをクリックし、 Delta Sharingを選択します。

または、クイックアクセスページでDelta Sharing >]ボタンをクリックします。
[共有済み]タブで、ボリュームを追加する共有を見つけて、その名前をクリックします。
「 アセットの管理」>「アセットの編集」をクリックします。
[ アセットの編集 ] ページで、共有するボリュームを検索または参照して選択します。

または、ボリュームを含むスキーマ全体を選択することもできます。「共有にスキーマを追加する」を参照してください。
(オプション)「 詳細オプション 」をクリックして、代替ボリューム名または別名を指定して、ボリューム名を読みやすくします。

エイリアスは、スキーマ全体を選択した場合は使用できません。

エイリアスは、受信者に表示され、クエリで使用する必要がある名前です。エイリアスが指定されている場合、受信者は実際のボリューム名を使用できません。
[保存]をクリックします。

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

ALTER SHARE <share-name> ADD VOLUME <catalog-name>.<schema-name>.<volume-name>
   [COMMENT "<comment>"]
   [AS <alias>];

オプションは次のとおりです。

AS <alias>: ボリューム名を読みやすくするための代替ボリューム名またはエイリアス。エイリアスは、受信者に表示され、クエリで使用する必要があるボリューム名です。エイリアスが指定されている場合、受信者は実際のボリューム名を使用できません。 <schema-name>.<volume-name>という形式を使用します。
COMMENT "<comment>": コメントは、カタログエクスプローラの UI と、SQL ステートメントを使用してボリュームの詳細を一覧表示および表示するときに表示されます。

ALTER SHARE オプションの詳細については、「 ALTER SHARE 」を参照してください。

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

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

"string_shared_as": "<volume-alias>" はオプションであり、ボリューム名を読みやすくするための代替ボリューム名または別名を提供します。エイリアスは、受信者に表示され、クエリで使用する必要があるボリューム名です。エイリアスが指定されている場合、受信者は実際のボリューム名を使用できません。 <schema-name>.<volume-name>という形式を使用します。

その他のパラメーターについては、 databricks shares update --help を実行するか、REST API リファレンスの PATCH /api/2.1/unity-catalog/shares/ を参照してください。

共有からボリュームを削除する方法については、「共有の更新」を参照してください。

共有にモデルを追加する

このセクションでは、カタログエクスプローラー、Databricks CLI、または Databricks ノートブックまたは SQL クエリエディターの SQL コマンドを使用して、共有にモデルを追加する方法について説明します。 Unity Catalog REST API を使用する場合は、REST API リファレンスの「PATCH /api/2.1/unity-catalog/shares/」を参照してください。

注

モデルコメントとモデルバージョンコメントはDatabricks-to-Databricksを使用して共有される共有に含まれます。

必要なアクセス許可: 共有オブジェクトの所有者、モデルを含むカタログとスキーマの USE CATALOG と USE SCHEMA 、およびモデルの EXECUTE 。モデルを共有する限り、 EXECUTE 権限を維持する必要があります。詳細については、「要件」を参照してください。

追加要件:

モデル共有は、 DatabricksからDatabricks への共有でのみサポートされます。
共有にモデルを追加するときは、バージョン 2023.50 以降の SQLウェアハウス、または Databricks Runtime 14.0 以降のクラスターを使用する必要があります。

共有にモデルを追加するには:

Databricks ワークスペースで、[ カタログ] をクリックします。
カタログパネルの上部にある歯車アイコンをクリックし、 Delta Sharingを選択します。

または、クイックアクセスページでDelta Sharing >]ボタンをクリックします。
[共有済み]タブで、モデルを追加する共有を見つけて、その名前をクリックします。
「 アセットの管理」>「アセットの編集」をクリックします。
[ アセットの編集 ] ページで、共有するモデルを検索または参照して選択します。

または、モデルを含むスキーマ全体を選択することもできます。「共有にスキーマを追加する」を参照してください。
(オプション)[ 詳細オプション ] をクリックして、代替モデル名または [エイリアス] を指定して、モデル名を読みやすくします。

エイリアスは、スキーマ全体を選択した場合は使用できません。

エイリアスは、受信者に表示され、クエリで使用する必要がある名前です。エイリアスが指定されている場合、受信者は実際のモデル名を使用できません。
[保存]をクリックします。

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

ALTER SHARE <share-name> ADD MODEL <catalog-name>.<schema-name>.<model-name>
   [COMMENT "<comment>"]
   [AS <alias>];

オプションは次のとおりです。

AS <alias>: モデル名を読みやすくするための代替モデル名またはエイリアス。エイリアスは、受信者に表示され、クエリで使用する必要があるモデル名です。エイリアスが指定されている場合、受信者は実際のモデル名を使用できません。 <schema-name>.<model-name>という形式を使用します。
COMMENT "<comment>": コメントは、カタログエクスプローラーの UI と、SQL ステートメントを使用してモデルの詳細をリストおよび表示するときに表示されます。

ALTER SHARE オプションの詳細については、「 ALTER SHARE 」を参照してください。

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

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

"string_shared_as": "<model-alias>" はオプションであり、モデル名を読みやすくするために代替モデル名またはエイリアスを提供します。エイリアスは、受信者に表示され、クエリで使用する必要があるモデル名です。エイリアスが指定されている場合、受信者は実際のモデル名を使用できません。 <schema-name>.<model-name>という形式を使用します。

その他のパラメーターについては、 databricks shares update --help を実行するか、REST API リファレンスの PATCH /api/2.1/unity-catalog/shares/ を参照してください。

共有からモデルを削除する方法については、「共有の更新」を参照してください。

ノートブックファイルを共有に追加する

カタログエクスプローラーを使用して、ノートブックファイルを共有に追加します。

注

ノートブックを共有するには、メタストアにメタストアレベルのストレージが必要です。

必要な権限: 共有オブジェクトの所有者、および共有するノートブックに対する CAN READ 権限。

Databricks ワークスペースで、[ カタログ] をクリックします。
カタログパネルの上部にある歯車アイコンをクリックし、 Delta Sharingを選択します。

または、クイックアクセスページでDelta Sharing >]ボタンをクリックします。
[共有]タブで、ノートブックを追加する共有を見つけて、その名前をクリックします。
「 資産の管理 」をクリックし、「 ノートブック・ファイルの追加」を選択します。
[ ノートブックファイルの追加 ] ページで、ファイルアイコンをクリックして、共有するノートブックを参照します。

共有するファイルをクリックし 、[選択] をクリックします。

(オプションで) [ 共有方法 ] フィールドでファイルのわかりやすいエイリアスを指定します。これは、受信者に表示される識別子です。
[保存]をクリックします。

共有ノートブックファイルが [資産] タブの [ノートブックファイル] リストに表示されます。

共有からノートブックファイルを削除する

共有からノートブックファイルを削除するには:

Databricks ワークスペースで、[ カタログ] をクリックします。
カタログパネルの上部にある歯車アイコンをクリックし、 Delta Sharingを選択します。

または、クイックアクセスページでDelta Sharing >]ボタンをクリックします。
[共有済み]タブで、ノートブックが含まれている共有を見つけて、共有名をクリックします。
[資産] タブで、共有から削除するノートブックファイルを見つけます。
クリック行の右側にあるケバブメニューをクリックし、ノートブックファイルの削除を選択します。
確認ダイアログで、[ 削除] をクリックします。

共有内のノートブックファイルを更新する

既に共有しているノートブックを更新するには、そのノートブックを再度追加し、[ 共有] フィールドに新しいエイリアスを指定する必要があります。 Databricks では、ノートブックの改訂された状態を示す名前 ( <old-name>-update-1など) を使用することをお勧めします。受信者に変更を通知する必要がある場合があります。受信者は、更新を利用するために新しいノートブックを選択して複製する必要があります。

共有を更新する

テーブル、ビュー、ボリューム、ノートブックを共有に追加するだけでなく、次の操作も実行できます。

共有の名前を変更します。
共有からテーブル、ビュー、ボリューム、およびスキーマを削除します。
共有のコメントを追加または更新します。
テーブルの履歴データへのアクセスを有効または無効にして、受信者がテーブルのタイムトラベルまたはストリーミング読み取りを実行できるようにします。
パーティション定義を追加、更新、または削除します。
共有所有者を変更します。

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

必要なアクセス許可: 共有所有者を更新するには、メタストア管理者、共有オブジェクトの所有者、または USE SHARE と SET SHARE PERMISSION の両方の特権を持つユーザーのいずれかである必要があります。共有名を更新するには、メタストア管理者 (または CREATE_SHARE 特権を持つユーザー) であり 、共有所有者である必要があります。その他の共有プロパティを更新するには、所有者である必要があります。

Databricks ワークスペースで、[ カタログ] をクリックします。
カタログパネルの上部にある歯車アイコンをクリックし、 Delta Sharingを選択します。

または、クイックアクセスページでDelta Sharing >]ボタンをクリックします。
「私が共有」タブで、更新する共有を見つけて、その名前をクリックします。

共有の詳細ページで、次の操作を行います。

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

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

共有の名前を変更します。

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

共有からテーブルを削除します。

ALTER SHARE share_name REMOVE TABLE <table-name>;

共有からボリュームを削除します。

ALTER SHARE share_name REMOVE VOLUME <volume-name>;

共有にコメントを追加または更新します。

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

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

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

共有所有者の変更:

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

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

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

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

ALTER SHARE パラメーターの詳細については、「 ALTER SHARE」を参照してください。

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

共有の名前を変更します。

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

共有からテーブルを削除します。

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 以降を使用)。

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 を使用します。

共有にコメントを追加または更新します。

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

共有所有者の変更:

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

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

Delta Sharing の共有の作成と管理

要件

共有オブジェクトを作成する

共有にテーブルを追加する

共有するテーブル パーティションを指定する

基本的な例

受信者のプロパティを使用してパーティション フィルタリングを実行する

削除ベクトルまたは列マッピングを持つテーブルを共有に追加する

共有にビューを追加する

動的ビューを共有に追加して行と列をフィルター処理する

要件

受信者のプロパティを設定する

受信者に対する行レベルのアクセス許可を持つ動的ビューを作成する

受信者に対する列レベルのアクセス許可を持つ動的ビューを作成する

動的ビューを受信者と共有する

共有にボリュームを追加する

共有にモデルを追加する

共有へのスキーマの追加

ノートブック ファイルを共有に追加する

共有からノートブック ファイルを削除する

共有内のノートブック ファイルを更新する

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

共有と共有の詳細を表示する

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

共有を更新する

共有を削除する

共有するテーブルパーティションを指定する

受信者のプロパティを使用してパーティションフィルタリングを実行する

ノートブックファイルを共有に追加する

共有からノートブックファイルを削除する

共有内のノートブックファイルを更新する