本節提供的資訊可協助解決 Partner Connect 的常見問題。
對一般錯誤進行疑難排解
當您嘗試使用 Partner Connect 進行連線時,可能會看到下列一般錯誤。
嘗試連線至合作夥伴時,顯示錯誤訊息
問題:嘗試使用 Partner Connect 將 Azure Databricks 工作區連線至合作夥伴解決方案時,顯示錯誤,而且您無法建立連線。
原因:
發生此問題的原因可能有多種:
- 如果組織內有多個人嘗試向某個合作夥伴建立帳戶,則只有第一個人會成功。 這是因為合作夥伴可能僅在組織層級提供一些帳戶,並且建立此類帳戶的第一個人也為組織建立帳戶。
- 如果您已具有合作夥伴的帳戶,連線可能仍然會失敗。 這是因為合作夥伴可能會錯誤地嘗試建立重複的帳戶。
解決方案:
執行下列其中一項動作:
- 要求向合作夥伴建立組織帳戶的第一個人將您的電子郵件地址新增至該帳戶。 然後略過 Partner Connect 並直接登入合作夥伴帳戶,以開始使用合作夥伴的解決方案。
- 請嘗試透過 Partner Connect 再次建立連線,但這次,請指定與貴組織網域無關的電子郵件位址,例如個人電子郵件位址。 這可能需要您也將該電子郵件地址作為使用者新增至 Azure Databricks 工作區。
- 略過 Partner Connect,直接使用現有帳戶登入合作夥伴,然後開始使用合作夥伴解決方案。
如果在登入合作夥伴後工作區尚未連線,請遵循適當合作夥伴連線指南中的指示來完成連線。
嘗試登入合作夥伴的帳戶或網站時,會顯示快顯封鎖程式
問題:針對使用 Partner Connect 登入合作夥伴帳戶或網站的合作夥伴解決方案,當您點擊 [登入] 時,Partner Connect 會在網頁瀏覽器中開啟新的分頁,並顯示彈出式封鎖工具。 此快顯封鎖程式可防止您登入合作夥伴的帳戶或網站。
原因:網頁瀏覽器正在封鎖快顯。
解決方案:在網頁瀏覽器中允許合作夥伴網站的彈出視窗。 特定指示因網頁瀏覽器而異。 例如,對於 Google Chrome,請參閱 Google Chrome 說明網站上的在 Chrome 中封鎖或允許快顯。 對於其他網頁瀏覽器,在網際網路中搜尋「如何允許特定網站的快顯?」之類的字詞
權限不足,無法建立合作夥伴連線
問題:當您嘗試建立夥伴連線時,會顯示許可權錯誤,而且您無法建立連線。
原因:此問題可能是因為您不是工作區系統管理員。
解決方案:帳戶管理員或工作區管理員必須將使用者新增至管理員群組。 請參閱 群組。
許可權不足,無法建立與 Unity Catalog 管理的數據的合作夥伴連線
問題:當您嘗試建立夥伴連線時,會顯示下列 遺漏的許可權 錯誤,而且您無法建立連線:
You do not have permission to grant <read|write> access to the workspace default catalog. To enable granting <read|write> access to the default catalog or other catalogs, contact an account admin
原因:此問題可能會因為您沒有工作區預設目錄而發生。 如果未針對具有合作夥伴連線的 Unity 目錄啟用合作夥伴解決方案,您只能連線到預設目錄,而且預設目錄必須是 hive_metastore 或您明確擁有的另一個目錄。
解決方案:執行下列其中一個動作:
要求預設目錄的擁有者建立連線。
要求預設目錄的擁有者將您新增至擁有預設目錄的群組。 請參閱 群組。
請帳戶管理員執行
databricks metastores assign來變更預設目錄。 在下列命令範例中,取代下列預留位置:- 將
<workspace-id>取代為工作區的識別碼。 - 將
<metastore-id>取代為中繼存放區的識別碼。 - 將
<catalog-name>替換為預設目錄的名稱。
databricks metastores assign <workspace-id> <metastore-id> <catalog-name>警告
變更預設目錄可能會中斷相依的現有數據作業。 特別是未指定目錄的數據作業會假設預設目錄。 變更預設值會導致這些作業找不到其參考的資料物件。
如需有關
databricks metastores命令的詳細資訊,請參閱 Databricks CLI 命令。- 將
現有合作夥伴連線無法再存取 Azure Databricks 資料
問題:當您使用 Partner Connect 登入連線到工作區的現有合作夥伴帳戶,且合作夥伴嘗試存取 Azure Databricks 數據時,會顯示錯誤,指出您沒有存取工作區預設目錄的許可權。
原因:如果您的工作區已啟用 Unity 目錄,則可能會發生此問題,因為預設目錄不是 hive_metastore。 如果合作夥伴解決方案不支援使用 Partner Connect 對 Unity 目錄所管理資料的連線,這會中斷您現有的連線。
解決方案:執行下列其中一個動作:
中斷與夥伴的連線,然後重新連線,並指定預設目錄。 請參閱中斷與合作夥伴的連線。 此解決方案需要您擁有預設目錄。
請帳戶管理員運行
hive_metastore,以將預設目錄變更為databricks metastores assign。 在下列命令範例中,取代下列預留位置:- 將
<workspace-id>取代為工作區的識別碼。 - 將
<metastore-id>取代為中繼存放區的識別碼。
databricks metastores assign <workspace-id> <metastore-id> hive_metastore警告
變更預設目錄可能會中斷相依的現有數據作業。 特別是未指定目錄的數據作業會假設預設目錄。 變更預設值會導致這些作業找不到其參考的資料物件。
如需有關
databricks metastores命令的詳細資訊,請參閱 Databricks CLI 命令。- 將
對安全性錯誤進行疑難排解
本節所述的安全性組態可能會導致 Partner Connect 整合失敗。
IP 存取清單
問題:下列警告會出現在 [ 連接到夥伴 ] 對話框中,且您無法建立與合作夥伴的連線:
Partner Connect might not work because IP access list is enabled.
原因:如果您的工作區上已啟用IP存取清單功能,您可能需要將合作夥伴整合新增至allowlist。
解決方案:如需將合作夥伴整合新增至allowlist的步驟,請參閱合作夥伴檔或連絡合作夥伴的支援小組。
- dbt:IP 限制
- Fivetran:Fivetran IP 位址
- Hevo 資料:驗證 IP 位址允許清單
- 十六進位: 允許來自十六進位IP位址的連線
- Hightouch:IP 位址
- Labelbox:要列入允許清單的 Labelbox IP 位址
- Lightup:將 Lightup IP 位址列入允許清單 (建議)
- 預設:連接您的資料
- Qlik Sense:將網域名稱和 IP 位址加入允許清單
- 里維: 里維的白名單 IP
如需有關 IP 存取清單的詳細資訊,請參閱設定工作區的 IP 存取清單。
Azure Private Link
在以下情況下,請遵循本節中的解決方案進行 Azure Private Link 設定以啟用合作夥伴整合:
您為工作區啟用了前端 Private Link 連線
您在 Partner Connect 中遇到下列錯誤
Partner Connect might not work because front-end Private Link is enabled.
解決方案:進行 Private Link 設定以啟用合作夥伴整合。 如需設定 Private Link 設定的步驟,請參閱合作夥伴檔或連絡合作夥伴的支持小組。
- Fivetran:
- Power BI:用於存取 Power BI 的私人端點
如需 Azure Private Link 的詳細資訊,請參閱 Azure Private Link 概念。
個人存取權杖
問題:當您嘗試建立連線時,顯示下列 [缺少權限] 錯誤:
Partner Connect requires personal access tokens to be enabled.
原因:如果您的工作區上停用令牌型驗證,除非您使用 Microsoft Entra ID 令牌或您的 Microsoft Entra ID 帳戶認證向 Power BI 或 Tableau 進行驗證,否則您無法使用 Partner Connect 與合作夥伴解決方案整合。
如需個人存取令牌的詳細資訊,請參閱 監視和撤銷個人存取令牌。