共用方式為


Snowflake

摘要

項目 說明
發行狀態 正式發行
產品 Power BI (語意模型)
Power BI (數據流)
網狀架構 (資料流程 Gen2)
Power Apps (資料流程)
支援的驗證類型 Snowflake (使用者名稱/密碼),Microsoft帳戶(Microsoft Entra ID)
函式參考檔

注意

某些功能可能會存在於一個產品中,但由於部署排程和主機特定功能,而不存在其他功能。

注意

在 Power BI Desktop 的 2025 年 1 月版本中,我們引進了 Snowflake 連接器的新實施,目前已提供預覽。 深入瞭解 此功能

支援的功能

  • Import
  • DirectQuery (Power BI 語意模型)
  • 進階選項
    • 指定要做為角色名稱的文字值
    • 關聯性數據行
    • 線上逾時以秒為單位
    • 以秒為單位的命令逾時
    • Database
    • 原生 SQL 語句

從 Power Query Desktop 連線到 Snowflake 數據倉儲

若要連線到 Snowflake 運算倉儲,請執行下列步驟:

  1. 從 Power BI Desktop 的 [首頁] 功能區選取 [取得數據],從左側的類別選取 [資料庫],選取 [Snowflake],然後選取 [連線]。

    [取得資料] 對話方塊的螢幕擷取畫面,其中顯示 [Snowflake] 資料庫選取項目。

  2. 出現的 Snowflake 視窗中,於 [伺服器] 中輸入 Snowflake 伺服器的名稱,並在 [倉儲] 中輸入 Snowflake 運算倉儲的名稱。

    Snowflake 對話框的螢幕快照,其中顯示已選取 [匯入] 單選按鈕。

  3. 或者,在您想要用來修改連接查詢的任何進階選項中輸入值,例如要做為角色名稱的文字值或命令逾時。 其他資訊:使用進階選項連線

  4. 選取 [確定]。

  5. 若要登入 Snowflake 運算倉儲,請輸入您的使用者名稱和密碼,然後選取 [ 連線]。

    [Snowflake] 認證提示的螢幕擷取畫面,其中顯示 [使用者名稱] 和 [密碼] 欄位。

    注意

    輸入特定 Snowflake 伺服器的使用者名稱和密碼後,Power BI Desktop 會在後續的連線嘗試中使用這些相同的認證。 您可以移至 [檔案>選項] 和 [>資料源設定] 來修改這些認證。 詳細資訊: 變更驗證方法

    如果您想要使用 [Microsoft帳戶] 選項,則必須在 Snowflake 端設定 Snowflake Microsoft Entra ID 整合。 詳細資訊: Power BI SSO to Snowflake - 用戶入門

  6. [導覽器] 中,選取一或多個要匯入和使用於 Power BI Desktop 的專案。 然後選取 [載入] 以載入 Power BI Desktop 中的數據表,或選取 [轉換數據] 以開啟 Power Query 編輯器,您可以在其中篩選和精簡您想要使用的資料集,然後將該精簡數據集載入 Power BI Desktop。

    [導覽器] 的螢幕快照,其中已開啟測試架構資料庫,並已選取 DimProduct 數據表。

  7. 選取 [入] 直接將數據匯入 Power BI,或選取 [DirectQuery],然後選取 [確定]。 詳細資訊: 在 Power BI Desktop 中使用 DirectQuery

    注意

    Microsoft Entra ID 單一登錄 (SSO) 僅支援 DirectQuery。

    [連線設定] 的螢幕快照,其中包含 [匯入] 和 [DirectQuery] 選項。

從 Power Query Online 連線到 Snowflake 資料庫

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

  1. 選取 連接器選取範圍中的 Snowflake 選項。

  2. 出現的 [Snowflake ] 對話框中,輸入伺服器和倉儲的名稱。

    Power Query Online 中的 Snowflake 連線產生器。

  3. 在您想要使用的進階選項中輸入任何值。 如果UI中沒有任何進階選項,您可以在稍後的Power Query 進階編輯器 中編輯這些選項。

  4. 輸入您的連線認證,包括選取或建立新的連線、您想要使用的閘道,以及使用者名稱和密碼。

  5. 選取 [下一步] 以連線到資料庫。

  6. 在 [導覽器] 中,選取您需要的資料,然後選取 [轉換資料] 以轉換 Power Query 編輯器中的資料。

    在線導覽器的螢幕快照,其中已開啟測試架構資料庫,並已選取 DimProduct 數據表。

使用進階選項進行連線

Power Query 提供一組進階選項,您可以視需要新增至查詢。

下表列出您可以在Power Query 中設定的所有進階選項。

進階選項 說明
角色名稱 指定報表透過驅動程式使用的角色。 此角色必須可供使用者使用,否則不會設定任何角色。
包含關聯性資料行 如果勾選,則會包含可能與其他資料表有關聯性的資料行。 如果清除此方塊,您就無法看到這些欄。
線上逾時以秒為單位 指定在傳回錯誤之前,與 Snowflake 服務互動時等待回應的時間長度。 預設值為 0(沒有逾時)。
以秒為單位的命令逾時 指定在傳回錯誤之前等候查詢完成的時間長度。 預設值為 0(沒有逾時)。
Database 指定倉儲中的特定資料庫。 只可在 Power Query Desktop 中使用此選項。
SQL 語句 如需詳細資訊,請移至使用原生資料庫查詢從資料庫匯入資料。 只可在 Power Query Desktop 中使用此選項。

選取所需的進階選項之後,請在 Power Query Desktop 中選取 [確定],或在 Power Query Online 中選取 [下一步],以連線到您的 Snowflake 資料庫。

新的 Snowflake 連接器實作 (預覽)

在 Power BI Desktop 的 2025 年 1 月版本中,我們引進了適用於 Snowflake 連接器的新實作,以增強與 Snowflake 的整合,目前為預覽版提供。 我們鼓勵您試用,提供意見反應

注意

Power BI Desktop 的 64 位版本支援此功能,無法在 32 位版本中運作。

若要存取這項功能,請在Power BI Desktop 中,流覽至 [選項和設定] [檔案] 索引卷標下 >[選項]>[預覽功能]],然後選取複選框以啟用 [使用新的 Snowflake 連接器實作 選項]。 選項開啟之後,所有新建立的連接都會自動使用新的連接器實作。

Power BI Desktop 中新 Snowflake 實作選項的螢幕快照。

您現有的連線保持不變。 您也可以在查詢的 Implementation="2.0" 中新增 Snowflake.Databases 旗標,以試用此功能,如下所示。 此屬性會區分您使用的連接器版本。

Source = Snowflake.Databases("contoso.snowflakecomputing.com", "CONTOSO_WH", [Implementation="2.0"])

注意

如果您使用內部部署數據閘道來重新整理語意模型,請確定您有 2025 年 1 月版本或更新版本才能使用此功能。

為了協助診斷任何潛在問題,您可以在 Mashup 記錄中找到 ImplementationDriverType 詳細數據。 例如:

{"Start":"2024-11-02T00:14:02.7968686Z","Action":"Engine/Module/Snowflake/IO/Snowflake/Implementation","ResourceKind":"Snowflake","ResourcePath":"powerbi.snowflakecomputing.com ;DEMO_WH","HostProcessId":"29200","Implementation":"2.0","DriverType":"ADBC","ProductVersion":"2.139.0.0 (Main)+eda56ecd858054173a4d11db9c63a6da5cf92a99","ActivityId":"106f16b6-cfbb-4853-9f20-ed45486486d2","Process":"Microsoft.Mashup.Container.NetFX45","Pid":38560,"Tid":1,"Duration":"00:00:00.0000291"}

疑難排解

錯誤:SQL 編譯錯誤:物件不存在,或無法執行作業

當系統找不到指定的物件時,就會發生錯誤。 此錯誤通常是因為用戶的資料庫名稱設定為預設資料庫而無效。

請確定屬性DEFAULT_NAMESPACE使用有效的預設資料庫名稱: DESC USERusername

若要更新預設資料庫名稱: alter userusername set DEFAULT_NAMESPACE=<database name>.<schema name>。 如需詳細資訊,請參閱 Snowflake 檔 - https://docs.snowflake.com/en/sql-reference/sql/alter-user

限制和已知問題

資料庫名稱中的連字元

如果資料庫名稱中有連字元,您可能會遇到 ODBC: ERROR[42000] SQL compilation error。 此問題已在 2024 年 9 月版本中解決。

布爾數據類型的交叉分析篩選器視覺效果

布爾數據類型的交叉分析篩選器視覺效果在 2024 年 6 月版本中無法如預期般運作。 此非功能是已知問題。 作為暫時解決方案,使用者可以流覽至:[傳輸 -> 數據類型 -> 文字],將報表中的布爾數據類型轉換成文字。 2024 年 10 月發行的版本中提供修正程式。

其他資訊