在 Databricks Marketplace 中列出您的數據產品
本文說明如何成為 Databricks Marketplace 提供者,以及如何為您的數據產品建立 Databricks Marketplace 清單。
開始之前
若要列出 Databricks Marketplace 中的產品,您必須同意提供者原則,而且您的帳戶和工作區必須符合特定需求。
原則:
若要列出 Marketplace 交換上的數據產品,您必須同意 Marketplace 提供者原則。
帳戶和工作區需求:
Databricks Marketplace 使用 Delta Sharing 來管理數據產品的安全共用。 接著,差異共用會要求您的 Databricks 工作區已啟用 Unity 目錄。 因此,您的 Azure Databricks 帳戶和工作區必須符合下列需求:
- 進階版 方案中的 Azure Databricks 帳戶。
- 已啟用 Unity 目錄的 Azure Databricks 工作區。 請參閱 啟用 Unity 目錄的工作區。 您不需要啟用 Unity 目錄的所有工作區。 您可以只建立一個來管理 Marketplace 清單。
如果您有符合這些準則的工作區,您的用戶將能夠檢視 Marketplace 首頁。 建立和管理清單需要其他許可權。 這些會列舉於下列各節中。 如果您不想讓使用者能夠檢視 Marketplace 首頁,請連絡您的 Azure Databricks 帳戶小組。
權限需求:
若要註冊為僅限私人交換的提供者,您必須是 Azure Databricks 帳戶管理員。請參閱 註冊成為 Databricks Marketplace 提供者。
註冊成為 Databricks Marketplace 提供者
您註冊成為 Databricks Marketplace 提供者的方式取決於您打算在公用市集中建立清單,還是只透過私人交換來建立清單。 在私人交換中,只有屬於交換成員的取用者可以瀏覽、檢視及要求存取清單。 請參閱 在 Databricks Marketplace 中建立和管理私人交換。
若要成為僅限私人交換的提供者,您可以使用提供者控制台註冊。 若要建立公用清單,您可以透過 Databricks Data Partner 計劃套用。
套用至可建立公用清單的提供者
注意
如果您的組織已經在 Databricks 合作夥伴計劃中,而且您有興趣成為 Marketplace 提供者,請改為略過下列指示並連絡 partnerops@databricks.com
。
在 [ Databricks Data Partner 計劃] 頁面上,按兩下 [ 立即套用]。
在下一個頁面上,按兩下 [立即套用]。
輸入您的電子郵件地址,然後按兩下 [ 立即套用]。
填寫應用程式表單。
在應用程式表單底部,系統會詢問您感興趣的 Databricks 合作夥伴計畫。 選取 [Marketplace]。
Databricks 合作夥伴小組會與您連絡以完成應用程式程式。 當您獲得核准時,提供者控制台將會在已啟用 Unity-Catalog 的 Azure Databricks 工作區中取得。 若要存取提供者控制台,用戶必須具有 Marketplace 系統管理員角色。
註冊為私人交換提供者
若要註冊為僅限私人交換的提供者,請使用 提供者控制台中的 [開始使用] 作為提供者 頁面。
若要註冊為私人交換提供者:
身為 Azure Databricks 帳戶管理員,登入您的 Azure Databricks 工作區。
在提要欄位中,按兩下 [Marketplace]。
在 Marketplace 頁面右上角,按兩下 [提供者控制台]。
如果您的帳戶尚未上線為提供者,提供者控制台會顯示 [以提供者 身分開始使用] 頁面,引導您完成將帳戶啟用為私人交換提供者的程式。
在 [接受 Marketplace 條款] 底下,按兩下 [Databricks Marketplace 私人提供者條款] 連結以檢閱條款。
若要接受條款,請按兩下 [ 接受私人提供者條款 ] 按鈕。
這會帶您前往新瀏覽器索引標籤中的 Azure Databricks 帳戶主控台,並開啟 [設定 > 功能啟用] 索引卷標。如果您尚未登入,您可能需要登入帳戶主控台。
注意
如果您有多個 Azure Databricks 帳戶,您應該確認您登入的帳戶包含您要存取提供者控制台的工作區。
在 [ 功能啟用 ] 索引標籤上,啟用 Marketplace Private Exchange Provider 選項。
返回工作區中的 [提供者] 控制台,然後按兩下 [重新整理] 頁面。 請勿使用瀏覽器的重新整理頁面功能。
幾分鐘后, [指派 Marketplace 管理員] 按鈕隨即出現。 按兩下它以在帳戶控制台中開啟您的用戶頁面。 在 [ 角色] 索引標籤上,啟用 Marketplace 系統管理員。
您可以選擇將 Marketplace 系統管理員角色指派給其他使用者或使用者。 如果您這樣做,他們可以從這一點繼續程式。 如果您將角色指派給自己,您可以繼續此程式。
返回工作區中的 [提供者] 控制台,然後按兩下 [重新整理] 頁面。 請勿使用瀏覽器的重新整理頁面功能。
幾分鐘后,[ 建立提供者配置檔 ] 按鈕隨即出現。 按兩下它以開啟 [ 建立設定檔] 頁面。
注意
系統可能需要幾分鐘的時間才能完成指派 Marketplace 系統管理員角色。 如果您繼續建立提供者配置檔,並看到錯誤指出您沒有 Marketplace 系統管理員角色,請再等候幾分鐘、重新整理頁面,然後重試。
若要建立提供者配置檔,請遵循從步驟 5 開始建立 Marketplace 提供者設定檔中的指示。
建立您的第一個私人交換。 請參閱 在 Databricks Marketplace 中建立和管理私人交換。
指派 Marketplace 系統管理員角色
如果您註冊為私人交換提供者,則會在註冊程序中執行此工作。 除非您想要以 Marketplace 系統管理員身分在 Azure Databricks 帳戶中啟用其他使用者,否則您可以略過本節中的指示。
一旦核准為 Marketplace 提供者,您必須至少授與一個使用者 Marketplace 系統管理員角色。 存取 Marketplace 提供者控制台以及建立和管理 Marketplace 提供者設定檔和列表時,需要此角色。 Azure Databricks 帳戶管理員可以授與角色。
- 身為帳戶管理員,登入 帳戶控制台。
- 按兩下 [使用者管理]。
- 尋找並按下用戶名稱。
- 在 [ 角色] 索引標籤上,開啟 Marketplace 系統管理員。
建立 Marketplace 提供者配置檔
您的提供者配置檔可讓您告知潛在消費者身分,並將您的數據產品分組為單一品牌或身分識別。 一般而言,數據提供者有一個配置檔,但可以列出多個數據產品。 如果您想要多個配置檔,請連絡您的 Azure Databricks 帳戶小組。
如果您是公用提供者,您可以在提供者應用程式核准之後建立配置檔。 如果您是僅限私人交換的提供者,請從此處提供的程式中的步驟 5 開始,建立配置檔作為註冊程序的最後一個步驟。
需要許可權:Marketplace 管理員角色
建立設定檔:
- 登入您將用來建立共用和清單的 Azure Databricks 工作區。
- 在提要欄位中,按兩下 [Marketplace]。
- 在 Marketplace 頁面右上角,按兩下 [提供者控制台]。
- 在 [ 提供者控制台] 頁面 [配置檔] 索引標籤上,按兩下 [ 建立配置檔]。
- 輸入下列資訊。 所有欄位都是必要欄位:
- 提供者名稱:使用取用者將辨識的名稱。 取用者可以依提供者名稱篩選清單。
- 標誌:拖放或瀏覽至您想要在清單中使用的標誌圖像檔。
- 描述:清楚且準確地描述您的組織。 包含詳細數據,例如您通常提供服務或代表的產業,以及您通常列出的數據資產類型。 取用者可以在檢視您的配置檔和所有清單時看到此描述。
- 組織網站:連結至貴組織的網站。 取用者可以遵循此連結來深入瞭解您的組織。 此連結會出現在所有清單上。
- 商務電子郵件:輸入 Databricks 可用來傳送通知的電子郵件位址。 取用者看不到這項資訊。
- 支援電子郵件:輸入取用者可用來要求支援的電子郵件位址。 此連結會出現在所有清單上。
- 服務條款連結:此連結會顯示在您的所有清單上。 您可以在清單層級輸入不同的連結來覆寫此連結。
- 隱私策略:此鏈接會顯示在您的所有清單上。 您可以在清單層級輸入不同的連結來覆寫此連結。
- 儲存設定檔。
如果您是 Marketplace 提供者時有任何這項資訊變更,請更新您的配置檔。 您的配置檔必須準確且保持在最新狀態。
建立共用
在針對 Delta Sharing 啟用 Azure Databricks 帳戶,併為 Unity 目錄啟用 Azure Databricks 工作區之後,您可以建立 您將用來在 Marketplace 中共用數據的共用 。
共用是 Delta Sharing 物件。 它是數據表、檢視表、磁碟區和 AI 模型的集合,可共用且安全性實體作為一個單位。 數據表可以與任何取用者共用。 磁碟區、AI 模型和筆記本只能與可存取已啟用 Unity 目錄之 Azure Databricks 工作區的取用者共用。
注意
若要列出免費且立即可供取用者使用的數據產品,您必須在建立清單時包含共用。 另一方面,需要您核准取用者要求的清單不需要在清單中包含共用。 您稍後可以在任何商務合約完成且已核准取用者的要求之後,建立共用。 如果這是您想要執行的動作,請直接跳到 建立清單。
將數據表、檢視或磁碟區新增至 Unity 目錄中繼存放區。
若要瞭解如何在 Unity 目錄中建立這些數據資產,請參閱:
建立共用,並將這些數據資產新增至共用。
若要瞭解如何建立及更新共用,請參閱 建立和管理差異共用的共用。
需要的權限:
- 若要建立共用,您必須是中繼存放區管理員或具有
CREATE SHARE
註冊所要共用數據的 Unity 目錄中繼存放區許可權的使用者。 - 若要將數據表、磁碟區或檢視新增至共用,您必須是共用擁有者、具有
USE SCHEMA
包含數據資產之架構的許可權,以及擁有SELECT
數據資產的許可權。 您必須保留SELECT
許可權,資產才能繼續共用。 如果您遺失,收件者就無法透過共用存取資產。 因此,Databricks 建議您使用群組作為共享擁有者。
如需共用數據表、磁碟區和檢視需求的詳細資訊,包括計算和數據類型需求,請參閱 建立和管理差異共用的共用。
- 若要建立共用,您必須是中繼存放區管理員或具有
建立共享之後,您可以建立或更新參考該共用的 Marketplace 清單。
筆記本範例:範例筆記本
除了數據表、磁碟區和檢視之外,Databricks 強烈建議您也共用 Azure Databricks 筆記本。 筆記本是示範範例使用案例並將數據表屬性可視化的絕佳方式。 您的清單可以包含取用者可以匯入其工作區的範例筆記本預覽。
如需建立筆記本的詳細資訊,請參閱 Databricks 筆記本簡介。 如果您需要建立有效範例筆記本的協助,請連絡 dataproviders@databricks.com
。
注意
清單 UI 中的範例筆記本 顯示和預覽無法在 Chrome Incognito 模式中運作。
下列範例示範如何建立有效的範例筆記本。 其中包含為清單建立有效範例筆記本的指引。
數據提供者的 Marketplace 入門筆記本
建立清單
Marketplace 清單可讓取用者瀏覽、選取及存取您的數據產品。 所有數據集清單都會自動與 Azure Databricks 工作區上的取用者共用,以及 Power BI、pandas 和 Apache Spark 等第三方平臺上的取用者。
注意
某些數據資產,例如 Databricks 磁碟區,只能與可存取已啟用 Unity 目錄之 Databricks 工作區的取用者共用。 不過,數據表可以與所有取用者共用。 如果您在共用中包含資料表和磁碟區,則無法存取已啟用 Unity 目錄之工作區的取用者只能存取表格式數據。
需要的許可權:Marketplace 系統管理員角色。 如果您要建立及管理個人化清單(需要提供者核准才能完成的清單),您也必須擁有 CREATE RECIPIENT
和 USE RECIPIENT
許可權。 請參閱 Unity 目錄許可權和安全性實體物件。
若要建立清單:
登入您的 Azure Databricks 工作區。
在提要欄位中,按兩下 [Marketplace]。
在 Marketplace 頁面右上角,按兩下 [提供者控制台]。
在 [提供者控制台] 頁面 [列表] 索引標籤上,按兩下 [建立清單]。
在 [ 新增清單 ] 頁面上,輸入您的列表資訊。
如需指示,請參閱 列出欄位和選項。
您可以在發佈之前儲存草稿並檢視預覽。 當您按兩下 [ 發佈] 時,清單會立即出現在 Marketplace 中。
列出欄位和選項
本節描述每個 [新增清單 ] 頁面欄位和選項。 它也提供建立有效清單的建議。
清單名稱:每個清單都應該有唯一的名稱,可協助取用者瞭解其提供的內容。
建議:
- 少於 100 個字元。
- 標題大小寫(將主要單字大寫)。
範例
美國人口普查 2022
簡短描述:擴充清單名稱之數據集的簡短信息說明。 此欄位會出現在清單磚和取用者搜尋結果中。
建議:
- 少於 100 個字元。 不能超過160個字元。
- 句子大小寫(只將第一個單字大寫為任何適當的名詞或縮寫)。
範例
2020 年美國人口計數和人口統計的一般資訊
提供者配置檔:您的組織或公司名稱。 從下拉選單中選取 。 您的配置檔是由 Azure Databricks 建立,作為合作夥伴組織核准程式的一部分。
服務條款:鏈接至服務條款的 URL,以適當使用共用數據資產。
服務條款必須可公開存取,而且不需要登入。
公用 Marketplace:所有取用者都可以瀏覽和檢視公用 Databricks Marketplace 中的清單。
私人交換:只有屬於私人交換成員的取用者,由您或其他市集管理員建立,才能瀏覽、檢視及要求清單。 請參閱 在 Databricks Marketplace 中建立和管理私人交換。
您必須從下拉式清單中選取至少一個私人交換。
數據立即可供使用:選取此選項可讓取用者直接從 Marketplace 存取共享數據,而不需要您的核准(但需要接受服務條款)。 從下拉功能表中選擇共用。 此選項通常用於範例和公用數據集。
如果您尚未建立想要包含的共用,請按下拉功能表底部的 [ + 建立新共用 ]。 系統會帶您前往 [ 建立新的共用 ] 對話框。
如果您在這裡選取或建立的共用不包含任何資料或資產,則會出現含有 [新增數據] 按鈕的訊息。 按兩下它以移至目錄總管,您可以在其中將資料表新增至共用。
如需建立共用和將數據表新增至共用的詳細資訊,包括必要的許可權,請參閱 建立和管理差異共用的共用。
需要核准取用者要求:選取此選項以要求您的核准,取用者才能存取共享數據。 如果您需要商務合約,才能將數據產品提供給取用者,請使用此選項。 您必須與 Databricks Marketplace 外部的取用者管理商務合約。 您可以使用取用者電子郵件地址來起始通訊。
您可以在 [提供者控制台>取用者要求] 索引標籤上檢視及處理取用者要求。請參閱在 Databricks Marketplace 中管理數據產品的要求。
類別:選取最多五個類別,取用者可用來篩選清單。 類別也會在清單磚和詳細數據頁面上顯示為標籤。
新增屬性:屬性是選擇性的。 其中包括地理涵蓋範圍、更新頻率、時間範圍、數據源和數據集大小等欄位。 新增屬性可協助取用者深入瞭解您的數據產品。 視需要選取多個屬性。
描述:數據的詳細描述應包含清單中的數據和資產摘要。
支援基本 RTF 格式設定(也就是粗體、斜體、專案符號和編號清單),使用 Markdown 語法。 若要預覽您的內容,請使用 [描述] 字段工具列最右邊的按鈕。
建議:
- 包含優點和使用案例。
- 提供如何使用數據和範例使用案例的簡短指引。
- 包含範例數據集和功能變數名稱。
- 指定架構、數據表和數據行。
- 使用一致的標點符號和語法。
- 在段落之間新增額外的換行符。
- 檢查您的拼字和文法。
- 請勿重複您在 [新增屬性] 下 定義的屬性。
範例
概觀:
2020年,美國人口和住宅普查是美國的官方人口和房屋計數。 它提供了社會和經濟快照。 2020年人口普查於2021年3月6日舉行,是第23次人口普查。
使用案例:
- 根據年齡和性別等人口變數將客戶分組。
- 自定義特定取用者群組的產品供應專案。
此資料集中包含的資訊:
- 母體估計值
- 人口要素(出生、死亡、移民)
- 此數據可以依年齡、性別和種族等特性排序,以及依國家、州和縣位置排序
範例筆記本:D atabricks 強烈建議您共用範例筆記本,以示範如何使用數據。 最多新增十個筆記本。 您必須儲存清單並返回清單,才能上傳範例筆記本。
如需建立筆記本的詳細資訊,請參閱 筆記本範例:範例筆記本 和 Databricks 筆記本簡介。
檔:連結至文件的連結 URL,可協助取用者使用或了解數據集(例如數據集字典)。
隱私策略:連結到您隱私策略的URL。
隱私策略必須可公開存取,而且不需要登入。
使用系統資料表分析取用者活動 (公開預覽)
如果您的 帳戶中已啟用系統數據表 ,您可以使用 Marketplace 系統數據表來分析清單上的取用者活動。 如需詳細資訊,請參閱 Marketplace 系統數據表參考。
下一步
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應