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 ワークスペースから共有されていないプロバイダーからデータを受信している場合は、Catalog Explorer を使用してプロバイダーの資格情報ファイルをインポートできます。 「Databricks: オープン共有コネクタを使用して共有データを読み取る」を参照してください。
始める前に
Databricks ワークスペースでプロバイダーを管理するには:
- ワークスペースでUnity Catalogが有効になっている必要があります。
- プロバイダーを表示するには、メタストア管理者であるか、メタストア管理者から
USE PROVIDER
特権が付与されている必要があります。 - プロバイダーを作成するには、メタストア管理者であるか、メタストア管理者から
CREATE PROVIDER
特権が付与されている必要があります。 - プロバイダーを更新するには、プロバイダーオブジェクトの所有者であり、
CREATE PROVIDER
権限を持っている必要があります。 詳細については、「プロバイダーの更新 (名前の変更、所有者の変更、コメント)」を参照してください。
このため、ワークスペースがメタストア管理者なしで作成された場合、Databricks でプロバイダー オブジェクトを操作する前に、Databricks アカウント管理者がユーザーまたはグループにメタストア管理者ロールを付与する必要があります。 「Unity Catalog の自動有効化」および「(省略可能) メタストア管理者ロールの割り当て」を参照してください。
プロバイダーを見る
使用可能なデータ プロバイダーの一覧を表示するには、Catalog Explorer、Databricks Unity Catalog CLI、または Databricks ノートブックまたは Databricks SQL クエリ エディターの SHOW PROVIDERS
SQL コマンドを使用できます。
必要なアクセス許可 : メタストア管理者であるか、メタストア内のすべてのプロバイダーを表示するための USE PROVIDER
特権を持っている必要があります。 他のユーザーは、自分が所有するプロバイダーにのみアクセスできます。
- Catalog Explorer
- SQL
- CLI
-
In your Databricks workspace, click
Catalog.
-
At the top of the Catalog pane, click the
gear icon and select Delta Sharing.
Alternatively, from the Quick access page, click the Delta Sharing > button.
-
On the Shared with me tab, view all available providers.
Run the following command in a notebook or the Databricks SQL query editor. Optionally, replace <pattern>
with a LIKE
predicate.
SHOW PROVIDERS [LIKE <pattern>];
Run the following command using the 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
-
In your Databricks workspace, click
Catalog.
-
At the top of the Catalog pane, click the
gear icon and select Delta Sharing.
Alternatively, from the Quick access page, click the Delta Sharing > button.
-
On the Shared with me tab, find and select the provider.
Run the following command in a notebook or the Databricks SQL query editor.
DESC PROVIDER <provider-name>;
Run the following command using the 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
-
In your Databricks workspace, click
Catalog.
-
At the top of the Catalog pane, click the
gear icon and select Delta Sharing.
Alternatively, from the Quick access page, click the Delta Sharing > button.
-
On the Shared with me tab, find and select the provider.
Run the following command in a notebook or the Databricks SQL query editor. Optionally, replace <pattern>
with a LIKE
predicate.
SHOW SHARES IN PROVIDER [LIKE <pattern>];
Run the following command using the 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
-
In your Databricks workspace, click
Catalog.
-
At the top of the Catalog pane, click the
gear icon and select Delta Sharing.
Alternatively, from the Quick access page, click the Delta Sharing > button.
-
On the Shared with me tab, find and select the provider.
-
On the details page, update the owner, comment, or provider name.
To rename a provider, click the
kebab menu and select Rename.
Run the following command in a notebook or the Databricks SQL query editor.
ALTER PROVIDER <provider-name> RENAME TO <new-provider-name>
OWNER TO <new-owner>
COMMENT "<comment>";
Run the following command using the Databricks CLI. Replace <provider-name>
with the current provider name and <new-provider-name>
with the new 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
-
In your Databricks workspace, click
Catalog.
-
At the top of the Catalog pane, click the
gear icon and select Delta Sharing.
Alternatively, from the Quick access page, click the Delta Sharing > button.
-
On the Shared with me tab, find and select the provider.
-
Click the
kebab menu and select Delete.
-
On the confirmation dialog, click Delete.
Run the following command in a notebook or the Databricks SQL query editor.
DROP PROVIDER [IF EXISTS] <provider-name>;
Run the following command using the Databricks CLI.
databricks providers delete <provider-name>
If the operation is successful, no results are returned.