シェアとは、Unity Catalog内のセキュア可能なオブジェクトで、1人以上の受信者と共有したいデータやAI資産の集合を表します。 シェアを作成し、そこに資産を追加し、受信者にアクセス権を付与します。
シェアには以下のデータ資産が含まれます:
- テーブルとテーブルパーティション
- ストリーミングテーブル
- マネージドIcebergテーブル
- 外部 Iceberg テーブル
- 外国Deltaテーブル
- 外部スキーマとテーブル
- 動的ビューを含むビュー、つまり行レベルやカラムレベルでアクセスを制限するビュー
- マテリアライズド・ビュー
- メトリックビュー
- ボリューム
- エージェントのスキル
- Python UDFs
- ノートブック
- AIモデル
- ジーニー・エージェント
スキーマ全体(データベース)を共有した場合、受信者は共有時点でスキーマ内のすべてのテーブル、ストリーミングテーブル、ビュー、マテリアル化されたビュー、モデル、ボリューム、エージェントスキルにアクセスでき、さらに将来スキーマに追加されるデータやAIアセットも利用できます。
共有には、1 つの Unity Catalog メタストアからのデータと AI 資産のみを含めることができます。 共有からのデータと AI 資産は、いつでも追加または削除できます。
共有を作成する前に、 アカウント (プロバイダー) の OpenSharing が設定されていることを確認します。
共有モデルの詳細については、「 共有、プロバイダー、受信者」を参照してください。
必要条件
完了する各タスクの一覧の要件を満たしていることを確認します。
Tip
データ資産を共有に追加する場合、Databricks では、共有所有者としてグループを使用することをお勧めします。
| Task | 必要条件 |
|---|---|
| 共有を作成する |
|
共有に次のコードを追加します。
|
|
| スキーマ全体または外部スキーマを共有する |
|
| 共有にボリュームを追加する |
|
| エージェントスキルをシェアに追加 |
|
| Python UDF を共有に追加する |
|
| 共有にモデルを追加する |
|
| ノートブック ファイルを共有に追加する |
|
コンピューティング要件
- Databricks ノートブックを使用して共有を作成する場合、コンピューティング リソースは Databricks Runtime 11.3 LTS 以降を使用し、標準または専用のアクセス モード (以前は共有およびシングル ユーザー) を持っている必要があります。
- SQL ステートメントを使用してスキーマを共有に追加する (もしくはスキーマを更新または削除する) 場合は、Databricks Runtime 13.3 LTS 以降を実行している SQL ウェアハウスまたはコンピューティングを使用する必要があります。 カタログ エクスプローラーを使用して同じことを行う場合にはコンピューティング要件はありません。
共有オブジェクトを作成する
共有オブジェクトを作成する前に 、要件 を満たしていることを確認します。
共有を作成するには、Azure Databricks ノートブックまたは Databricks SQL クエリ エディターで、カタログ エクスプローラー、Databricks Unity カタログ CLI、または CREATE SHARE SQL コマンドを使用します。
カタログ エクスプローラー
Azure Databricks ワークスペースで、
Catalog をクリックします。
[カタログ] ウィンドウの上部にある
をクリックします。歯車アイコンをクリックし、[OpenSharing] を選択します。
または、右上隅の [ 共有] > [OpenSharing] をクリックします。
[自分と共有] タブで、[データの共有] ボタンをクリックします。
[共有の作成] ページで、共有の [名前] とオプションのコメントを入力します。
[ 保存] をクリックして続行します。
データ資産の追加を継続することも、停止して後で再開することもできます。
[ データ資産の追加 ] タブで、共有するデータ資産を選択します。
詳細な手順、追加の要件、および関連する制限事項については、次を参照してください。
[ 保存] をクリックして続行します。
[ノートブックの追加] タブで、共有するノートブックを選択します。
詳細な手順については、「ノートブック ファイルを共有に追加する」を参照してください。
[ 保存] をクリックして続行します。
[受信者の追加] タブで、共有する受信者を選択します。
詳細な手順については、「 OpenSharing データ共有へのアクセスの管理 (プロバイダー向け)」を参照してください。
[データの共有] をクリックして、受信者とデータを共有します。
受信者をまだ作成していない場合は、[データの 共有] をクリックして受信者を作成し、後でアクセス権を付与します。
SQL
ノートブックまたは Databricks SQL クエリ エディターで次のコマンドを実行します。
CREATE SHARE [IF NOT EXISTS] <share-name>
[COMMENT "<comment>"];
これで、テーブル、ストリーミング テーブル、ボリューム、ビュー、具体化されたビュー、モデルを共有に追加できるようになりました。
詳細な手順、追加の要件、および関連する制限事項については、次を参照してください。
- 共有にテーブルを追加する
- ストリーミングテーブルをシェアに追加
- マネージド Iceberg テーブルを共有に追加する
- 共有に外部スキーマやテーブルを追加する
- シェアにボリュームを追加する
- 共有にビューを追加
- 共有にマテリアライズドビューを追加
- シェアにメトリックビューを追加
- シェアにモデルを追加
CLI
Databricks CLI を使用して次のコマンドを実行します。
databricks shares create <share-name>
--comment を使用してコメントを追加したり、--json を使用して共有に資産を追加したりできます。 詳細については、続くセクションを参照してください。
これで、テーブル、ストリーミング テーブル、ボリューム、ビュー、具体化されたビュー、モデルを共有に追加できるようになりました。
詳細な手順、追加の要件、および関連する制限事項については、次を参照してください。
- 共有にテーブルを追加する
- ストリーミングテーブルをシェアに追加
- 管理Icebergテーブルを共有に追加する
- 共有に外部スキーマやテーブルを追加する
- シェアにボリュームを追加する
- 共有先にビューを追加する
- 共有にマテリアライズドビューを追加する
- シェアにメトリックビューを追加
- シェアにモデルを追加
共有にテーブルを追加する
共有にテーブルを追加する前に 、要件 を満たしていることを確認します。 共有できないテーブルもあります。 「サポートされていない表」を参照してください。
ワークスペース管理者であり、テーブルを含むスキーマとカタログに対する USE SCHEMA および USE CATALOG の権限をワークスペース管理者グループから継承している場合は、テーブルを共有に追加することはできません。 先にそのスキーマとカタログに対する USE SCHEMA および USE CATALOG のアクセス許可を、自分自身に付与する必要があります。
注
2024 年 7 月 25 日以降、Databricks 間の共有を使用して受信者と共有する共有には、テーブル コメント、列コメント、および主キー制約が含まれます。 リリース日より前に受信者と共有した共有を通じてコメントと制約の共有を開始する場合は、受信者のアクセスを取り消し、もう一度付与して、コメントと制約の共有をトリガーする必要があります。
共有にテーブルを追加するには、Azure Databricks ノートブックまたは Databricks SQL クエリ エディターで、カタログ エクスプローラー、Databricks Unity カタログ CLI、または SQL コマンドを使用します。
カタログ エクスプローラー
Azure Databricks ワークスペースで、
Catalog をクリックします。
[カタログ] ウィンドウの上部にある
をクリックします。歯車アイコンをクリックし、[OpenSharing] を選択します。
または、右上隅の [ 共有] > [OpenSharing] をクリックします。
[自分と共有] タブで、テーブルの追加先となる共有を見つけてその名前をクリックします。 行追跡が有効になっているテーブルを追加できます。 受信者は、行追跡列に対してクエリを実行できます。
[資産の管理] > [資産の編集] をクリックします。
[ 資産の編集] ページで、スキーマ全体 (データベース) または個々のテーブルを選択します。
テーブルを選択するには、まずカタログ、次にテーブルを含むスキーマ、次にテーブル自体を選択します。
ワークスペース検索を使用して、名前、列名、またはコメントでテーブルを検索できます。 「ワークスペース オブジェクトを検索する」を参照してください。
スキーマを選択するには、まずカタログを選択してからスキーマを選択します。
スキーマの共有の詳細については、「共有にスキーマを追加する」を参照してください。
履歴: テーブル履歴を共有し、受信者がタイムトラベルクエリを実行したり、Spark構造化ストリーミングでテーブルを読んだり、トランザクションを実行したりできるようにします。 Databricks から Databricks への共有の場合、テーブルの Delta ログも共有され、パフォーマンスが向上します。 履歴共有によるテーブル読み取りパフォーマンスの向上を参照してください。 履歴共有には、Databricks Runtime 12.2 LTS 以降が必要です。
注
table_changes() 関数を使用して顧客がテーブルの変更データ フィード (CDF) に対してクエリを実行できるようにする場合は、共有する前
WITH HISTORY必要があります。(省略可能)[
をクリックします。 エイリアス 列または パーティション 列の下にエイリアスまたはパーティションを追加します。 スキーマ全体を選択すると、エイリアスとパーティションは使用できません。 スキーマ全体を選択すると、テーブル履歴が既定で含まれます。
- エイリアス:テーブル名をより読みやすくするための代替テーブル名。 別名は、受信者に表示されるテーブル名であり、クエリ内で使用する必要があります。 別名が指定されている場合、受信者は実際のテーブル名を使用できません。
-
パーティション:テーブルの一部だけを共有する。 たとえば、「
(column = 'value')」のように入力します。 「共有するテーブル パーティションを指定する」と「受信者プロパティを使用してパーティションのフィルター処理を行う」を参照してください。
保存 をクリックします。
SQL
テーブルを追加するには、ノートブックまたは 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> は、スキーマ全体を選択した場合は利用できません。
PARTITION(<clause>):テーブルの一部だけを共有したい場合はパーティションを指定することができます。 たとえば、(column = 'value')。「共有するテーブル パーティションを指定する」と「受信者プロパティを使用してパーティションのフィルター処理を行う」を参照してください。AS <alias>: 代替テーブル名、またはテーブル名をより読みやすくするための エイリアス 。 別名は、受信者に表示されるテーブル名であり、クエリ内で使用する必要があります。 別名が指定されている場合、受信者は実際のテーブル名を使用できません。 「<schema-name>.<table-name>」の形式を使用します。WITH HISTORYまたはWITHOUT HISTORY:WITH HISTORYが指定されたら、完全な履歴付きテーブルを共有し、受信者がタイムトラベルクエリ、ストリーミングリード、 トランザクション実行を可能にします。 Databricks から Databricks への共有の場合、履歴共有ではテーブルの Delta ログも共有され、パフォーマンスが向上します。 テーブル共有の既定の動作は、コンピューティングで Databricks Runtime 16.2 以降が実行されている場合はWITH HISTORYであり、以前のバージョンの Databricks Runtime の場合はWITHOUT HISTORYです。 スキーマ共有の場合、Databricks ランタイムのバージョンに関係なく、既定値はWITH HISTORYです。WITH HISTORYおよびWITHOUT HISTORYにはDatabricks Runtime 12.2 LTS以上が必要です。 「履歴共有を使用してテーブルの読み取りパフォーマンスを向上させる」も参照してください。注
タイム トラベル クエリとストリーミング読み取りを実行するだけでなく、受信者が table_changes() 関数を使用してテーブルの変更データ フィード (CDF) に対してクエリを実行する場合は、共有する前
WITH HISTORY必要があります。
ALTER SHARE オプションの詳細については、「ALTER SHARE」を参照してください。
CLI
テーブルを追加するには、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/ を参照してください。
共有からのテーブルの削除については、「共有を更新する」を参照してください。
クラウド トークンの適格性
Azure Databricksは、クラウド トークン (一時的なパス スコープのクラウド資格情報) を使用して、受信者に共有 Delta テーブル ファイルへの直接読み取りアクセスを許可します。 Databricks から Open への共有プロトコルでは、これは ディレクトリ ベースのアクセス モードとも呼ばれます。 ビュー、マテリアル化されたビュー、外国テーブル(外国のDeltaテーブルおよび外国のIcebergテーブルを除く)、ストリーミングテーブル、ボリューム、ノートブック、Python UDF、AIモデルはサポートされていません。 使用するテーブルは、共有プロトコルによって決まります。
DatabricksからDatabricksへの共有:クラウドトークンは、以下すべてが成り立つ場合に使用されます。
- テーブルは最初からの完全な履歴と共に
WITH HISTORY共有されています。 - テーブルはパーティション フィルターなしで共有されます。
DatabricksからOpenへの共有:クラウドトークン(ディレクトリベースアクセスモード)は、以下すべてが正しい場合に使用されます。
- 共有オブジェクトは、 マネージド テーブルまたは外部 Delta テーブルです。
- テーブルは最初からの完全な履歴と共に
WITH HISTORY共有されています。 - テーブルはパーティション フィルターなしで共有されます。
- テーブルが CCv2 テーブルではありません。
- テーブルでは、既定のストレージは使用されません。
事前署名されたURLアクセスは、OneLakeに保存されているマネージド Delta テーブルまたは外部 Delta テーブルをサポートしていません。 事前署名されたURLを使用する受信者クエリは DS_INVALID_AZURE_PATH エラーで失敗します。 これらのテーブルを共有するには、WITH HISTORY として、かつパーティション フィルターを指定せずに共有してください。そうすることで、受信者はクラウド トークンを使用してテーブルを読み取ることができます。 Databricks-to-Open共有の受信者も、ディレクトリベースアクセスをサポートするクライアントを使用しなければなりません。
Databricks から Databricks への共有の場合、クラウド トークンは、有効期間の長いベアラー トークンを使用せずに Unity カタログ メタストア間で直接交換されるため、直接ソース テーブル アクセスと同等のパフォーマンスが得られます。 Databricks から Open への共有の場合、OpenSharing サーバーには、テーブルのクラウド ストレージの場所と、リストとメタデータの応答に accessModes: ["url", "dir"] が含まれます。 開いている受信者は、 一時テーブル資格情報の生成 エンドポイントを呼び出して資格情報を取得し、クラウド ストレージから直接読み取ることができます。
Important
クラウド トークン アクセスを使用すると、受信者は共有 Delta テーブルのルート ディレクトリを対象にした資格情報を受け取ります。 これにより、データ ファイルとデルタ ログの両方への読み取りアクセスが許可されます。 Delta ログには、各テーブル バージョンのコミット履歴、コミッターに関する情報、およびバキュームされていない削除されたデータが含まれます。
クラウドトークンの対象でないテーブルは、事前署名されたURLで共有されます。これはDatabricks-to-Open共有プロトコルでは URLベースのアクセスモード とも呼ばれます。 受信者はこれらのテーブルで以下のコマンドを実行することはできません:
受信者がこれらのコマンドを実行する必要がある場合は、テーブルが共有プロトコルのクラウドトークン適格要件を満たしているか確認してください。
共有するテーブルパーティションを指定する
共有にテーブルを追加するときにテーブルの一部のみを共有するには、パーティションの仕様を指定します。 Azure Databricks ノートブックまたは Databricks SQL クエリ エディターで、カタログ エクスプローラー、Databricks Unity カタログ CLI、または SQL コマンドを使用して、共有にテーブルを追加したり、共有を更新したりするときにパーティションを指定します。 「共有にテーブルを追加する」と「共有を更新する」を参照してください。
例
次の SQL の例では、inventory 列、year 列、month 列でパーティション分割されている date テーブル内のデータの一部を共有しています。
- 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: データ受信者が属するAzure Databricksアカウント(Databricks間共有のみ)。 -
databricks.metastoreId: データ受信者が属するUnity Catalogのメタストア(Databricks間共有のみ)。 -
databricks.name:データ受信者の名前。
受信者を作成または更新するときに、任意のカスタム プロパティを作成できます。
受信者プロパティ別にフィルター処理を行うと、複数の Databricks アカウント間、ワークスペース間、ユーザー間で、同じ共有を使用して同じテーブルを共有する間も、それらのデータ境界を維持できます。
たとえば、テーブルに Azure Databricks アカウント ID 列が含まれている場合、Azure Databricks アカウント ID によって定義されたテーブル パーティションを持つ 1 つの共有を作成できます。 共有すると、OpenSharing は、Azure Databricks アカウントに関連付けられているデータのみを各受信者に動的に配信します。
プロパティごとに動的にパーティション分割する機能がない場合は、受信者ごとに個別の共有を作成する必要があります。
共有を作成または更新するときに受信者のプロパティでフィルター処理するパーティションを指定するには、カタログ エクスプローラーまたは Azure Databricks ノートブックまたは Databricks SQL クエリ エディターで CURRENT_RECIPIENT SQL 関数を使用できます。
注
受信者のプロパティは、Databricks Runtime 12.2 以降で使用できます。
カタログ エクスプローラー
Azure Databricks ワークスペースで、
Catalog をクリックします。
[カタログ] ウィンドウの上部にある
をクリックします。歯車アイコンをクリックし、[OpenSharing] を選択します。
または、右上隅の [ 共有] > [OpenSharing] をクリックします。
[自分と共有] タブで、更新する共有を見つけ、その名前をクリックします。
[資産の管理] > [データ資産の追加] をクリックします。
[テーブルの追加] ページで、テーブルが含まれるカタログとデータベースを選択してから、テーブルを選択します。
テーブルを含むカタログとデータベースがわからない場合は、ワークスペース検索を使用して名前、列名、またはコメントで検索できます。 「ワークスペース オブジェクトを検索する」を参照してください。
(省略可能) パーティションを追加するには、
Speech bubble plus icon.[パーティション] 列で をクリックします。
[ テーブルへのパーティションの追加 ] ダイアログで、次の構文を使用してプロパティ ベースのパーティション仕様を追加します。
(<column-name> = CURRENT_RECIPIENT().<property-key>)たとえば、
(country = CURRENT_RECIPIENT().country)保存 をクリックします。
SQL
ノートブックまたは 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);
削除ベクターや列マッピング付きのテーブルをシェアに追加する
削除ベクトルは、Delta テーブルで有効にできるストレージ最適化機能です。 Databricks の削除ベクトルを参照してください。
Azure Databricks では、Delta テーブルの列マッピングもサポートされています。 「Delta Lake 列マッピングを使用して列の名前を変更および削除する」を参照してください。
削除ベクトルまたは列マッピングを含むテーブルを共有するには、それを履歴と共に共有する必要があります。 「共有にテーブルを追加する」を参照してください。
削除ベクターまたは列マッピングを持つテーブルを共有する場合、受信者は SQL ウェアハウス、Databricks Runtime 14.1 以降を実行しているコンピューティング、またはオープン ソースを実行しているコンピューティング (3.1 以上 delta-sharing-spark ) を使用してテーブルのクエリを実行できます。 「削除ベクトルまたは列マッピングが有効になっているテーブルの読み取り」と「削除ベクトルまたは列マッピングが有効になっているテーブルの読み取り」を参照してください。
シェアにスキーマを追加する
共有にスキーマを追加する前に 、要件 を満たしていることを確認します。
共有にスキーマ全体を追加すると、共有の作成時にスキーマ内のすべてのデータ資産にアクセスできるだけでなく、時間の経過と共にスキーマに追加されるすべての資産に受信者がアクセスできるようになります。 これにはスキーマ内のすべてのテーブル、ビュー、ボリューム、エージェントスキルが含まれます。 この方法で共有されるテーブルには、常に完全な履歴が含まれます。 スキーマ内のエージェントスキルは Azure Databricks の受信者にのみ共有されます。
受信者とスキーマを共有する
共有にスキーマを追加するには、スキーマの追加方法を指定する内容に注意しながら、「共有にテーブルを追加する」の手順に従ってください。
SQL を使用してスキーマを追加、更新、削除するには、Databricks Runtime 13.3 LTS 以降を実行している SQL ウェアハウスまたはコンピューティングが必要です。 カタログ エクスプローラーを使用して同じことを行う場合にはコンピューティング要件はありません。
制限事項
サポートされていないデータ資産がスキーマに含まれている場合でも、スキーマを共有できます。 これらの資産はフィルターで除外され、受信者と共有されません。 サポートされていないデータ資産には、次のものがあります。
- パーティション フィルター処理で液体クラスタリングを使用するテーブル
- V2 チェックポイントを含む R2 テーブル
- 照合順序が有効になっているテーブル
- 行フィルターまたは列マスクを含むテーブル
-
SHALLOW CLONEテーブル - 共有テーブルにおける外部鍵制約
スキーマ全体を共有する場合、テーブルエイリアス、パーティション、ボリュームエイリアスは使用できません。 スキーマ内の資産にエイリアスまたはパーティションを作成した場合、スキーマ全体を共有に追加すると、それらは削除されます。
スキーマ内のテーブルまたはボリュームの詳細オプションを指定する場合は、SQL を使用してテーブルまたはボリュームを共有し、テーブルまたはボリュームに別のスキーマ名の別名を付ける必要があります。
スキーマ レベルのエイリアスはサポートされていません。 異なるカタログの同じ名前のスキーマを同じ共有に追加することはできません。 代わりに、エイリアス化されたスキーマ名を持つ個々のテーブルを共有します。
ABACポリシーで保護されたテーブルやスキーマをシェアに追加する
属性ベースアクセス制御(ABAC)は、Azure Databricks全体で柔軟かつスケーラブル、かつ集中管理されたアクセス制御を提供するデータガバナンスモデルです。
標準テーブルなどの ABAC ポリシーによってセキュリティ保護されたテーブルまたはスキーマを共有できます。 ABAC ポリシーをデータ資産に適用する方法については、「 行フィルターポリシーと列マスク ポリシーの作成と管理」を参照してください。
ただし、 特権ユーザーである必要があります。 特権ユーザーとは、共有所有者 であり、 データ資産に適用される ABAC ポリシーから除外されるユーザーです。 このポリシーでは、受信者のアクセスは管理されません。 受信者は、共有資産へのフル アクセス権を持ちます。 ABACの制限が適用されます。
ストリーミングテーブルをシェアに追加
ストリーミング テーブルは通常の Delta テーブルであり、ストリーミングまたは増分データ処理を追加でサポートしています。 ストリーミングテーブルは追加のみのデータソース向けに設計されており、各入力を一度だけ処理します。 スタンドアロン ストリーミング テーブルの使用を参照してください。
ストリーミング テーブルを共有に追加する前に 、要件 を満たしていることを確認します。
その他の要件
- ワークスペースでワークスペース カタログ バインドが有効になっている場合は、ストリーミング テーブルが存在するカタログに対する読み取りおよび書き込みアクセス権がワークスペースにあることを確認します。 詳細については、「 ワークスペース カタログ のバインド」を参照してください。
- 共有可能なストリーミング テーブルは、Delta テーブルまたはその他の共有可能なストリーミング テーブルまたはビューで定義する必要があります。
- ストリーミング テーブルを共有に追加するときは、Databricks Runtime 13.3 LTS 以降で SQL ウェアハウスまたはコンピューティングを使用する必要があります。
制限事項
- ストリーミング テーブルに行フィルターと列マスクを含めることはできません。
- ストリーミング テーブルのベース テーブルには、行フィルターと列マスクを含めることができます。
- ストリーミング テーブルにパーティション フィルターを設定することはできません。 代わりに、ストリーミング テーブルの上にビューを作成します。
- Databricks から Open への共有受信者は、ストリーミング テーブルの現在のスナップショットのみを読み取ることができます。 時間移動、クエリ履歴、ストリーミング読み取り、および CDF は、開いている受信者ではサポートされていません。 受信者に CDF が必要な場合は、CDF を有効にして通常の Delta テーブルを共有します。
- 受信者が基になるデータに直接アクセスできない場合、
LIMIT句と述語のプッシュダウンはサポートされません。 システムは、クエリ フィルターに関係なく、受信者に返す前にすべてのクエリ結果を完全に具体化します。 「 受信者が共有ビュー、具体化されたビュー、およびストリーミング テーブルの基になるデータに直接アクセスできるか」を参照してください。 - ストリーミング テーブルの一般的な制限も適用されます。 ストリーミング テーブルの制限事項を参照してください。
ストリーミング テーブルを受信者と共有する
ストリーミング テーブルを共有に追加するには:
カタログ エクスプローラー
Azure Databricks ワークスペースで、
Catalog をクリックします。
[カタログ] ウィンドウの上部にある
をクリックします。歯車アイコンをクリックし、[OpenSharing] を選択します。
または、右上隅の [ 共有] > [OpenSharing] をクリックします。
[ 自分で共有 ] タブで、ストリーミング テーブルを追加する共有を見つけて、その名前をクリックします。
[資産の管理] > [資産の編集] をクリックします。
[ アセットの編集] ページで、共有するストリーミング テーブルを検索または参照して選択します。
(省略可能) [エイリアス ] 列で、[
をクリックします。ストリーミング テーブル名を読みやすくするために、エイリアスまたは代替ストリーミング テーブル名を指定します。 エイリアスは、受信者に表示される名前であり、クエリ内で使用する必要があります。 エイリアスが指定されている場合、受信者は実際のストリーミング テーブル名を使用できません。
保存 をクリックします。
SQL
ノートブックまたは Databricks SQL クエリ エディターで次のコマンドを実行します。
ALTER SHARE <share_name> ADD TABLE <st_name> [COMMENT <comment>] [AS <shared_st_name>];
CLI
次の Databricks CLI コマンドを実行します。
databricks shares update <share-name> \
--json '{
“updates”: [
{
“action”: “ADD”,
“data_object”: {
“name”: “<st-full-name>",
“data_object_type”: “TABLE”,
“comment”: “<comment>”
}
}
]
}'
共有からストリーミング テーブルを削除する方法については、「共有の 更新」を参照してください。
管理されたIcebergテーブルをシェアに追加する
Apache Iceberg は、分析ワークロード用のオープン ソース テーブル形式です。 Azure Databricks では、管理 された Iceberg テーブル と呼ばれる Unity カタログに Iceberg テーブルを作成できます。
共有にマネージド Iceberg テーブルを追加する前に 、要件 を満たしていることを確認します。 Iceberg テーブルとマネージド Iceberg テーブルの制限が適用されます。 制限事項を参照してください。
管理された Iceberg テーブルを共有に追加するには:
カタログ エクスプローラー
Azure Databricks ワークスペースで、
Catalog をクリックします。
[カタログ] ウィンドウの上部にある
をクリックします。歯車アイコンをクリックし、[OpenSharing] を選択します。
または、右上隅の [ 共有] > [OpenSharing] をクリックします。
[ 自分で共有 ] タブで、管理された Iceberg テーブルを追加する共有を見つけて、その名前をクリックします。
[アセットの管理]>[アセットの編集]をクリックします。
[ アセットの編集] ページで、共有する管理された Iceberg テーブルを検索または参照して選択します。
(省略可能)[ エイリアス ] 列で、[
をクリックします。エイリアスまたは代替のマネージド Iceberg テーブル名を指定して、名前を読みやすくします。 エイリアスは、受信者に表示される名前であり、クエリ内で使用する必要があります。 エイリアスが指定されている場合、受信者は実際に管理されている Iceberg テーブル名を使用できません。
保存 をクリックします。
SQL
ノートブックまたは Databricks SQL クエリ エディターで次のコマンドを実行します。 必要に応じて、別の名前でマネージド Iceberg テーブルを公開する <shared_iceberg_table_name> を指定します。
ALTER SHARE <share_name> ADD TABLE <managed_iceberg_name> [COMMENT <comment>] [AS <shared_iceberg_table_name>];
CLI
次の Databricks CLI コマンドを実行します。
databricks shares update <share-name> \
--json '{
“updates”: [
{
“action”: “ADD”,
“data_object”: {
“name”: “<managed-iceberg-full-name>",
“data_object_type”: “TABLE”,
“comment”: “<comment>”
}
}
]
}'
共有に外部スキーマやテーブルを追加する
Lakehouse Federationは、Azure Databricksを使ってPostgreSQLやMySQLなどの外部データソースに対するクエリを実行できるようにします。 外国テーブルのデータとメタデータはソースシステムに残ります。 Azure Databricksはクエリフェデレーションを通じてデータをクエリし、Unity Catalogはデータガバナンスを追加します。 外部スキーマとは、これらのテーブルのスキーマのことです。 外部ソースへの接続の詳細については、「外部 データベースとカタログへの接続」を参照してください。
OpenSharing を使用すると、データをAzure Databricks、複雑なネットワーク設定、資格情報の転送にコピーすることなく、元の場所から外部データを安全に共有できます。
注
これは、OneLakeやHiveメタストアなどの外国カタログに登録されたデルタ形式のテーブルを共有する外国の デルタテーブル 共有とは異なります。
外部スキーマまたはテーブルを共有に追加する前に 、要件 を満たしていることを確認します。
その他の要件
外部スキーマまたは外部テーブル共有が設定されているアカウントで 、ワークフロー、ノートブック、および Lakeflow パイプラインに対してサーバーレス コンピューティング を有効にする必要があります。 「サーバーレス コンピューティングに接続する」を参照してください。
外部スキーマとテーブルを共有する場合、データはクエリされ、プロバイダー側で一時的に具体化されます。 既定では、具体化されたデータは、Azure Databricks 既定のストレージを使用して非表示のスキーマに格納されます。 要件を満たしていることを確認し、既定のストレージの制限を確認します。
既定のストレージリージョンの可用性の詳細については、 サーバーレスの可用性に関するページを参照してください。
Azure Databricks の既定のストレージの使用をオプトアウトし、一時的な具体化に独自のストレージを使用するには、 サポート ケースを開きます。
Important
大きすぎて具体化できない外部テーブルは共有できません。 具体化が制限を超えると、クエリは失敗します。
制限事項
- 共有外部テーブルでは、
LIMIT句または述語プッシュダウンはサポートされていません。 システムは、クエリ フィルターに関係なく、受信者に返す前にすべてのクエリ結果を完全に具体化します。
推奨される使用パターン
クエリの結果はクエリごとにオンデマンドで生成されるため、外部テーブルとスキーマの共有は、テーブルの共有や具体化されたビューと比べてコスト効率が悪い場合があります。 Azure Databricks では、パフォーマンスを向上させるために次のことをお勧めします。
- 一般的なクエリ結果のサイズは 10 GB 未満にしてください。
- 頻繁なデータ ダンプではなく、アドホック探索クエリを使用します。
- クラウド トークン共有を使用する場合は、コスト効率とパフォーマンスを向上させるために、外部テーブルの上に作成された具体化されたビューを共有することを検討してください。
外部スキーマまたはテーブルを受信者と共有する
外部スキーマまたはテーブルを共有に追加するには、Azure Databricks ノートブックまたは Databricks SQL クエリ エディターで、カタログ エクスプローラー、Databricks Unity カタログ CLI、または SQL コマンドを使用します。
カタログ エクスプローラー
Azure Databricks ワークスペースで、
Catalog をクリックします。
[カタログ] ウィンドウの上部にある
をクリックします。歯車アイコンをクリックし、[OpenSharing] を選択します。
または、右上隅の [ 共有] > [OpenSharing] をクリックします。
[ 自分で共有 ] タブで、外部テーブルまたはスキーマを追加する共有を見つけて、その名前をクリックします。
[資産の管理] > [資産の編集] をクリックします。
[ アセットの編集] ページで、共有する外部テーブルまたはスキーマを検索または参照して選択します。
(省略可能) [エイリアス ] 列で、[
] をクリックします。外部スキーマまたはテーブル名を読みやすくするために、別名または代替外部スキーマまたはテーブル名を指定します。 エイリアスは、受信者に表示される名前であり、クエリ内で使用する必要があります。 エイリアスが指定されている場合、受信者は実際の外部スキーマまたはテーブル名を使用できません。
保存 をクリックします。
SQL
ALTER SHARE <share-name>
ADD {TABLE | SCHEMA} {federated_catalog.federated_schema.federated_table | federated_catalog.federated_schema}
[COMMENT "<comment>"]
[AS <alias>];
オプションは次のとおりです。
-
AS <alias>: データ資産名をより読みやすくするための別名、つまりエイリアスです。 エイリアスは、受信者が表示するデータ資産名であり、クエリで使用する必要があります。 エイリアスが指定されている場合、受信者は実際の名前を使用できません。 「<catalog-name>.<schema-name>.<view-name>」の形式を使用します。 -
COMMENT "<comment>": コメントはカタログエクスプローラーのUIに表示され、SQL文を使ってデータ資産の詳細を一覧表示または表示したときにも表示されます。
ALTER SHARE オプションの詳細については、「ALTER SHARE」を参照してください。
CLI
databricks shares update <share-name> \
--json '{
“updates”: [
{
“action”: “ADD”,
“data_object”: {
“name”: “<federated-data-asset-full-name>",
“data_object_type”: “{TABLE | SCHEMA}”,
"shared_as": "<foreign-data-asset-alias>",
“comment”: “<comment>”
}
}
]
}'
外国アイスバーグテーブルをシェアに追加する
Foreign Iceberg テーブルは、Lakehouse Federation を使用して外部の Iceberg カタログからフェデレーションされたテーブルです。 Azure Databricks の Apache Iceberg テーブルの詳細については、「Azure Databricks の Apache Iceberg とは」を参照してください。
開始する前に、一般的な 要件 を満たしていることを確認し、 共有を作成します。 外部 Iceberg クライアントを使用して、外部の Iceberg テーブルを受信者と共有することもできます。 詳細については、「 外部 Iceberg クライアントへの共有を有効にする」を参照してください。
注
受信者が最新のデータを受信することを確認するには、外部の Iceberg テーブルを定期的に更新します。
SELECTクエリまたはREFRESH TABLE コマンドを実行すると、テーブルメタデータが更新されます。
Databricks では、Azure Databricksの外部 Iceberg テーブルがリモート Iceberg ソースと同期し続けることができるように、スケジュールされたジョブを設定することをお勧めします。 更新のスケジュール設定の詳細については、「クエリの スケジュール設定」を参照してください。
追加要件
- Iceberg クライアントを使用していない開いている受信者と外部の Iceberg テーブルを共有する場合は、 既定のストレージを使用する必要があります。 アカウントレベルでOpenSharingのデフォルトストレージ – 拡張アクセス機能を有効にする必要があります。 Manage Azure Databricks プレビューを参照してください。
- Iceberg クライアントを使用していない開いている受信者と共有する場合、共有データは最初にフィルター処理され、コンピューティングとストレージを使用して具体化されます。 追加コストが発生する場合があります。 詳細については、「 OpenSharing コストを発生させ、確認する方法 」を参照してください。 受信者は、共有ビュー、具体化されたビュー、ストリーミング テーブルの基になるデータに直接アクセスできますか?
- 外国のIcebergテーブルはIceberg読み取りを有効にしなければなりません。 Icebergの読み取りが有効でない場合、そのテーブルはシェアに追加できません。
Iceberg クライアントでの Delta Lake テーブルの読み取りを参照してください。
制限事項
- パーティションはサポートされていません。
- Iceberg クライアントを使用していない開いている受信者と共有する場合、
LIMIT句と述語のプッシュダウンはサポートされません。 システムは、クエリ フィルターに関係なく、受信者に返す前にすべてのクエリ結果を完全に具体化します。
シェアに外国Icebergテーブルを追加する
Foreign Iceberg テーブルは、完全な履歴を含めて自動的に共有されます。
外部 Iceberg テーブルを共有に追加するには:
カタログ エクスプローラー
Azure Databricks ワークスペースで、
Catalog をクリックします。
[カタログ] ウィンドウの上部にある
をクリックします。歯車アイコンをクリックし、[OpenSharing] を選択します。
または、右上隅の [ 共有] > [OpenSharing] をクリックします。
[ 自分で共有 ] タブで、外部 Iceberg テーブルを追加する共有を見つけて、その名前をクリックします。
[アセットの管理]>[アセットの編集]をクリックします。
[ アセットの編集] ページで、共有する外部 Iceberg テーブルを検索または参照して選択します。
(省略可能)[ エイリアス ] 列で、[
] をクリックして、エイリアスを指定します。 エイリアスは、受信者に表示される名前であり、クエリ内で使用する必要があります。
保存 をクリックします。
SQL
ノートブックまたは Databricks SQL クエリ エディターで次のコマンドを実行します。 必要に応じて、外部 Iceberg テーブルを別の名前で公開する <shared_table_name> を指定します。
ALTER SHARE <share_name> ADD TABLE <foreign_iceberg_table_name> [COMMENT <comment>] [AS <shared_table_name>];
CLI
次の Databricks CLI コマンドを実行します。
databricks shares update <share-name> \
--json '{
"updates": [
{
"action": "ADD",
"data_object": {
"name": "<foreign-iceberg-table-full-name>",
"data_object_type": "TABLE",
"comment": "<comment>"
}
}
]
}'
共有に外部デルタテーブルを追加する
外国デルタテーブルとは、Azure Databricksがソースストレージからカタログフェデレーションを通じて直接読み取るデルタレイク形式の外国テーブルのことです。例えば、OneLakeのデルタテーブル、ハイブメタストア、AWS Glueなどです。 詳しくは「 外国テーブルの作業 」および 「カタログフェデレーションとは何か?」をご覧ください。
Azure Databricksの受信者の場合、外部のDeltaテーブルは常に完全な履歴付きでパーティションフィルターなしで共有されるため、受信者はクラウドトークンを使って直接送信元のDeltaファイルを読み取ることができます。 DatabricksからOpenへの共有受信者にとっては、データはあなたの側で具体化され、事前署名されたURLを通じて配信されます。
注
これは、PostgreSQLやMySQLなどのソースからクエリフェデレーションテーブルを共有する 外国テーブル 共有とは異なります。
開始する前に、一般的な 要件 を満たしていることを確認し、 共有を作成します。
シェアに外部 Delta テーブルを追加する
シェアに外国デルタテーブルを追加するには:
カタログ エクスプローラー
Azure Databricks ワークスペースで、
Catalog をクリックします。
[カタログ] ウィンドウの上部にある
をクリックします。歯車アイコンをクリックし、[OpenSharing] を選択します。
または、右上隅の [ 共有] > [OpenSharing] をクリックします。
「 Shared by me 」タブで、外国デルタテーブルを追加したいシェアを見つけて、その名前をクリックします。
[アセットの管理]>[アセットの編集]をクリックします。
「 資産編集 」ページで、共有したい外国デルタテーブルを検索して選択してください。
(省略可能)[ エイリアス ] 列で、[
] をクリックして、エイリアスを指定します。 エイリアスは、受信者に表示される名前であり、クエリ内で使用する必要があります。
保存 をクリックします。
SQL
ノートブックまたは Databricks SQL クエリ エディターで次のコマンドを実行します。 オプションとして、 <shared_table_name> を指定して、異なる名前で外部のDeltaテーブルを公開することもできます。
ALTER SHARE <share_name> ADD TABLE <foreign_delta_table_name> [COMMENT <comment>] [AS <shared_table_name>];
CLI
次の Databricks CLI コマンドを実行します。
databricks shares update <share-name> \
--json '{
"updates": [
{
"action": "ADD",
"data_object": {
"name": "<foreign-delta-table-full-name>",
"data_object_type": "TABLE",
"comment": "<comment>"
}
}
]
}'
共有にビューを追加
ビューは、1 つ以上のテーブルまたは他のビューから作成される読み取り専用オブジェクトです。 ビューは、Unity Catalog メタストア内の複数のスキーマとカタログに含まれるテーブルおよび他のビューから作成できます。 「ビューの作成と管理」を参照してください。
ビューの共有時に、データは照会され、仮想的に形成されます。 具体化されたデータは、ビューの親スキーマまたはカタログの格納場所、またはメタストア ルートの場所に格納されます。
共有にビューを追加する前に 、要件 を満たしていることを確認します。
その他の要件
- 共有可能なビューは、デルタテーブル、外国テーブル、その他の共有可能なビュー、またはローカルのマテリアル化されたビューやストリーミングテーブルで定義されなければなりません。
- ビューを共有に追加するときは、Databricks Runtime 13.3 LTS 以降で SQL ウェアハウスまたはコンピューティングを使用する必要があります。
- ワークスペースでワークスペース カタログ バインドが有効になっている場合は、ワークスペースにカタログへの読み取りと書き込みアクセス権があることを確認します。 詳細については、「 ワークスペース カタログ のバインド」を参照してください。
- ビューを共有する場合、受信者のコンピューティングの種類とアカウントの関係に応じて、データがクエリされ、プロバイダー側で一時的に具体化される場合があります。 具体化されたデータは、ビューの親スキーマまたはカタログの格納場所、またはメタストア ルートの場所に格納されます。 具体化がいつ発生し、誰が支払うのかについて詳しくは、「 受信者は共有ビュー、具体化されたビュー、ストリーミング テーブルの基になるデータに直接アクセスできますか」 および 「OpenSharing コストを発生させ、確認する方法」を参照してください。
- ストレージの場所にファイアウォールやプライベート リンクなどのカスタム ネットワーク構成がある場合は、受信者がストレージの場所に接続できるように許可リストに登録されていることを確認する必要があります。 サーバーレス コンピューティングのファイアウォール規則を構成する手順については、「サーバー レス コンピューティング アクセス用のファイアウォールを構成する」を参照してください。
- または、SecureConnect を使用して ファイアウォールの背後にあるデータを共有 し、受信者ごとの許可リストを使用せずにブローカー アクセスを行います。
制限事項
- 共有テーブルまたは共有ビューを参照するビューを共有することはできません。
- 受信者が基になるデータに直接アクセスできない場合、
LIMIT句と述語のプッシュダウンはサポートされません。 システムは、クエリ フィルターに関係なく、受信者に返す前にすべてのクエリ結果を完全に具体化します。 「 受信者が共有ビュー、具体化されたビュー、およびストリーミング テーブルの基になるデータに直接アクセスできるか」を参照してください。
受信者とビューを共有する
このセクションでは、Azure Databricks ノートブックまたは Databricks SQL クエリ エディターで、カタログ エクスプローラー、Databricks CLI、または SQL コマンドを使用して共有にビューを追加する方法について説明します。 Unity Catalog REST API を使用する場合は、REST API リファレンスの「PATCH /api/2.1/unity-catalog/shares/」を参照してください。
カタログ エクスプローラー
Azure Databricks ワークスペースで、
Catalog をクリックします。
[カタログ] ウィンドウの上部にある
をクリックします。歯車アイコンをクリックし、[OpenSharing] を選択します。
または、右上隅の [ 共有] > [OpenSharing] をクリックします。
[自分と共有] タブで、ビューの追加先となる共有を見つけてその名前をクリックします。
[資産の管理] > [データ資産の追加] をクリックします。
[テーブルの追加] ページで、共有するビューを検索または参照して選択します。
(省略可能) ビュー名を読みやすくするために、
Speech bubble plus icon.[エイリアス] 列で をクリックして代替ビュー名 (エイリアス) を指定します。 エイリアスは、受信者に表示される名前であり、クエリ内で使用する必要があります。 エイリアスが指定されている場合、受信者は実際のビュー名を使用できません。
保存 をクリックします。
SQL
ノートブックまたは 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>": コメントは、Catalog Explorer UI と、SQL 文を使用してビューの詳細を一覧表示および表示する場合に表示されます。
ALTER SHARE オプションの詳細については、「ALTER SHARE」を参照してください。
CLI
次の Databricks コマンドを実行します。
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 ランタイムバージョン:
CURRENT_RECIPIENT関数は Databricks Runtime 14.2 以降でサポートされています。
制限事項
- ビュー共有のすべての制限が適用されます。
- プロバイダーが
CURRENT_RECIPIENT関数を使用するビューを共有する場合、共有コンテキストのため、プロバイダーはビューに直接クエリを実行できません。 このような動的ビューをテストするには、プロバイダーがビューを自らと共有し、受信者としてビューのクエリを実行する必要があります。 - プロバイダーは、動的ビューを参照するビューを作成できません。
受信者プロパティを設定する
これらの例では、共有するテーブルには country という名前の列があり、一致する country プロパティを持つ受信者のみが特定の行または列を表示できます。
受信者のプロパティは、Azure Databricks ノートブックまたは SQL クエリ エディターでカタログ エクスプローラーまたは SQL コマンドを使用して設定できます。
カタログ エクスプローラー
Azure Databricks ワークスペースで、
Catalog をクリックします。
[カタログ] ウィンドウの上部にある
をクリックします。歯車アイコンをクリックし、[OpenSharing] を選択します。
または、右上隅の [ 共有] > [OpenSharing] をクリックします。
[受信者] タブで、プロパティを追加する受信者を見つけて、その名前をクリックします。
ページの右下にある「受信者のプロパティ」で、Azure Databricks 受信者については
Pencil icon.databricks.metastoreID の横にある を、または開いている受信者については databricks.name の横にある 鉛筆アイコン をクリックします。
[受信者プロパティの編集] ダイアログで、キーとして列名 (この場合は
country) を、値としてフィルター条件となる値 (CAなど) を入力します。保存 をクリックします。
SQL
受信者にプロパティを設定するには、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');
もう 1 つのオプションは、ファクト テーブル フィールドを受信者のプロパティにマップする個別のマッピング テーブルをデータ プロバイダーが維持することです。 これにより、受信者のプロパティとファクト テーブルのフィールドを分離して、柔軟性を高められます。
受信者に対して列レベルのアクセス許可を設定した動的ビューを作成する
この例では、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;
動的ビューを受信者と共有する
動的ビューを受信者と共有するには、標準ビューの場合と同じ SQL コマンドまたは UI の手順を使用します。 「 共有にビューを追加する」を参照してください。
共有にマテリアライズドビューを追加
ビューと同様に、具体化されたビューはクエリの結果であり、テーブルのようにアクセスできます。 通常のビューとは異なり、具体化されたビューの結果には、具体化されたビューが最後に更新されたときのデータの状態が反映されます。 具体化されたビューの詳細については、「スタンドアロンの 具体化されたビューを使用する」を参照してください。
具体化されたビューを共有に追加する前に 、要件 を満たしていることを確認します。
その他の要件
- ワークスペースでワークスペース カタログ バインドが有効になっている場合は、具体化されたビューを含むカタログへの読み取りと書き込みアクセス権がワークスペースにあることを確認します。 詳細については、「 ワークスペース カタログ のバインド」を参照してください。
- 共有可能な具体化されたビューは、差分テーブルまたは他の共有可能なストリーミング テーブル、ビュー、または具体化されたビューで定義する必要があります。
- マテリアライズド ビューを共有に追加するときは、Databricks Runtime 13.3 LTS 以降で SQL ウェアハウスまたはコンピューティングを使用する必要があります。
制限事項
- 具体化されたビューには行フィルターを設定できませんが、具体化されたビューのベース テーブルには行フィルターと列マスクを含めることができます。
- 具体化されたビューにパーティション フィルターを設定することはできません。 代わりに、具体化されたビューの上にビューを作成します。
- Databricks から Open Sharing への共有の受信者は、マテリアライズドビューの現在のスナップショットのみを参照できます。 開いている受信者のストリーミング読み取りはサポートされていません。
- 受信者が基になるデータに直接アクセスできない場合、
LIMIT句と述語のプッシュダウンはサポートされません。 システムは、クエリ フィルターに関係なく、受信者に返す前にすべてのクエリ結果を完全に具体化します。 「 受信者が共有ビュー、具体化されたビュー、およびストリーミング テーブルの基になるデータに直接アクセスできるか」を参照してください。 - 具体化されたビューの一般的な制限も適用されます。 具体化されたビューの制限事項を参照してください。
具体化されたビューを受信者と共有する
このセクションでは、Azure Databricks ノートブックまたは Databricks SQL クエリ エディターで、カタログ エクスプローラー、Databricks CLI、または SQL コマンドを使用して、具体化されたビューを共有に追加する方法について説明します。 REST API を使用する場合は、REST API リファレンスの PATCH /api/2.1/unity-catalog/shares/ を参照してください。
カタログ エクスプローラー
Azure Databricks ワークスペースで、
Catalog をクリックします。
[カタログ] ウィンドウの上部にある
をクリックします。歯車アイコンをクリックし、[OpenSharing] を選択します。
または、右上隅の [ 共有] > [OpenSharing] をクリックします。
私が共有した タブで、具体化ビューを追加したい共有を見つけて、その名前をクリックします。
[資産の管理] > [資産の編集] をクリックします。
[ アセットの編集] ページで、共有する具体化されたビューを検索または参照して選択します。
(省略可能)[ エイリアス ] 列で、[
] をクリックして、マテリアライズドビュー名を読みやすくするために、エイリアスまたは代替のマテリアライズドビュー名を指定します。 エイリアスは、受信者に表示される名前であり、クエリ内で使用する必要があります。 エイリアスが指定されている場合、受信者は実際の具体化されたビュー名を使用できません。
保存 をクリックします。
SQL
ノートブックまたは Databricks SQL クエリ エディターで次のコマンドを実行します。
ALTER SHARE <share_name> ADD MATERIALIZED VIEW <mv_name> [COMMENT <comment>] [AS <shared_mv_name>];
CLI
databricks shares update <share-name> \
--json '{
“updates”: [
{
“action”: “ADD”,
“data_object”: {
“name”: “<mat-view-full-name>”,
“data_object_type”: “MATERIALIZED_VIEW”,
“comment”: “<comment>”
}
}
]
}'
共有から具体化されたビューを削除する方法については、「 共有の更新」を参照してください。
シェアにメトリックビューを追加
メトリックビューは、メトリクスをグループ化、フィルタリング、集約に用いる次元から分離してビジネスメトリクスを一度定義します。 メトリックビューの詳細については、 Unity Catalogのメトリックビューをご覧ください。
共有にメトリックビューを追加する前に 、要件 を満たしているか確認してください。
制限事項
- メトリックビューはAzure Databricksの受信者としか共有できません。
- メトリックビューの定義は、共有ビューでサポートされるAzure Databricksの組み込み関数や演算子の一部しか使用できません。 Databricks から Databricks へのビュー共有でサポートされている関数を参照してください。
- 行フィルターやカラムマスクでテーブルを参照するメトリックビューを共有することはできません。
- ABACポリシーで管理されるテーブルを参照するメトリックビューを共有することはできません。
-
カタログコミットが有効になっているテーブルを参照するメトリックビューを共有することはできません。 メトリックビューを共有するには、ソーステーブルから
catalogManagedテーブル機能を外してください。 Delta Lake テーブル機能の削除とテーブル プロトコルのダウングレードに関する記事を参照してください。
行フィルター、カラムマスク、ABACポリシーを持つテーブルを参照するメトリックビューが共有されている場合、受信者はそれを問い合わせることができません。
メトリクスビューを受信者と共有する
このセクションでは、カタログエクスプローラー、Databricks CLI、またはAzure DatabricksノートブックやDatabricks SQLクエリエディターのSQLコマンドを使って、共有にメトリックビューを追加する方法について説明します。 Unity Catalog REST API を使用する場合は、REST API リファレンスの「PATCH /api/2.1/unity-catalog/shares/」を参照してください。
SQL、Databricks CLI、Pythonでは、メトリックビューはVIEWデータ型を使用します。
カタログ エクスプローラー
Azure Databricks ワークスペースで、
Catalog をクリックします。
カタログペインの上部で、
をクリックしてください。歯車アイコンからOpenSharingを選択してください。
または、右上隅の [ 共有] > [OpenSharing] をクリックします。
「Shared by me」タブで、メトリックビューを追加したいシェアを見つけて名前をクリックします。
[資産の管理] > [データ資産の追加] をクリックします。
「 Add tables」 ページで、共有したいメトリックビューを検索して選択してください。
(省略可能) ビュー名を読みやすくするために、[エイリアス] 列で
をクリックして代替名 (エイリアス) を指定します。 エイリアスは、受信者に表示される名前であり、クエリ内で使用する必要があります。 別名が指定されている場合、受信者は実際のメトリクスビュー名を使用できません。
保存 をクリックします。
SQL
メトリックビューは VIEW データ型を使用するため、ノートブックまたはDatabricksのSQLクエリエディタで以下のコマンドを実行します。
ALTER SHARE <share-name> ADD VIEW <catalog-name>.<schema-name>.<metric-view-name>
[COMMENT "<comment>"]
[AS <alias>];
オプションは次のとおりです。
-
AS <alias>: メトリックビュー名をより読みやすくするための別の名前、つまりエイリアス。 エイリアスは、受信者に表示される名前であり、クエリ内で使用する必要があります。 別名が指定されている場合、受信者は実際のメトリクスビュー名を使用できません。 「<schema-name>.<metric-view-name>」の形式を使用します。 -
COMMENT "<comment>": コメントは、カタログ エクスプローラー UI と、SQL ステートメントを使用してメトリクス ビューの詳細を一覧表示および表示する場合に表示されます。
ALTER SHARE オプションの詳細については、「ALTER SHARE」を参照してください。
CLI
メトリックビューは VIEW データ型を使用するため、以下のDatabricks CLIコマンドを実行してください:
databricks shares update <share-name> \
--json '{
"updates": [
{
"action": "ADD",
"data_object": {
"name": "<metric-view-full-name>",
"data_object_type": "VIEW",
"shared_as": "<metric-view-alias>"
}
}
]
}'
"shared_as": "<metric-view-alias>" はオプションであり、メトリックビュー名をより読みやすくするために別名(エイリアス)を提供します。 エイリアスは、受信者に表示される名前であり、クエリ内で使用する必要があります。 別名が指定されている場合、受信者は実際のメトリクスビュー名を使用できません。 「<schema-name>.<metric-view-name>」の形式を使用します。
追加のパラメータの詳細については、databricks shares update --help を実行するか、REST API リファレンスのPATCH /api/2.1/unity-catalog/shares/ を参照してください。
共有からメトリックビューを削除する方法については、「 シェアの更新」をご覧ください。
シェアにボリュームを追加する
ボリュームは、クラウド オブジェクトの保存場所にあるストレージの論理ボリュームを表す Unity Catalog オブジェクトです。 これらは主に、表形式以外のデータ資産に対するガバナンスを提供することを目的としています。 「Unity カタログ ボリュームとは」を参照してください。
共有にボリュームを追加する前に 、要件 を満たしていることを確認します。
その他の要件
- ボリュームの共有は、Databricks 間共有でのみサポートされます。
- 共有にボリュームを追加するときは、バージョン 2023.50 以降の SQL ウェアハウスまたは Databricks Runtime 14.1 以降のコンピューティング リソースを使用する必要があります。
- プロバイダー側のボリューム ストレージにカスタム ネットワーク構成 (ファイアウォールやプライベート リンクなど) がある場合、プロバイダーは、受信者のデータ プレーン アドレスがボリュームのストレージの場所に接続できるように適切に許可リストされていることを確認する必要があります。 カタログ エクスプローラーで、受信者側でボリュームが正しく表示されない場合があります。
注
2024 年 7 月 25 日以降に Databricks 間の共有を使用して受信者と共有される共有にはボリューム コメントが含まれています。 リリース日より前に受信者と共有した共有を通じてコメント共有を開始する場合は、受信者のアクセスを取り消し、もう一度付与して、コメント共有をトリガーする必要があります。
受信者とボリュームを共有する
このセクションでは、Azure Databricks ノートブックまたは SQL クエリ エディターでカタログ エクスプローラー、Databricks CLI、または SQL コマンドを使用して、共有にボリュームを追加する方法について説明します。 Unity Catalog REST API を使用する場合は、REST API リファレンスの「PATCH /api/2.1/unity-catalog/shares/」を参照してください。
カタログ エクスプローラー
Azure Databricks ワークスペースで、
Catalog をクリックします。
[カタログ] ウィンドウの上部にある
をクリックします。歯車アイコンをクリックし、[OpenSharing] を選択します。
または、右上隅の [ 共有] > [OpenSharing] をクリックします。
[自分と共有] タブで、ボリュームの追加先となる共有を見つけてその名前をクリックします。
[資産の管理] > [資産の編集] をクリックします。
[資産の編集] ページで、共有するボリュームを検索または参照して選択します。
または、ボリュームを含むスキーマ全体を選択することもできます。 「共有にスキーマを追加する」を参照してください。
(省略可能)
をクリックします。「エイリアス」列の下で、代替のボリューム名、または エイリアス を指定して、ボリューム名をより読みやすくします。
スキーマ全体を選択した場合、エイリアスは使用できません。
エイリアスは、受信者に表示される名前であり、クエリ内で使用する必要があります。 エイリアスが指定されている場合、受信者は実際のボリューム名を使用できません。
保存 をクリックします。
SQL
ノートブックまたは 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」を参照してください。
CLI
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/ を参照してください。
共有からのボリュームの削除については、「共有を更新する」を参照してください。
エージェントスキルをシェアに追加
Important
この機能は ベータ版です。 アカウント管理者は、アカウント コンソール の [プレビュー ] ページからこの機能へのアクセスを管理できます。 アカウント レベルのプレビューの管理を参照してください。
Unity Catalogのエージェントスキルは、AIエージェントにあなたのデータやドメインの扱い方を教えるガバナード命令です。 作成方法を学びたい方は、「チュートリアル: Unity Gateway Skills の作成と共有」をご覧ください。
その他の要件
- アカウント管理者は、アカウントコンソールのPreviewsページから、Agent Skill SharingおよびEnhanced Unity AI Gatewayのアカウントレベルのプレビューを有効にしなければなりません。 アカウント レベルのプレビューの管理を参照してください。
- 共有できるのは、管理対象カタログ内の最終確定済みのスキルのみです。
- ネストされたスキーマのスキルはシェアに追加できません。
- エージェントスキルはAzure Databricksの受取人とのみ共有可能です。 OpenSharing Databricks-to-Databricks プロトコルとは何かを参照してください。
注
ワークスペースが コンプライアンスセキュリティプロファイルを使用している場合、他の地域の受信者とエージェントスキルを共有することで、コンプライアンスおよびデータレジデンシー要件を満たすよう責任を負います。 スキルは自分のメタストアから直接受け取る側のメタストアに共有され、誰に共有するかは自分で選べます。
エージェントスキルをシェアに追加する前に 、要件 を満たしているか確認してください。
受取人とエージェント スキルを共有しましょう
Catalog ExplorerやDatabricks CLIを使って、エージェントのスキルをシェアに追加できます。
エージェントスキルをシェアに追加するには:
カタログ エクスプローラー
Azure Databricks ワークスペースで、
Catalog をクリックします。
[カタログ] ウィンドウの上部にある
をクリックします。歯車アイコンをクリックし、[OpenSharing] を選択します。
または、右上隅の [ 共有] > [OpenSharing] をクリックします。
「Shared by me」タブで、エージェントスキルを追加したいシェアを見つけて名前をクリックします。
[資産の管理] > [資産の編集] をクリックします。
「 Edit assets 」ページで、共有したいエージェントスキルを検索して選択してください。
あるいは、エージェントスキルを含むスキーマ全体を選択することもできます。 シェアにスキーマを追加すると、そのスキーマ内のエージェントスキルも共有されます。 「共有にスキーマを追加する」を参照してください。
保存 をクリックします。
あるいは、エージェントのスキルを詳細ページから直接共有することもできます。 カタログエクスプローラーで、スキルを含むスキーマに移動し、スキル名をクリックします。 スキル詳細ページで 「シェア」をクリックします。 ネストされたスキーマではスキルの 共有 ボタンは表示されません。
CLI
Databricks CLI 0.210 以降を使用して次のコマンドを実行します。
databricks shares update <share-name> \
--json '{
"updates": [
{
"action": "ADD",
"data_object": {
"name": "<skill-full-name>",
"data_object_type": "SKILL",
"string_shared_as": "<schema-name>.<skill-name>",
"comment": "<comment>"
}
}
]
}'
"string_shared_as": "<schema-name>.<skill-name>" はオプションであり、受け手がスキルの元の名前の代わりに見る別名を提供します。 別名を指定しなければ、元の名前から別名が生成されます。 エイリアスはシェア内で一意でなければなりません。
"comment" はオプションです。
パーティション、履歴、変更データフィードなどのテーブル専用オプションはエージェントスキルには適用されません。
追加のパラメータの詳細については、databricks shares update --help を実行するか、REST API リファレンスのPATCH /api/2.1/unity-catalog/shares/ を参照してください。
共有からエージェントスキルを削除する方法については、「 共有の更新」をご覧ください。
制限事項
OpenSharingの制限に加え、エージェント スキルの共有には以下の制限があります。
- エージェントスキルはAzure Databricksの受信者とのみ共有可能です。 Open recipients は共有エージェントのスキルにアクセスできません。
- 共有エージェントスキルは受信者にとって読み取り専用です。 受信者はそれらを編集したり、ファイルをアップロードしたり、削除したりすることはできません。 スキル名、コメント、内容は提供者から提供されています。
- クリーンルームにエージェントスキルを追加することはできません。
- エージェントスキルはSQLコマンドでは共有できません。 カタログエクスプローラーまたはDatabricksのCLIをご利用ください。
Databricksマーケットプレイスのリスティングでエージェントのスキルを共有するには、「 マーケットプレイスリスティングを作成する」をご覧ください。
共有にPython UDFを追加する
ユーザー定義関数 (UDF) を使用すると、Azure Databricks の組み込み機能を拡張するコードを再利用して共有できます。 Python UDF を作成する方法については、スカラー ユーザー定義関数 (UDF) Python参照してください。
共有にPYTHON UDF を追加する前に、requirements を満たしていることを確認します。
その他の制限事項
- 開いている受信者と Python UDF を共有することはできません。
受信者と Python UDF を共有する
このセクションでは、Azure Databricks ノートブックまたは SQL クエリ エディターで、カタログ エクスプローラー、Databricks CLI、または SQL コマンドを使用して、共有に Python UDF を追加する方法について説明します。 Unity Catalog REST API を使用する場合は、REST API リファレンスの「PATCH /api/2.1/unity-catalog/shares/」を参照してください。
カタログ エクスプローラー
Azure Databricks ワークスペースで、
Catalog をクリックします。
[カタログ] ウィンドウの上部にある
をクリックします。歯車アイコンをクリックし、[OpenSharing] を選択します。
または、右上隅の [ 共有] > [OpenSharing] をクリックします。
[ 自分で共有 ] タブで、Python UDF を追加する共有を見つけて、その名前をクリックします。
[資産の管理] > [資産の編集] をクリックします。
Edit assets ページで、共有するPython UDF を検索または参照して選択します。
または、Python UDF を含むスキーマ全体を選択することもできます。 「共有にスキーマを追加する」を参照してください。
(省略可能)
をクリックして、Alias 列の下に代替のPython UDF名、つまり、より読みやすい名前を指定します。
スキーマ全体を選択した場合、エイリアスは使用できません。
エイリアスは、受信者に表示される名前であり、クエリ内で使用する必要があります。 エイリアスが指定されている場合、受信者は実際の Python UDF 名を使用できません。
保存 をクリックします。
SQL
ノートブックまたは Databricks SQL クエリ エディターで、 ADD MODELを使用する次のコマンドを実行します。
ALTER SHARE <share-name> ADD MODEL <catalog-name>.<schema-name>.<python-udf-name>
[AS <alias>];
オプションは次のとおりです。
-
AS <alias>:Python UDF名をより読みやすくするための代替Python UDF名、または別名。 エイリアスは、受信者に表示されるPython UDF 名であり、クエリで使用する必要があります。 エイリアスが指定されている場合、受信者は実際の Python UDF 名を使用できません。 「<schema-name>.<python-udf-name>」の形式を使用します。
ALTER SHARE オプションの詳細については、「ALTER SHARE」を参照してください。
CLI
Databricks CLI 0.210 以降を使用して、オブジェクトの種類をモデルとして指定する次のコマンドを実行します。
databricks shares update <share-name> \
--json '{
"updates": [
{
"action": "ADD",
"data_object": {
"name": "<python-udf-full-name>",
"data_object_type": "MODEL",
"string_shared_as": "<python-udf-alias>"
}
}
]
}'
"string_shared_as": "<python-udf-alias>"はオプションであり、Python UDF名をより読みやすくするための代替Python UDF名または別名を提供します。 エイリアスは、受信者に表示されるPython UDF 名であり、クエリで使用する必要があります。 エイリアスが指定されている場合、受信者は実際の Python UDF 名を使用できません。 「<schema-name>.<python-udf-name>」の形式を使用します。
追加のパラメータの詳細については、databricks shares update --help を実行するか、REST API リファレンスのPATCH /api/2.1/unity-catalog/shares/ を参照してください。
シェアに FeatureSpecs を追加します
FeatureSpec は、機能と関数のユーザー定義セットです。 受信者は、共有 FeatureSpecから機能サービス エンドポイントを作成できます。
FeatureSpecsを作成する方法については、「FeatureSpecの作成」を参照してください。
共有にを追加する前にFeatureSpecsを満たしていることを確認します。
その他の要件
- すべての依存関係を共有に追加する必要があります。 UI を使用して
FeatureSpecを共有に追加する場合、すべての依存関係が自動的に共有に追加されます。 - 依存関係をモデルに追加する場合は、共有にも追加する必要があります。
その他の制限事項
- この資産が別のモデルの依存関係である場合、エイリアスを指定することはできません。
- 開いている受信者と
FeatureSpecsを共有することはできません。
受信者と FeatureSpecs を共有する
このセクションでは、Azure Databricks ノートブックまたは SQL クエリ エディターで、カタログ エクスプローラー、Databricks CLI、または SQL コマンドを使用して共有に FeatureSpecs を追加する方法について説明します。 Unity Catalog REST API を使用する場合は、REST API リファレンスの「PATCH /api/2.1/unity-catalog/shares/」を参照してください。
カタログ エクスプローラー
Azure Databricks ワークスペースで、
Catalog をクリックします。
[カタログ] ウィンドウの上部にある
をクリックします。歯車アイコンをクリックし、[OpenSharing] を選択します。
または、右上隅の [ 共有] > [OpenSharing] をクリックします。
[ 自分で共有 ] タブで、
FeatureSpecを追加する共有を見つけて、その名前をクリックします。[資産の管理] > [資産の編集] をクリックします。
[ アセットの編集] ページで、共有する
FeatureSpecを検索または参照して選択します。または、
FeatureSpecを含むスキーマ全体を選択することもできます。 「共有にスキーマを追加する」を参照してください。(省略可能)
をクリックします。 別名 列の下に代替
FeatureSpec名、または エイリアス を指定すると、FeatureSpec名がより読みやすくなります。スキーマ全体を選択した場合、エイリアスは使用できません。
エイリアスは、受信者に表示される名前であり、クエリ内で使用する必要があります。 エイリアスが指定されている場合、受信者は実際の
FeatureSpec名を使用できません。依存関係がある場合は、[ すべての依存関係の追加] ダイアログで、それらがすべて自動的に追加されることを示します。 [ すべての依存関係の追加] をクリックします。
保存 をクリックします。
SQL
ノートブックまたは Databricks SQL クエリ エディターで、 ADD MODELを使用する次のコマンドを実行します。
ALTER SHARE <share-name> ADD MODEL <catalog-name>.<schema-name>.<featurespec-name>
[AS <alias>];
--オプションには次のものが含まれます。
-
AS <alias>:FeatureSpec名をより読みやすくするための別のFeatureSpec名、つまりエイリアス。 エイリアスは、受信者に表示されるFeatureSpec名であり、クエリで使用する必要があります。 エイリアスが指定されている場合、受信者は実際のFeatureSpec名を使用できません。 「<schema-name>.<featurespec-name>」の形式を使用します。
ALTER SHARE オプションの詳細については、「ALTER SHARE」を参照してください。
CLI
Databricks CLI 0.210 以降を使用して、オブジェクトの種類をモデルとして指定する次のコマンドを実行します。
databricks shares update <share-name> \
--json '{
"updates": [
{
"action": "ADD",
"data_object": {
"name": "<featurespec-full-name>",
"data_object_type": "MODEL",
"string_shared_as": "<featurespec-alias>"
}
}
]
}'
"string_shared_as": "<volume-alias>" はオプションであり、FeatureSpec名をより読みやすくするために代替のFeatureSpec名または別名を提供します。 エイリアスは、受信者に表示される FeatureSpec 名であり、クエリで使用する必要があります。 エイリアスが指定されている場合、受信者は実際の FeatureSpec 名を使用できません。 「<schema-name>.<featurespec-name>」の形式を使用します。
追加のパラメータの詳細については、databricks shares update --help を実行するか、REST API リファレンスのPATCH /api/2.1/unity-catalog/shares/ を参照してください。
シェアにモデルを追加
共有にモデルを追加する前に 、要件 を満たしていることを確認します。
注
Databricks 間の共有を使用して共有された共有にはモデル コメントとモデル バージョン コメントが含まれています。
その他の要件
- モデル共有は、Databricks 間の共有でのみサポートされます。
- モデルを共有に追加するときは、バージョン 2023.50 以降の SQL ウェアハウスまたは Databricks Runtime 14.0 以降のコンピューティング リソースを使用する必要があります。
受信者とモデルを共有する
このセクションでは、Azure Databricks ノートブックまたは SQL クエリ エディターでカタログ エクスプローラー、Databricks CLI、または SQL コマンドを使用して、モデルを共有に追加する方法について説明します。 Unity Catalog REST API を使用する場合は、REST API リファレンスの「PATCH /api/2.1/unity-catalog/shares/」を参照してください。
モデルを共有に追加するには、次の手順を実行します。
カタログ エクスプローラー
Azure Databricks ワークスペースで、
Catalog をクリックします。
[カタログ] ウィンドウの上部にある
をクリックします。歯車アイコンをクリックし、[OpenSharing] を選択します。
または、右上隅の [ 共有] > [OpenSharing] をクリックします。
[自分と共有] タブで、モデルの追加先となる共有を見つけてその名前をクリックします。
[資産の管理] > [資産の編集] をクリックします。
[資産の編集] ページで、共有するモデルを検索または参照して選択します。
または、モデルを含むスキーマ全体を選択することもできます。 「共有にスキーマを追加する」を参照してください。
(省略可能)
を別名の列の下でクリックして、代替モデル名、または別名を指定し、モデル名をより読みやすくしてください。
スキーマ全体を選択した場合、エイリアスは使用できません。
エイリアスは、受信者に表示される名前であり、クエリ内で使用する必要があります。 エイリアスが指定されている場合、受信者は実際のモデル名を使用できません。
保存 をクリックします。
SQL
ノートブックまたは 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」を参照してください。
CLI
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/ を参照してください。
共有からのモデルの削除については、「共有を更新する」を参照してください。
共有にノートブック ファイルを追加
ノートブック ファイルを共有に追加する前に 、要件 を満たしていることを確認します。
Catalog Explorer を使用してノートブック ファイルを共有に追加します。
- Azure Databricks ワークスペースで、
Catalog をクリックします。
- [ OpenSharing > ] ボタンをクリックします。
- [自分と共有] タブで、ノートブックの追加先となる共有を見つけてその名前をクリックします。
- [資産の管理] をクリックし、[ノートブック ファイルの追加] を選択します。
-
[ノートブック ファイルの追加] ページで、ファイル アイコンをクリックして、共有するノートブックを参照します。
- 共有するファイルをクリックし、[選択] をクリックします。
- (省略可能) [共有名] フィールドでファイルのわかりやすいエイリアスを指定します。 これは受信者に表示される識別子です。
- ストレージの場所で、ノートブックを格納するクラウド ストレージの 外部の場所 を入力します。 定義された外部の場所の下にサブパスを指定できます。 外部の場所を指定しない場合、ノートブックはメタストア レベルのストレージの場所 (または "メタストア ルートの場所") に格納されます。 メタストアにルートの場所が定義されていない場合は、ここに外部の場所を入力する必要があります。 「既存のメタストアにマネージド ストレージを追加する」を参照してください。
- 保存 をクリックします。
これで、共有されたノートブック ファイルが [資産] タブの [ノートブック ファイル] リストに表示されます。
共有からノートブック ファイルを削除する
共有からノートブック ファイルを削除するには、次の手順を実行します。
Azure Databricks ワークスペースで、
Catalog をクリックします。
[カタログ] ウィンドウの上部にある
をクリックします。歯車アイコンをクリックし、[OpenSharing] を選択します。
または、右上隅の [ 共有] > [OpenSharing] をクリックします。
[自分と共有] タブで、ノートブックを含む共有を見つけて、共有名をクリックします。
[資産] タブで、共有から削除するノートブック ファイルを見つけます。
をクリックします。行の右側にある kebab メニューをクリックし、[ノートブック ファイルの削除] を選択します。
確認のダイアログで [削除] をクリックします。
共有内のノートブック ファイルを更新する
既に共有しているノートブックを更新するには、ノートブックを再追加し、[共有名] フィールドで新しいエイリアスを付ける必要があります。 Databricks では、ノートブックの変更された状態 ( <old-name>-update-1など) を示す名前を使用することをお勧めします。 変更を受信者に通知する必要がある場合があります。 更新を利用するには、受信者は新しいノートブックを選択して複製する必要があります。
外部のIcebergクライアントへの共有を可能にする
Deltaテーブル、マネージドIcebergテーブル、外部Icebergテーブル、ビュー、マテリアル化されたビュー、ストリーミングテーブルをApache Iceberg REST Catalog APIを使用する外部クライアントと共有できます。
共有する前に、データ資産を共有に追加するために必要な OpenSharing 要件 を満たしていることを確認します。
注
この機能は、 マネージド Iceberg テーブルの共有とは異なります。
その他の制限事項
- 既定のストレージを使用する資産を外部の Iceberg クライアントと共有することはできません。 Databricks の既定のストレージを参照してください。
外部の Iceberg クライアントと共有する
外部 Iceberg クライアントとデータ資産を共有するには:
Delta テーブルを共有する場合は、
IcebergCompatV3を使用して各 Delta テーブルを構成し、Iceberg 互換テーブルとして公開します。 これにより、標準の Delta 操作と共に Iceberg メタデータを非同期で生成できます。 Iceberg v3の要件を満たし、制限事項を遵守しているか確認してください。 テーブル上でIceberg v3を有効にする方法については、「 Use Apache Iceberg v3 features」をご覧ください。Snowflake と共有している場合は、受信者に対して均一に有効なテーブルのみが表示されます。 その他のテーブルはフィルター処理されます。
注
DESCRIBE HISTORYを使用して、Iceberg クライアントからテーブルを照会する前に Iceberg メタデータの生成が完了したことを確認します。データ資産を共有に追加します。 詳細な手順については、以下を参照してください。
Important
ビュー、具体化されたビュー、またはストリーミング テーブルを共有すると、プロバイダー側のデータマテリアライズがトリガーされ、コンピューティング コストが蓄積される可能性があります。 詳細については、「 OpenSharing コストを発生させ、確認する方法」を参照してください。
開いている受信者と共有します。 受信者を作成して共有へのアクセス権を付与する方法については、「 ベアラー トークン (Databricks から開く共有) を使用して Databricks 以外のユーザーの受信者オブジェクトを作成する」 または OpenSharing 受信者の Open ID Connect (OIDC) フェデレーションを有効にする方法を参照してください。