本頁說明如何在 Azure Databricks 中檢視、更新及刪除現有的 OpenSharing 共享。 共享是 Unity 目錄中一個可保護的物件,將表格、檢視、卷、筆記本、AI 模型及其他資料資產打包,供一位或多位接收者共享。
若要建立新分享或將資料資產加入現有分享,請參閱 為 OpenSharing 建立共享。 若要授權接收者存取某個分享,請參見管理 OpenSharing 資料分享的存取(供提供者使用)。 要管理你共享的資料接收者,請參閱 OpenSharing 的管理資料接收者。
若要深入了解共用模型,請參閱 共用、提供者和收件者。
Requirements
檢查你是否符合每項任務的列明要求。
| 任務 | Requirements |
|---|---|
| 授與接收者存取權限以共用 |
|
| 檢視分享 |
|
| 更新共享擁有者 |
|
| 更新共用名稱 |
|
| 更新其他共用屬性 |
|
| 刪除共用 |
|
查看分享及分享詳情
在查看分享和分享細節前,請先確認你符合 相關要求 。
若要檢視共用清單或共用的詳細數據,請使用 目錄總管、Databricks Unity 目錄 CLI 或 Azure Databricks 筆記本或 Databricks SQL 查詢編輯器中的 SQL 命令。
共用詳細資料包括下列內容:
- 共享的擁有者、建立者、建立時間戳、更新者、更新時間戳、評論。
- 共用中的數據資產。
- 具有共用存取權的收件者。
目錄檢視器
在您的 Azure Databricks 工作區中,按一下
目錄。
在 目錄 面板頂端,點選
齒輪圖示,選擇 OpenSharing。
或者,從 快速存取 頁面點擊 OpenSharing > 按鈕。
開啟共享標籤以檢視共享清單。
在 [詳細資料] 索引標籤上查看分享詳情。
SQL
若要檢視共用清單,請在筆記本或 Databricks SQL 查詢編輯器中執行下列命令。 選擇性地將 <pattern> 替換為 LIKE 述詞。
SHOW SHARES [LIKE <pattern>];
若要檢視特定共用的詳細數據,請執行下列命令。
DESCRIBE SHARE <share-name>;
若要檢視共用中所有數據表、檢視和磁碟區的詳細數據,請執行下列命令。
SHOW ALL IN SHARE <share-name>;
CLI
若要檢視共用清單,請使用 Databricks CLI 執行下列命令。
databricks shares list
若要檢視特定共用的詳細數據,請執行下列命令。
databricks shares get <share-name>
查看擁有分享權限的收件人
在查看受獎人前,請確認你符合 條件 。
要查看收件人被授權存取的共享清單,請使用 Catalog Explorer、Databricks Unity Catalog CLI,或Azure Databricks筆記本中的 SHOW GRANTS TO RECIPIENT SQL 指令,或 Databricks SQL 查詢編輯器。
目錄檢視器
在您的 Azure Databricks 工作區中,按一下
目錄。
在 目錄 面板頂端,點選
齒輪圖示,選擇 OpenSharing。
或者,從 快速存取 頁面點擊 OpenSharing > 按鈕。
在 [ 由我 共用] 索引卷標上,尋找並選取收件者。
移至 [ 收件者] 索引 標籤,以檢視可存取共用的收件者清單。
SQL
在筆記本或 Databricks SQL 查詢編輯器中,執行下列命令。
SHOW GRANTS ON SHARE <share-name>;
CLI
使用 Databricks CLI 執行下列命令。
databricks shares share-permissions <share-name>
更新共享
在更新分享前,請確認你符合 相關要求 。
您可以透過下列方式更新共享:
- 重新命名共享。
- 從共用中移除資料表、視圖、卷、代理技能和結構描述。
- 在分享上新增或更新留言。
- 重新命名數據表的別名(顯示給收件者的數據表名稱)。
- 啟用或停用數據表記錄數據的存取權,讓收件者能夠執行時間移動查詢或串流讀取數據表。
- 新增、更新或移除分割區定義。
- 變更共享擁有者。
要對分享進行這些更新,請使用目錄總管、Databricks Unity Catalog CLI,或在 Azure Databricks 筆記本或 Databricks SQL 查詢編輯器中使用 SQL 指令。 不過,您無法使用「Catalog Explorer」來重新命名共用。
目錄檢視器
在您的 Azure Databricks 工作區中,按一下
目錄。
在 目錄 面板頂端,點選
齒輪圖示,選擇 OpenSharing。
或者,從 快速存取 頁面點擊 OpenSharing > 按鈕。
在 [ 由我 共用] 索引標籤上,尋找您要更新的共享,然後按兩下其名稱。
在 [共用詳細數據] 頁面上,執行下列動作:
- 單擊 [
] 擁有者或批註字段旁的圖示以更新這些值。 - 點擊資產列中的
按鈕以進行刪除操作。
- 按兩下 [管理資產] [編輯資產>] 以更新所有其他屬性:
- 若要移除資產,請清除資產旁的複選框。
- 若要新增、更新或移除資料分割定義,請按兩下 [ 進階選項]。
SQL
在筆記本或 Databricks SQL 編輯器中執行下列命令。
重新命名共享資源:
ALTER SHARE <share-name> RENAME TO <new-share-name>;
從共享中移除資料表:
ALTER SHARE share_name REMOVE TABLE <table-name>;
從共享中移除磁碟區:
ALTER SHARE share_name REMOVE VOLUME <volume-name>;
在分享上新增或更新留言:
COMMENT ON SHARE <share-name> IS '<comment>';
在共享環境中新增或修改資料表的分區:
ALTER SHARE <share-name> ADD TABLE <table-name> PARTITION(<clause>);
變更共享擁有者:
ALTER SHARE <share-name> OWNER TO <principal>
-- Principal must be an account-level user email address or group name.
開啟資料表的歷程記錄共享:
ALTER SHARE <share-name> ADD TABLE <table-name> WITH HISTORY;
如需 ALTER SHARE 參數的詳細資訊,請參閱 ALTER SHARE。
CLI
使用 Databricks CLI 執行下列命令。
重新命名共享資源:
databricks shares update <share-name> --name <new-share-name>
從共享中移除資料表:
databricks shares update <share-name> \
--json '{
"updates": [
{
"action": "REMOVE",
"data_object": {
"name": "<table-full-name>",
"data_object_type": "TABLE",
"shared_as": "<table-alias>"
}
}
]
}'
從共享中移除磁碟區(使用 Databricks CLI 0.210 或更新版本):
databricks shares update <share-name> \
--json '{
"updates": [
{
"action": "REMOVE",
"data_object": {
"name": "<volume-full-name>",
"data_object_type": "VOLUME",
"string_shared_as": "<volume-alias>"
}
}
]
}'
備註
如果磁碟區沒有別名,請使用name屬性。 如果有別名,請使用 string_shared_as 。
從共享移除代理技能(使用 Databricks CLI 0.210 或以上版本):
databricks shares update <share-name> \
--json '{
"updates": [
{
"action": "REMOVE",
"data_object": {
"name": "<skill-full-name>",
"data_object_type": "SKILL",
"string_shared_as": "<skill-alias>"
}
}
]
}'
備註
如果技能沒有別名,就使用該 name 屬性。 如果有別名,請使用 string_shared_as 。
要將經紀人技能加入股票,請參見 「新增經紀人技能到股票」。
在分享上新增或更新留言:
databricks shares update <share-name> --comment '<comment>'
變更共享擁有者:
databricks shares update <share-name> --owner '<principal>'
主體必須是帳戶層級的用戶電子郵件位址或組名。
更新股份持有者時的考慮
共用擁有者的身分會影響授權和安全性功能(如 ABAC 原則)如何進行評估。 如果您有受 ABAC 原則保護的數據表或架構,將股權擁有權轉移給擁有過多權限的使用者,這些收件者可能會因此獲得過多的存取權限。
刪除分享
當您刪除共用時,收件者無法再存取共享數據。 刪除分享物件前,請確認你符合 相關要求 。
若要刪除分享,請使用 Catalog Explorer、Databricks Unity Catalog CLI,或在 Azure Databricks 筆記本或 Databricks SQL 查詢編輯器中使用 DELETE SHARE SQL 指令。 您必須是共享的擁有者。
目錄檢視器
在您的 Azure Databricks 工作區中,按一下
目錄。
在 目錄 面板頂端,點選
齒輪圖示,選擇 OpenSharing。
或者,從 快速存取 頁面點擊 OpenSharing > 按鈕。
在 [ 由我 共用] 索引標籤上,尋找您要刪除的共享,然後按兩下其名稱。
點選
,然後選擇 刪除。
在確認對話框中,按兩下 [ 刪除]。
SQL
在筆記本或 Databricks SQL 查詢編輯器中,執行下列命令。
DROP SHARE [IF EXISTS] <share-name>;
CLI
使用 Databricks CLI 執行下列命令。
databricks shares delete <share-name>