建立 OpenSharing 的資料接收者（Databricks-to-Databricks 共享）

本頁說明如何在 OpenSharing 中建立收件人，當收件人在啟用 Unity 目錄的 Databricks 工作區時。 若要查看、更新、刪除、授權分享存取、管理屬性，或限制現有接收者的 IP 清單存取，請參閱 OpenSharing 的資料接收者管理。

收件者是具名物件，代表取用共用數據之使用者或使用者群組的身分識別。 您建立收件者的方式會根據收件者是否能夠存取針對 Unity 目錄啟用的 Databricks 工作區而有所不同：

• 能夠存取啟用 Unity Catalog 的 Databricks 工作區的收件者：

  您可以使用 Databricks 所管理的安全連線來建立收件者物件。 此共用模式稱為 Databricks 對 Databricks 共用，記載於本頁面。

• 無法存取 Unity 目錄已啟用的 Databricks 工作區的收件者：

  您必須使用開放式分享，並以您管理的令牌驗證（包括持有者令牌或 OAuth 聯合）來保持連線的安全性。 關於建立 Databricks-to-Open 分享接收者的資訊，請參閱 「啟用開放 ID 連接（OIDC）聯盟給 OpenSharing 接收者」 及 「為非 Databricks 使用者使用持有人憑證建立接收物件（Databricks-to-Open 共享）」。

如需進一步了解這兩種共享模式，以及何時該選擇哪一種，請參閱 Databricks-to-Open sharing 與 Databricks-to-Databricks sharing。

要求

若要建立收件者：

• 你必須擁有 Unity Catalog 中繼儲存庫的 CREATE RECIPIENT 權限，該中繼儲存庫是你想分享的資料註冊所在。
• 您必須使用附加有 Unity Catalog 中繼存放區的 Azure Databricks 工作區來創建收件者。
• 如果您使用 Databricks 筆記本來建立收件者，您的計算必須使用 Databricks Runtime 11.3 LTS 或更新版本，以及標準或專用存取模式（先前共用和單一使用者存取模式）。

關於其他接收者操作（檢視、更新、刪除、授權分享存取權、管理屬性）所需的權限，請參見 OpenSharing 的「管理資料接收者」。

為擁有 Databricks 存取權的使用者建立收件者物件（Databricks 與 Databricks 之間的共用）

如果您的數據收件者可以存取已為 Unity Catalog 啟用的 Databricks 工作區，您可以建立具有 驗證類型的收件者物件。

驗證類型的 DATABRICKS 收件者物件代表特定 Unity 目錄中繼存放區上的數據收件者，該物件定義是由中繼存放區的雲端、區域和 UUID 所組成的 共用識別符 字串所識別。 只有該中繼存放區可以存取與這個收件者共享的數據。

步驟 1：要求收件者的共享標識符

請求收件者使用者將工作區中附加之 Unity Catalog 中繼存放區的共用標識碼寄給您，以便收件者使用者或使用者群組使用共用數據進行工作。

共用識別碼是一個字串，其中包含中繼存放區的雲端、區域和 UUID（中繼存放區的唯一標識符），格式為 <cloud>:<region>:<uuid>。

例如，在下列螢幕快照中，完整的共用識別符字串為 aws:us-west-2:19a84bee-54bc-43a2-87de-023d0ec16016。

收件者可以使用目錄總管、Databricks Unity Catalog CLI，或者在 Databricks Notebook 或 Databricks SQL 查詢中使用預設的 SQL 函式 CURRENT_METASTORE，來在他們想要使用的工作區中運行 Unity-Catalog 支援的計算，從而找到標識符。

目錄檢視器

若要使用目錄總管取得共享識別碼：

1. 在您的 Azure Databricks 工作區中，按一下 目錄。

2. 在 目錄 面板頂端，點選 齒輪圖示，選擇 OpenSharing。

   或者，在右上角點選 「分享 > OpenSharing」。

3. 在 [與我分享] 分頁上，按一下右上角的 Databricks 共用組織名稱，然後選擇 [複製共用識別碼]。

SQL

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

SELECT CURRENT_METASTORE();

CLI

使用 Databricks CLI 執行下列命令。 共用標識碼會以 global_metastore_id傳回。

databricks metastores summary

您可以將此步驟所含資訊傳送給您的收件者，或指引他們至Databricks-to-Databricks 模型中的存取權限頁。

步驟 2：建立收件者

若要建立 Databricks 到 Databricks 共用的收件者，您可以使用目錄總管、Databricks Unity 目錄的 CLI，或在 Azure Databricks 筆記本或 Databricks SQL 查詢編輯器中使用 CREATE RECIPIENT SQL 命令。

所需許可權：中繼存放區管理員或在您要共用資料的 Unity 目錄中繼存放區中擁有 CREATE RECIPIENT 許可權的使用者。

目錄檢視器

1. 在您的 Azure Databricks 工作區中，按一下 目錄。

2. 在 目錄 面板頂端，點選 齒輪圖示，選擇 OpenSharing。

   或者，在右上角點選 「分享 > OpenSharing」。

3. 在 由我共用 標籤上，按一下 新增收件者。

4. 輸入 收件者名稱。

5. 針對 [收件者類型]，選取 [Databricks]。

6. 輸入收件者的 共用識別碼。

   使用格式 <cloud>:<region>:<uuid>的整個共用識別符字串。 例如： aws:us-west-2:19a84bee-54bc-43a2-87de-023d0ec16016 。

7. （選擇性）輸入批註。

8. 點擊 建立。

9. （選擇性）建立自定義 收件者屬性。

   在收件者 概觀 索引標籤上，點擊 位於 [收件者屬性] 旁的 編輯圖示。 然後新增屬性名稱 (鍵) 和 值。 如需詳細資訊，請參閱 管理收件者屬性。

SQL

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

CREATE RECIPIENT [IF NOT EXISTS] <recipient-name>
USING ID '<sharing-identifier>'
[COMMENT "<comment>"];

使用格式 <cloud>:<region>:<uuid>的整個共用識別符字串。 例如： aws:eu-west-1:g0c979c8-3e68-4cdf-94af-d05c120ed1ef 。

您也可以為收件者新增自訂屬性。 如需詳細資訊，請參閱 管理收件者屬性。

CLI

使用 Databricks CLI 執行下列命令。 替換占位符值：

• <recipient-name>：收件者的名稱。
• <sharing-identifier>：整個共用識別符字串的格式為 <cloud>:<region>:<uuid>。 例如： aws:eu-west-1:g0c979c8-3e68-4cdf-94af-d05c120ed1ef 。
• <authentication-type>：當針對DATABRICKS提供格式<cloud>:<region>:<uuid>的共享識別符字串時，將<sharing-identifier>設定為<cloud>:<region>:<uuid>。

databricks recipients create <recipient-name> <authentication-type> --sharing-code <sharing-identifier>

您也可以為收件者新增自訂屬性。 如需詳細資訊，請參閱 管理收件者屬性。

收件者是由 authentication_type 使用 DATABRICKS 建立的。

其他資源

• 管理 OpenSharing 資料分享的存取權（供提供者使用） — 授予接收者一個或多個分享的存取權。
• 管理 OpenSharing 的資料接收者 — 檢視、更新、刪除、管理屬性，或限制現有接收者的存取權限。
• 為 OpenSharing 建立分享 — 建立你想授權收件人存取的分享。