Delta Sharing プロバイダーの管理 (データ受信者用)
この記事では、Unity Catalog を使用して、Delta Sharing を使用してデータを共有しているデータ プロバイダーに関する情報を取得する方法について説明します。 また、プロバイダー オブジェクトとは何か、 Unity Catalog メタストアにプロバイダー オブジェクトを作成する必要がある場合 (ほとんどの受信者が行う必要のないタスク) についても説明します。
データ受信者は、この記事で説明されている機能を使用するために 、Unity Catalog が有効になっている Databricks ワークスペースにアクセスできる必要があります。 この記事は、Unity Catalog 対応のワークスペースを持っていない受信者には適用されません。
受信者はプロバイダーオブジェクトを作成する必要がありますか?
Databricks の Delta Sharing では、"プロバイダー" という用語は、データを共有している組織と、その組織を表す受信者の Unity Catalog メタストア内のセキュリティ保護可能なオブジェクトの両方を意味する場合があります。受信者の Unity Catalog メタストアにそのセキュリティ保護可能なオブジェクトが存在すると、受信者は Unity Catalog を使用して共有データへのチームのアクセスを管理できます。
Unity Catalog メタストアへのアクセス権を持つ受信者は、通常、プロバイダー オブジェクトを作成する必要はありません。 これは、データはDatabricks-to-Databricks共有を使用して共有する必要があり、プロバイダー オブジェクトはUnity Catalogメタストアに自動的に作成されるためです。
Unity Catalog 対応の Databricks ワークスペースから共有されていないプロバイダーからデータを受信している場合は、カタログエクスプローラ を使用してプロバイダーの資格情報ファイルをインポートできます。「Databricks: オープン共有コネクタを使用して共有データを読み取る」を参照してください。
始める前に
Databricks ワークスペースでプロバイダーを管理するには:
- ワークスペースでUnity Catalogが有効になっている必要があります。
- プロバイダーを表示するには、メタストア管理者であるか、メタストア管理者から
USE PROVIDER
特権が付与されている必要があります。 - プロバイダーを作成するには、メタストア管理者であるか、メタストア管理者から
CREATE PROVIDER
特権が付与されている必要があります。 - プロバイダーを更新するには、プロバイダーオブジェクトの所有者であり、
CREATE PROVIDER
権限を持っている必要があります。 詳細については、「プロバイダーの更新 (名前の変更、所有者の変更、コメント)」を参照してください。
このため、ワークスペースがメタストア管理者なしで作成された場合、Databricks でプロバイダー オブジェクトを操作する前に、Databricks アカウント管理者がユーザーまたはグループにメタストア管理者ロールを付与する必要があります。 「Unity Catalog の自動有効化」および「(省略可能) メタストア管理者ロールの割り当て」を参照してください。
プロバイダーを見る
使用可能なデータ プロバイダーの一覧を表示するには、カタログエクスプローラ、Databricks Unity Catalog CLI、または Databricks ノートブックまたは Databricks SQL クエリ エディターの SHOW PROVIDERS
SQL コマンドを使用できます。
必要なアクセス許可 : メタストア管理者であるか、メタストア内のすべてのプロバイダーを表示するための USE PROVIDER
特権を持っている必要があります。 他のユーザーは、自分が所有するプロバイダーにのみアクセスできます。
- Catalog Explorer
- SQL
- CLI
-
Databricks ワークスペースで、
カタログ をクリックします。
-
[カタログ ] ウィンドウの上部にある [
] 歯車アイコンをクリックし、[ Delta Sharing ] を選択します。
または、[ クイック アクセス ] ページで [Delta Sharing > ] ボタンをクリックします。
-
[ 自分と共有] タブで、利用可能なすべてのプロバイダーを表示します。
ノートブックまたは Databricks SQL クエリ エディターで次のコマンドを実行します。必要に応じて、 <pattern>
を LIKE
述部に置き換えます。
SHOW PROVIDERS [LIKE <pattern>];
SHOW PROVIDERS
の詳細については、「SHOW PROVIDERS」を参照してください。
Databricks CLI を使用して次のコマンドを実行します。
databricks providers list
プロバイダーの詳細を表示
プロバイダーの詳細を表示するには、カタログ エクスプローラー、 、または ノートブックまたはDatabricksUnity CatalogCLIDESCRIBE PROVIDER
SQLDatabricksDatabricks SQL クエリ エディターの コマンドを使用できます。
必要な権限 :メタストア管理者、USE PROVIDER
権限を持つユーザー、またはプロバイダーオブジェクトの所有者。
詳細は次のとおりです。
- プロバイダーが共有するシェア(「プロバイダーがあなたと共有しているシェアを表示する」を参照)。
- プロバイダーの作成者、作成タイムスタンプ、コメント、および認証タイプ (
TOKEN
またはDATABRICKS
)。TOKEN
は、Delta Sharing オープン共有プロトコルを使用してデータを共有したプロバイダーを表します。DATABRICKS
は、 Databricks-to-Databricks 共有プロトコルを使用してデータを共有したプロバイダーを表します。 - プロバイダーが Databricks-to-Databricks 共有を使用している場合: プロバイダーの Unity Catalog メタストアのクラウド、リージョン、メタストア ID。
- プロバイダーがオープン共有を使用している場合: Delta Sharing 共有サーバーがホストされている受信者プロファイル エンドポイント。
- Catalog Explorer
- SQL
- CLI
-
Databricks ワークスペースで、
カタログ をクリックします。
-
[カタログ ] ウィンドウの上部にある [
] 歯車アイコンをクリックし、[ Delta Sharing ] を選択します。
または、[ クイック アクセス ] ページで [Delta Sharing > ] ボタンをクリックします。
-
[ 自分と共有] タブで、プロバイダーを見つけて選択します。
ノートブックまたはDatabricks SQLクエリーエディタで次のコマンドを実行します。
DESC PROVIDER <provider-name>;
DESC PROVIDER
の詳細については、DESCRIBE PROVIDERを参照してください。
Databricks CLI を使用して次のコマンドを実行します。
databricks providers get <provider-name>
プロバイダーがあなたと共有している株式を表示します
プロバイダーが共有している共有を表示するには、カタログ エクスプローラー、Databricks Unity Catalog CLI、または Databricks ノートブックまたは Databricks SQL クエリー エディターの SHOW SHARES IN PROVIDER
SQL コマンドを使用できます。
必要な権限 :メタストア管理者、USE PROVIDER
権限を持つユーザー、またはプロバイダーオブジェクトの所有者。
- Catalog Explorer
- SQL
- CLI
-
Databricks ワークスペースで、
カタログ をクリックします。
-
[カタログ ] ウィンドウの上部にある [
] 歯車アイコンをクリックし、[ Delta Sharing ] を選択します。
または、[ クイック アクセス ] ページで [Delta Sharing > ] ボタンをクリックします。
-
[ 自分と共有] タブで、プロバイダーを見つけて選択します。
ノートブックまたは Databricks SQL クエリ エディターで次のコマンドを実行します。必要に応じて、 <pattern>
を LIKE
述部に置き換えます。
SHOW SHARES IN PROVIDER [LIKE <pattern>];
SHOW SHARES IN PROVIDER
の詳細については、SHOW SHARES IN PROVIDERを参照してください。
Databricks CLI を使用して次のコマンドを実行します。
databricks providers list-shares <provider-name>
プロバイダーの更新 (名前の変更、所有者の変更、コメント)
カタログ エクスプローラー、Databricks Unity Catalog CLI、または Databricks ノートブックまたは Databricks SQL クエリー エディターの ALTER PROVIDER
SQL コマンドを使用して、Unity Catalog メタストア内のプロバイダー オブジェクトを変更できます。
- プロバイダーの名前を変更して、ユーザーが Databricks インターフェイスでプロバイダー オブジェクトを表示する方法を変更します。
- プロバイダ オブジェクトの所有者を変更します。
- コメントを追加または変更してください。
必要な権限 : 所有者を更新するには、プロバイダー オブジェクトの所有者である必要があります。 プロバイダー名を更新するには、メタストアの管理者(または CREATE_PROVIDER
権限を持つユーザー) であり 、プロバイダーの所有者でなければなりません。 コメントを更新するには、所有者である必要があります。 初期所有者はメタストア管理者です。
- Catalog Explorer
- SQL
- CLI
-
Databricks ワークスペースで、
カタログ をクリックします。
-
[カタログ ] ウィンドウの上部にある [
] 歯車アイコンをクリックし、[ Delta Sharing ] を選択します。
または、[ クイック アクセス ] ページで [Delta Sharing > ] ボタンをクリックします。
-
[ 自分と共有] タブで、プロバイダーを見つけて選択します。
-
詳細ページで、所有者、コメント、またはプロバイダー名を更新します。
プロバイダーの名前を変更するには、
ケバブメニューをクリックし、「 名前の変更 」を選択します。
ノートブックまたはDatabricks SQLクエリーエディタで次のコマンドを実行します。
ALTER PROVIDER <provider-name> RENAME TO <new-provider-name>
OWNER TO <new-owner>
COMMENT "<comment>";
ALTER PROVIDER
の詳細については、ALTER PROVIDERを参照してください。
Databricks CLI を使用して次のコマンドを実行します。<provider-name>
を現在のプロバイダー名に、<new-provider-name>
を新しい名前に置き換えます。
databricks providers update <provider-name> /
--new-name <new-provider-name> /
--comment "<new comment>" /
--owner <new-owner-name>
プロバイダーを削除する
プロバイダーを削除するには、カタログ エクスプローラー、DatabricksUnity CatalogCLI 、またはDROP PROVIDER
SQL DatabricksノートブックまたはDatabricks SQL クエリ エディターの コマンドを使用できます。プロバイダーを削除するには、プロバイダー オブジェクトの所有者である必要があります。
プロバイダーを削除すると、自分と組織内のユーザー (受信者) は、プロバイダーが共有するデータにアクセスできなくなります。
必要な権限 : プロバイダー オブジェクトの所有者。
- Catalog Explorer
- SQL
- CLI
-
Databricks ワークスペースで、
カタログ をクリックします。
-
[カタログ ] ウィンドウの上部にある [
] 歯車アイコンをクリックし、[ Delta Sharing ] を選択します。
または、[ クイック アクセス ] ページで [Delta Sharing > ] ボタンをクリックします。
-
[ 自分と共有] タブで、プロバイダーを見つけて選択します。
-
ケバブメニューをクリックし、[ 削除 ]を選択します。
-
確認ダイアログで、[ 削除 ] をクリックします。
ノートブックまたはDatabricks SQLクエリーエディタで次のコマンドを実行します。
DROP PROVIDER [IF EXISTS] <provider-name>;
DROP PROVIDER
の詳細については、「DROP PROVIDER」を参照してください。
Databricks CLI を使用して次のコマンドを実行します。
databricks providers delete <provider-name>
操作が成功した場合、結果は返されません。