對 Partner Connect 進行疑難排解
本節提供的資訊可協助解決 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
原因:此問題可能發生,因為您不擁有工作區的預設 catalog。 如果合作夥伴解決方案未透過 Partner Connect 啟用 Unity Catalog,您只能連接到預設 catalog,並且預設 catalog 必須是 hive_metastore
或您明確擁有的另一個 catalog。
解決方案:執行下列其中一個動作:
要求預設 catalog 的擁有者建立連線。
要求預設 catalog 的擁有者將您新增至擁有預設 catalog的群組。 請參閱管理群組。
要求帳戶管理員執行
databricks metastores assign
來變更預設 catalog。 在下列命令範例中,取代下列預留位置:- 將
<workspace-id>
取代為工作區的識別碼。 - 將
<metastore-id>
取代為中繼存放區的識別碼。 - 將
<catalog-name>
取代為預設 catalog的名稱。
databricks metastores assign <workspace-id> <metastore-id> <catalog-name>
警告
變更預設 catalog 可能會中斷依賴於該預設的現有數據作業。 特別是未指定 catalog 的資料作業會假設預設 catalog。 變更預設值會導致這些作業找不到其參考的資料物件。
如需有關
databricks metastores
命令的詳細資訊,請參閱 Databricks CLI 命令。- 將
現有合作夥伴連線無法再存取 Azure Databricks 資料
問題:當您使用 Partner Connect 登入連線到工作區的現有合作夥伴帳戶,而合作夥伴嘗試存取 Azure Databricks 數據時,會顯示錯誤,指出您沒有存取工作區預設 catalog的許可權。
原因:如果您的工作區啟用了 Unity Catalog,則可能會發生此問題,因為預設的 catalog 並未 hive_metastore
。 如果合作夥伴解決方案不支援透過 Partner Connect 與 Unity Catalog 管理的數據 connections 互動,這將會中斷您現有的連線。
解決方案:執行下列其中一個動作:
中斷與夥伴的連線,然後重新連線,並指定預設 catalog。 請參閱中斷與合作夥伴的連線。 此解決方案需要您擁有預設 catalog。
要求帳戶管理員執行
databricks metastores assign
,將預設 catalog 變更為hive_metastore
。 在下列命令範例中,取代下列預留位置:- 將
<workspace-id>
取代為工作區的識別碼。 - 將
<metastore-id>
取代為中繼存放區的識別碼。
databricks metastores assign <workspace-id> <metastore-id> hive_metastore
警告
變更預設值 catalog 可能會中斷依賴它的現有數據作業。 特別是未指定 catalog 的資料作業會假設預設 catalog。 變更預設值會導致這些作業找不到其參考的資料物件。
如需有關
databricks metastores
命令的詳細資訊,請參閱 Databricks CLI 命令。- 將
對安全性錯誤進行疑難排解
本節所述的安全性組態可能會導致 Partner Connect 整合失敗。
IP 存取清單
問題:[連線至合作夥伴] 對話方塊中出現下列警告,並且您無法建立與合作夥伴的連線:
Partner Connect might not work because IP access list is enabled.
原因:如果您的工作區上已啟用IP存取 list 功能,您可能必須將合作夥伴整合新增至允許清單。
解決方案:如需將合作夥伴整合新增至允許清單的步驟,請參閱合作夥伴文件或連絡合作夥伴的支援小組。
- dbt:IP 限制
- Fivetran:Fivetran IP 位址
- Hevo 資料:驗證 IP 位址允許清單
- 十六進位:允許來源自十六進位的IP位址connections
- Hightouch:IP 位址
- Labelbox:要列入允許清單的 Labelbox IP 位址
- Lightup:將 Lightup IP 位址列入允許清單 (建議)
- 預設:連接您的資料
- Qlik Sense:將網域名稱和 IP 位址加入允許清單
- Rivery:Rivery 的允許清單 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 後端和前端 connections。
個人存取權杖
問題:當您嘗試建立連線時,顯示下列 [缺少權限] 錯誤:
Partner Connect requires personal access tokens to be enabled.
原因:如果您的工作區上停用了令牌型驗證,則除非您使用 Microsoft Entra ID 令牌或 Microsoft Entra ID 帳戶,否則無法使用 Partner Connect 與合作夥伴解決方案進行整合,需要使用 credentials 向 Power BI 或 Tableau 進行驗證。
如需個人存取權杖的詳細資訊,請參閱 監視和 revoke 個人存取權杖。