共用方式為

管理差異共用提供者 （適用於資料收件者）

  • 發行項

本文說明如何使用 Unity 目錄來取得使用 Delta Sharing 與您共用數據的數據提供者相關信息。 它也描述提供者對象是什麼，以及當您可能需要在 Unity 目錄中繼存放區中建立提供者物件時，大部分收件者都不需要執行的工作。

重要

數據收件者必須能夠存取已啟用 Unity 目錄 的 Databricks 工作區，才能使用本文所述的功能。 本文不適用於未啟用 Unity 目錄工作區的收件者。

收件者是否需要建立提供者物件？

在 Databricks 上的 Delta Sharing 中，「提供者」一詞可能表示與您共用數據的組織，以及代表該組織之收件者的 Unity 目錄中繼存放區中的安全性實體物件。 收件者 Unity 目錄中繼存放區中存在該安全性實體物件，可讓收件者 使用 Unity 目錄管理其小組對共用數據的存取權。

身為具有 Unity 目錄中繼存放區存取權的收件者，您通常不需要建立提供者物件。 這是因為應該使用 Databricks 到 Databricks 共用來與您共用數據，且提供者物件會在 Unity 目錄中繼存放區中自動建立。

注意

如果您是 Unity 目錄上的罕見收件者，其接收來自未從已啟用 Unity 目錄之 Databricks 工作區共用之提供者的數據，您可能會想要在 Unity 目錄中建立提供者物件，以便您可以使用 Unity 目錄管理該共享數據。 如果您位於該類別中，您可以使用 POST /api/2.1/unity-catalog/providers REST API 呼叫或 Databricks CLI 來建立 Unity 目錄提供者物件。 您必須是具有 CREATE_PROVIDER 中繼存放區許可權的中繼存放區管理員或使用者。

開始之前

若要管理 Azure Databricks 工作區中的提供者：

  • 必須為 Unity Catalog 啟用工作區。
  • 若要檢視提供者，您必須是中繼存放區管理員，或中繼存放區管理員必須授與您 USE PROVIDER 許可權。
  • 若要建立提供者，您必須是中繼存放區管理員，或中繼存放區管理員必須授與您 CREATE PROVIDER 許可權。
  • 若要更新提供者，您必須是提供者對象的擁有者，而且具有 CREATE PROVIDER 許可權。 如需詳細資訊，請參閱更新提供者（重新命名、變更擁有者、批注）。

基於這個理由，如果您的工作區是在沒有中繼存放區管理員的情況下建立的，Azure Databricks 帳戶管理員必須先授與使用者或群組中繼存放區管理員角色，才能在 Azure Databricks 中使用提供者物件。 請參閱 自動啟用 Unity 目錄 和 （選擇性） 指派中繼存放區管理員角色。

檢視提供者

若要檢視可用資料提供者的清單，您可以使用目錄總管、Databricks Unity 目錄 CLI，或 Azure Databricks 筆記本或 Databricks SQL 查詢編輯器中的 SHOW PROVIDERS SQL 命令。

需要許可權：您必須是中繼存放區管理員，或具有 USE PROVIDER 檢視中繼存放區中所有提供者的許可權。 其他使用者只能存取其擁有的提供者。

目錄總管

  1. 在 Azure Databricks 工作區中，按一下 目錄圖示 [目錄]。

  2. 在 [目錄] 窗格頂端，按一下齒輪圖示齒輪圖示，然後選取 [Delta Sharing]。

    或者，從 [快速存取] 頁面，按一下 [Delta Sharing >] 按鈕。

  3. 在 [ 與我 共用] 索引卷標上，檢視所有可用的提供者。

SQL

在筆記本或 Databricks SQL 查詢編輯器中執行下列命令。 或者，將 取代 <pattern> 為 LIKE 述詞。

SHOW PROVIDERS [LIKE <pattern>];

CLI

使用 Databricks CLI 執行下列命令。

databricks providers list

檢視提供者詳細資料

若要檢視有關提供者的詳細資料，您可以使用目錄總管、Databricks Unity 目錄 CLI，或 Azure Databricks 筆記本或 Databricks SQL 查詢編輯器中的 DESCRIBE PROVIDER SQL 命令。

需要的許可權：中繼存放區管理員、具有 USE PROVIDER 許可權的使用者，或提供者對象擁有者。

詳細資料包括：

  • 提供者共用的共用（請參閱 檢視提供者與您共用的共用）。
  • 提供者的建立者、建立時間戳、批注和驗證類型 （TOKEN 或 DATABRICKS）。 TOKEN 代表使用 Delta Sharing 開啟共用通訊協定與您共用數據的提供者。 DATABRICKS 代表使用 Databricks-to-Databricks 共用通訊協定與您共用數據的提供者。
  • 如果提供者使用 Databricks 對 Databricks 共用：提供者 Unity 目錄中繼存放區的雲端、區域和中繼存放區標識符。
  • 如果提供者使用開啟共用：您的收件者配置檔端點，也就是裝載 Delta Sharing 共用伺服器的位置。

目錄總管

  1. 在 Azure Databricks 工作區中，按一下 目錄圖示 [目錄]。

  2. 在 [目錄] 窗格頂端，按一下齒輪圖示齒輪圖示，然後選取 [Delta Sharing]。

    或者，從 [快速存取] 頁面，按一下 [Delta Sharing >] 按鈕。

  3. 在 [與我共用] 索引標籤上，尋找並選取提供者。

SQL

在筆記本或 Databricks SQL 查詢編輯器中執行下列命令。

DESC PROVIDER <provider-name>;

CLI

使用 Databricks CLI 執行下列命令。

databricks providers get <provider-name>

檢視提供者與您共用的共用

若要檢視提供者與您共用的共用，您可以使用目錄總管、Databricks Unity 目錄 CLI，或 Azure Databricks 筆記本或 Databricks SQL 查詢編輯器中的 SHOW SHARES IN PROVIDER SQL 命令。

需要的許可權：中繼存放區管理員、具有 USE PROVIDER 許可權的使用者，或提供者對象擁有者。

目錄總管

  1. 在 Azure Databricks 工作區中，按一下 目錄圖示 [目錄]。

  2. 在 [目錄] 窗格頂端，按一下齒輪圖示齒輪圖示，然後選取 [Delta Sharing]。

    或者，從 [快速存取] 頁面，按一下 [Delta Sharing >] 按鈕。

  3. 在 [與我共用] 索引標籤上，尋找並選取提供者。

SQL

在筆記本或 Databricks SQL 查詢編輯器中執行下列命令。 或者，將 取代 <pattern> 為 LIKE 述詞。

SHOW SHARES IN PROVIDER [LIKE <pattern>];

CLI

使用 Databricks CLI 執行下列命令。

 databricks providers list-shares <provider-name>

更新提供者（重新命名、變更擁有者、批註）

您可以使用目錄總管、Databricks Unity 目錄 CLI 或 ALTER PROVIDER Azure Databricks Notebook 或 Databricks SQL 查詢編輯器中的 SQL 命令來修改 Unity 目錄中繼存放區中的提供者物件：

  • 重新命名提供者，以修改使用者在 Databricks 介面中看到提供者物件的方式。
  • 變更提供者對象的擁有者。
  • 新增或修改批注。

需要許可權：您必須是提供者對象的擁有者，才能更新擁有者。 您必須是中繼存放區管理員（或具有CREATE_PROVIDER許可權的使用者）和提供者擁有者，才能更新提供者名稱。 您必須是擁有者，才能更新批注。 初始擁有者是中繼存放區管理員。

目錄總管

  1. 在 Azure Databricks 工作區中，按一下 目錄圖示 [目錄]。

  2. 在 [目錄] 窗格頂端，按一下齒輪圖示齒輪圖示，然後選取 [Delta Sharing]。

    或者，從 [快速存取] 頁面，按一下 [Delta Sharing >] 按鈕。

  3. 在 [與我共用] 索引標籤上，尋找並選取提供者。

  4. 在詳細數據頁面上，更新擁有者、批注或提供者名稱。

    若要重新命名提供者，請單擊 Kebab 功能表 kebab功能表，然後選取 [ 重新命名]。

SQL

在筆記本或 Databricks SQL 查詢編輯器中執行下列命令。

ALTER PROVIDER <provider-name> RENAME TO <new-provider-name>
OWNER TO <new-owner>
COMMENT "<comment>";

CLI

使用 Databricks CLI 執行下列命令。 將 取代為目前的提供者名稱，並將 <new-provider-name> 取代<provider-name>為新的名稱。

databricks providers update <provider-name> /
--new-name <new-provider-name> /
--comment "<new comment>" /
--owner <new-owner-name>

刪除提供者

若要刪除提供者，您可以使用目錄總管、Databricks Unity 目錄 CLI，或 DROP PROVIDER Azure Databricks 筆記本或 Databricks SQL 查詢編輯器中的 SQL 命令。 您必須是提供者對象擁有者，才能刪除提供者。

當您刪除提供者時，您和組織中的使用者（收件者）無法再存取提供者共享的數據。

必要許可權：提供者對象擁有者。

目錄總管

  1. 在 Azure Databricks 工作區中，按一下 目錄圖示 [目錄]。

  2. 在 [目錄] 窗格頂端，按一下齒輪圖示齒輪圖示，然後選取 [Delta Sharing]。

    或者，從 [快速存取] 頁面，按一下 [Delta Sharing >] 按鈕。

  3. 在 [與我共用] 索引標籤上，尋找並選取提供者。

  4. Kebab 功能表按兩下 kebab 選單，然後選取 [刪除]。

  5. 在確認對話框中，按兩下 [ 刪除]。

SQL

在筆記本或 Databricks SQL 查詢編輯器中執行下列命令。

DROP PROVIDER [IF EXISTS] <provider-name>;

CLI

使用 Databricks CLI 執行下列命令。

databricks providers delete <provider-name>

如果作業成功，則不會傳回任何結果。