Denodo

備註

Denodo 擁有並提供此連接器。

總結

Property Value
連接器 德諾多圖示 德諾多
產品 Power BI(語意模型)
Power Query Online
發行狀態 正式可用
類別 Database
驗證類型 基本
Microsoft Entra ID
Windows 作業系統
資料來源類型 DenodoForPowerBI
函數參考文檔 Denodo.Contents
支援連結 支援

備註

某些功能可能只存在於某個產品,但其他產品則不存在,這是因為部署排程和主機專屬功能。

先決條件

要使用此連接器,請安裝並設定 Denodo 平台,並開始其服務。 如果您的連線使用 ODBC 資料來源名稱(DSN),您必須在 ODBC 資料來源管理員中正確設定該連線。

支援的功能

  • 進口
  • DirectQuery (Power BI 語意模型)

Parameters

進入點:Denodo.Contents

所需參數數量: 1

Denodo 連接器讓你能從 PowerBI 連接到 Denodo 的 VDP 伺服器

Parameter 顯示名稱 Required 類型 說明 允許的值 範例值 可空值 已宣告的允許值
DSN DSN 或連接串 Yes 收發簡訊 ODBC 資料來源名稱或連線字串 「DSN:Power BI - Denodo / 連線字串:SERVER=localhost;DATABASE=sakila;PORT=9999;" false
偵錯 啟用除錯模式(預設:false) No 可為 Null 的布林值 邏輯值:真或假 "false"; "true" true ["false", "true"]
options 選項 No 可以為空的記錄 Denodo 連接器低階連線組態選項 [DenodoDatabase="mydb",DenodoView="myview"] true

從 Power Query Desktop 連線

若要進行連線,請執行下列步驟:

  1. 要連接資料,請從 Home 功能區選擇 「取得資料」。 在 資料庫 區塊中,選擇 Denodo。

    Power Query Desktop 中 Denodo 連接器的截圖。

  2. 有兩種方式可以連線到您選擇的數據來源:

    • DSN(ODBC 資料來源名稱)
    • 連線字串

    在 Denodo 連接器 對話框的 DSN 或 Connection String 區塊中,根據你偏好的連線類型,提供資料來源名稱或連線字串。

    Denodo 連接器對話框的截圖。

    當你建立相容 Denodo 的連接字串時,必須省略 Driver 欄位,因為這個欄位在連接時是由連接器本身透明設定的。

    連接字串必須包含三個必填參數:SERVER、、 PORTDATABASE和 。

    SERVER=<Server name>;PORT=<Port number>;DATABASE=<Database name>
    

    此外,它還可能包含一個可選參數: SSLmode。

    SERVER=<Server name>;PORT=<Port number>;DATABASE=<Database name>;SSLmode=<SSL mode>
    

    省略驗證參數。 認證是在後續步驟中設定。

    備註

    撰寫連接字串時,請注意以下要求:

    • 連接串必須保持參數的正確順序:SERVER、 PORTDATABASESSLMode。
    • 這些參數的名稱必須一律以相同的方式撰寫。 例如,如果你選擇用大寫書寫它們的內容,那麼它們必須始終用大寫。 如果你決定把單字的第一個字母大寫,剩下的字母小寫,那麼就必須一直保持這樣的寫法。

    否則,Power BI 可能無法辨識報告中不同的 Denodo 資料集屬於同一 Denodo 資料來源。 因此,Power BI 可能會為每個不同的對象請求單獨的認證憑證。

  3. 第二個區段 [啟用偵錯模式] 是選擇性字段,可讓您將追蹤資訊新增至記錄檔。 Power BI Desktop 會在應用程式中啟用追蹤功能時,透過選項選單中的診斷標籤產生這些檔案。 啟用除錯模式的預設值是 false,在這種情況下,Denodo Power BI 自訂連接器的日誌檔中沒有追蹤資料。

  4. 第三個區段 Native Query 是一個選擇性欄位,您可以在其中輸入查詢。 如果你使用這個查詢欄位,資料集是查詢的結果,而不是一個表格或一組表格。

    你可以寫一個查詢,只查詢該資料來源所關聯的其中一個資料庫。

    SELECT title, name FROM film JOIN language ON film.language_id = language.language_id WHERE film.language_id = 1
    

    如果你想寫一個查詢多個資料庫的查詢,必須在查詢中指定擁有每個資料表的資料庫。

    SELECT i_item_sk, country FROM sakila.country, ewd.item
    
  5. Denodo 連接器的最後一節是數據連線模式,您可以在匯入模式或 DirectQuery 模式之間進行選擇。

  6. 完成後,選擇 確定。

  7. 現在你被要求驗證。 Denodo Power BI 自訂連接器支援三種認證類型:

    • Windows:當你選擇使用 Windows 認證時,Power BI Desktop 會透過 Kerberos 認證連接到 Virtual DataPort。

      Power BI Desktop 中 Denodo Windows 認證的截圖。

      在此案例中:

      • 必須在 Virtual DataPort 伺服器中啟用 Kerberos 驗證。

      • 數據源所連接的 Denodo Virtual DataPort 資料庫必須設定為 ODBC/ADO.net 驗證類型 設定為 Kerberos 的選項。

      • Power BI Desktop 必須在 Windows 網域中執行,因為 ODBC 驅動程式會向作業系統的票證快取請求 Kerberos 票證。

      • 請確定 DSN 組態的 [ 進階選項 ] 頁面包含使用 Kerberos 作為驗證方法所需的所有組態。

        Denodo DSN 設定中進階選項頁面的截圖。

    • 基本:這種認證類型會透過你的虛擬資料埠伺服器憑證,將 Power BI Desktop 連接到你的虛擬資料埠資料。

      Power BI Desktop 中 Denodo 基本認證的截圖。

      備註

      舊版的 Denodo 連接器需要你跳脫特定密碼字元。 自 1.0.8 版本起,此規則不再必要。

    • 組織帳號:此認證類型透過特定的 Microsoft 憑證將 Power BI Desktop 與您的虛擬資料埠資料連結。 這個選項是針對 Microsoft Entra ID 的 OAuth 專用版本。

      Denodo 組織帳號在 Power BI Desktop 的驗證截圖。

      當你選擇 登入時,會開啟一個登入分頁。 輸入 Microsoft 憑證以供此資料來源使用。

      Denodo 組織帳號登入畫面的截圖。

      登入後,選擇 連接。 接著你會看到導航畫面,顯示桌位選擇。

      Denodo 組織帳號連結截圖。

      備註

      要存取 Virtual DataPort 資料庫,必須在 Denodo 建立一個使用者。 使用者的名稱必須與使用者登入組織帳號時 Power BI 中使用的電子郵件相同。 在 Denodo 建立使用者時,必須選擇 EXTERNAL 作為認證類型。 Denodo 資料庫中賦予此使用者的權限決定了哪些資料庫可以從 Power BI Desktop 存取。

  8. 完成後,選擇 連接。

  9. 在 Navigator 裡,選擇你想要的資料庫和資料,然後選擇 載入。 或者,如果你要修改輸入資料,請選擇 「轉換資料」。

    Denodo 導航員的截圖。

從 Power Query Online 連線

要連接 Denodo 資料:

  1. 請從Power Query連接至資料來源頁面選擇Denodo。

  2. 在 Denodo 對話框中,輸入你的 Denodo 實例的 DSN 或連線字串 。 對於 連接字串,你必須指定 SERVER、PORT 和 DATABASE 參數。

  3. 選擇是否啟動除錯模式。

  4. 請包含你本地資料閘道器的名稱。

    備註

    需要本地資料閘道,因為 Denodo 連接器使用必須安裝在閘道器機器上的 ODBC 驅動程式。

  5. 選擇認證類型,並提供您的憑證:

    • 基本:輸入你的 Denodo 用戶名和密碼。
    • 組織帳號:使用您的組織帳號登入。
  6. 選取 [下一步] 繼續進行。

  7. 在 Choose data 頁面中,選擇你想載入的視圖或資料表,然後選擇 Transform data 以Power Query 編輯器轉換資料。

其他資訊

從 Power BI 服務連接到 ODBC 資料來源

此連線方式使用本地資料閘道器。 執行下列步驟:

  1. 配置本地資料閘道(企業閘道)。 此閘道器提供本地資料(您的 Power BI Desktop 應用程式中的資料,而非雲端)與 Power BI 服務之間的快速且安全資料傳輸。

  2. 登入並註冊您的閘道。 在內部部署數據閘道應用程式中,選取 [ 狀態 ] 索引標籤,確認您的閘道已上線且可供使用。

    本地資料閘道器截圖,狀態標籤開啟。

  3. 在 Power BI 服務的 「資料來源設定」中,建立 Denodo Power BI 自訂連接器的資料來源。

    這是你新增 Denodo 資料來源的資料庫設定對話框截圖。

    要建立資料來源,你必須指定連接你選擇的資料來源的方式:

    • DSN
    • 連線字串

    備註

    我們推薦DSN。 它提供許多設定選項,使用連線字串時可能無法直接使用。

    您也必須指定驗證模式。 可用的驗證方法如下:

    • Windows:Power BI 服務透過 Kerberos 認證連接到 Virtual DataPort。

      • 在 [數據源設定] 中,輸入使用者名稱和密碼以建立 Kerberos 票證。
      • 在虛擬資料埠伺服器中,啟用 Kerberos 認證。
      • 數據源所連接的 Denodo Virtual DataPort 資料庫必須設定為 ODBC/ADO.net 驗證類型 設定為 Kerberos 的選項。
      • 請確定 DSN 組態的 [ 進階選項 ] 頁面包含使用 Kerberos 作為驗證方法所需的所有組態。

      Denodo DSN 設定中進階選項頁面的截圖。

    • 基本說明:你可以在 Power BI 服務中建立資料來源,透過虛擬 DataPort 伺服器的憑證連接到你的虛擬 DataPort 資料。

    • Oauth:你可以在 Power BI 服務中建立資料來源,透過 Microsoft 憑證連接到你的虛擬 DataPort 資料。

      備註

      要存取虛擬資料埠資料庫,您必須在 Denodo 建立一個使用者,其名稱與 Power BI 登入組織帳號時使用的電子郵件相同。 在 Denodo 建立使用者時,必須選擇 EXTERNAL 作為認證類型。 Denodo 資料庫中賦予此使用者的權限決定了哪些資料庫可以從 Power BI 存取。

  4. 如果你使用 Windows 驗證,在資料來源的 進階設定 中,你可以啟用單一登入(SSO),讓報表檢視者使用自己的身分查詢 Denodo。 Denodo 連接器支援兩種 SSO 路徑:Kerberos 與 Microsoft Entra ID。

    Kerberos SSO:

    這是你用 Kerberos 設定 Denodo SSO 的資料來源設定對話框截圖。

    啟用 Kerberos SSO 有兩種選項: 透過 Kerberos 使用 SSO 進行 DirectQuery 查詢,以及 使用 SSO 透過 Kerberos 進行 DirectQuery 與匯入查詢。 如果你是用 DirectQuery 來處理報告,這兩種方式都會使用登入 Power BI 服務的使用者的 SSO 憑證。 如果你是根據匯入來處理報告,前者會使用資料來源頁面(使用者名稱 和 密碼 欄位)輸入的憑證,後者則使用語意模型擁有者的憑證。

    若要使用以 Kerberos 為基礎的單一登入(SSO),您必須考量特定的先決條件與注意事項。 其中一些要求包括:

    • 你必須為執行 Power BI 閘道的 Windows 使用者啟用 Kerberos 受限委派。 此外,請依照 Microsoft 提供的指示,配置本地 Active Directory 與 Microsoft Entra ID 環境。

      預設情況下,Power BI 閘道器在執行 SSO 驗證操作時會傳送使用者主體名稱(UPN)。 檢視你在 Denodo Kerberos 認證中用作登入識別碼的屬性。 如果與 userPrincipalName 不同,請調整閘道設定使其一致。

    • Power BI 閘道設定檔位於 Microsoft.PowerBI.DataMovement.Pipeline.GatewayCore.dll.config\Program Files\On-premises data gateway。 此檔案有兩個屬性,ADUserNameLookupProperty 和 ADUserNameReplacementProperty,讓閘道器能在執行時執行本地Microsoft Entra ID查詢。 ADUserNameLookupProperty 指定閘道器會將來自 Microsoft Entra ID 的使用者主體名稱對應到本機 Active Directory 的哪個屬性。 在此情境下, ADUserNameLookupProperty 應該是 userPrincipalName。 當找到使用者時,該 ADUserNameReplacementProperty 值會顯示驗證冒充使用者的屬性(你在 Denodo 中用作登入識別碼的屬性)。

      此組態檔案的變更會在閘道層級生效,並影響任何透過 Power BI 閘道進行 SSO 驗證的來源。

    Microsoft Entra ID SSO:

    當您為 Denodo 連接器啟用 Microsoft Entra ID SSO 時,DirectQuery 語意模型的檢視者查詢 Denodo 時,會使用自己的 Microsoft Entra ID 身分。 Entra ID SSO 移除了 Kerberos SSO 所需的 內部部署的 Active Directory 與 Kerberos 受限委派依賴。

    Entra ID SSO 具備以下先決條件:

    • Power BI 租戶管理員在租戶設定中啟用 Denodo SSO 和 用於資料閘道的 Microsoft Entra ID SSO。
    • 本地資料閘道執行一個支援 Entra ID SSO 的版本。
    • Denodo 伺服器運行一個支援 Microsoft Entra ID 令牌驗證的版本。

     啟用 Denodo SSO 和 Microsoft Entra ID 資料閘道 SSO 後,Power BI 租戶管理員設定的截圖。

    在租戶啟用 Denodo SSO 後,資料來源頁面的 Single sign-on選項中包含一個 Use SSO via Azure AD for DirectQuery 查詢勾選框。 選取此核取方塊,即可為任何繫結至資料連線的 DirectQuery 語意模型啟用 Entra ID SSO。

     Denodo 資料來源設定截圖,並勾選了「透過 AD 使用 Azure SSO 進行 DirectQuery 查詢」勾選框。

    Entra ID SSO 僅適用於 DirectQuery 語意模型。 匯入模型會回答匯入資料中的查詢,且不會將使用者身份轉發給資料來源。

  5. 建立 Denodo 連接器的資料來源後,你可以重新整理 Power BI 報告。 要發布 powerbi.com 上的報告:

    • 在 Power BI Desktop 中開啟報表。
    • 請選取 檔案>發佈>至 Power BI。
    • 將報表儲存在電腦上。
    • 選取您要發佈的工作區。

進階設定

ConnectionTimeout 參數的使用

如果您想要控制在放棄嘗試與伺服器建立連線之前要等候的時間,您可以使用 ConnectionTimeout 參數。

此參數僅在進階編輯器中使用。 若要這樣做,必須在記錄選項中加入 ConnectionTimeout 參數,將 duration 類型的值與其產生關聯。

本文中可以進一步了解這種duration類型。

進階編輯器的截圖,示範如何使用 ConnectionTimeout 參數。

查詢逾時參數的使用

如果您想要控制在放棄嘗試執行查詢之前要等候的時間長度,您可以使用 QueryTimeout 參數。

此參數僅在進階編輯器中使用。 若要這樣做,必須在記錄選項中加入 QueryTimeout 參數,將 number 類型的值與其產生關聯。 此數值以毫秒表示(例如, 10000 等於10秒)。

進階編輯器的截圖,示範如何使用 QueryTimeout 參數。

UserAgent 參數的使用

如果您想要指定用戶端應用程式的名稱,可以使用 UserAgent 參數。

此參數僅在進階編輯器中使用。 若要這樣做,必須在記錄選項中加入 UserAgent 參數,並將一個 text 類型的值與之關聯。

進階編輯器的截圖,示範如何使用 UserAgent 參數。

壓縮參數的使用

我們建議您在用戶端應用程式與 Denodo 伺服器透過 WAN 連接時啟用此設定。 在這些情況下,當用戶端應用程式讀取中量或大量資料時,您可以預期有顯著的效能提升。

此參數僅在進階編輯器中使用。 若要這樣做,必須在記錄選項中新增 Compression 參數,並將類型為 number (0 或 1)的值關聯起來。

進階編輯器的截圖,示範如何使用壓縮參數。

故障排除

如果將 Denodo 視圖作為資料來源匯入 Power BI,與其他視圖有超過 42 個關聯,當您嘗試存取資料轉換視窗時,Power BI 可能會顯示以下錯誤:

Preview.Error: The type of the current preview value is too complex to display.

此錯誤源自 Power Query 平台的限制。 要繞過這個問題,可以在資料轉換視窗中選擇失敗的資料來源(查詢),然後選擇 檢視>進階編輯器。 接著用 M 語言編輯資料來源表達式,並在函式呼叫的options參數中加入以下屬性Denodo.Contents:

CreateNavigationProperties=false

因此,您的通話看起來會類似:

  Source = Denodo.Contents(<dsn>, null, [CreateNavigationProperties=false])

此屬性指示 Power BI 不要從此資料來源中 Denodo 視圖所登記的關聯中產生導航屬性。 如果你需要在 Power BI 資料模型中保留這些關聯,必須在之後手動註冊。