共用方式為

IBM Db2 資料庫

  • 發行項

摘要

項目 說明
發行狀態 正式發行
產品 Excel
Power BI （語意模型）
Power BI （數據流）
網狀架構 （資料流 Gen2）
Power Apps （數據流）
Dynamics 365 Customer Insights
支援的驗證類型 基本
Database
Windows
函式參考檔 DB2.Database

注意

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

必要條件

根據預設，IBM Db2 資料庫連接器會使用 Microsoft 驅動程式來連線到您的數據。 如果您選擇在 Power Query Desktop 的進階選項中使用 IBM 驅動程式，您必須先在用來連線到數據的電腦上安裝 IBM Db2 driver for .NET。 此驅動程式的名稱會不時變更，因此請務必安裝與 .NET 搭配運作的 IBM Db2 驅動程式。 如需如何下載、安裝及設定適用於 .NET 的 IBM Db2 驅動程式的指示，請移至 下載初始版本 11.5 用戶端和驅動程式。 詳細資訊： 驅動程式限制， 確定已安裝IBM Db2 驅動程式

支援的功能

  • Import
  • DirectQuery （Power BI 語意模型）
  • 進階選項
    • 驅動程序 （IBM 或 Microsoft）
    • 以分鐘為單位的命令逾時
    • 套件集合
    • SQL statement
    • 包含關聯性資料行
    • 使用完整階層架構巡覽

從 Power Query Desktop 連線 至 IBM Db2 資料庫

若要進行連線，請執行下列步驟：

  1. 從 [取得數據] 中選取 [IBM Db2 資料庫] 選項。

  2. 指定要在 Server 中連線到的 IBM Db2 伺服器。 如果需要埠，請使用ServerName：Port 格式指定埠，其中 Port 是埠號碼。 此外，輸入您要在資料庫中存取的 IBM Db2 資料庫。 在這裡範例中，伺服器名稱和連接埠是 TestIBMDb2server.contoso.com:4000 ，而要存取的 IBM Db2 資料庫是 NORTHWD2。

    Enter IBM Db2 database connection.

  3. 如果您要從 Power BI Desktop 連線，請選取 [匯入] 或 [DirectQuery 數據連線模式]。 這些範例步驟的其餘部分會使用匯入數據連線模式。 若要深入瞭解 DirectQuery，請移至 在 Power BI Desktop 中使用 DirectQuery。

    注意

    根據預設，IBM Db2 資料庫對話框會在登入期間使用 Microsoft 驅動程式。 如果您想要使用 IBM 驅動程式，請開啟 [進階選項 ]，然後選取 [IBM]。 詳細資訊：使用進階選項 連線

    如果您選取 DirectQuery 作為數據連線模式， 則會停用進階選項中的 SQL 語句 。 DirectQuery 目前不支援 IBM Db2 連接器原生資料庫查詢頂端的查詢下推。

  4. 選取 [確定]。

  5. 如果這是您第一次連線到此 IBM Db2 資料庫，請選取要使用的驗證類型、輸入您的認證，然後選取 [連線]。 如需驗證的詳細資訊，請移至 使用數據源進行驗證。

    Enter your IBM Db2 database credentials.

    根據預設，Power Query 會嘗試使用加密連線來連線到 IBM Db2 資料庫。 如果 Power Query 無法使用加密連線進行連線，則會出現 [無法連線] 對話方塊。 若要使用未加密的連線進行連線，請選取 [ 確定]。

    Unable to connect dialog box

  6. 在 [導覽器] 中，選取您需要的數據，然後選取 [載入 ] 以載入資料或 [轉換數據 ] 來轉換數據。

    Select the data you require from the database

從 Power Query Online 連線 IBM Db2 資料庫

若要進行連線，請執行下列步驟：

  1. 在 [Power Query - 連線 至數據源] 頁面中，選取 [IBM Db2 資料庫] 選項。

  2. 指定要在 Server 中連線到的 IBM Db2 伺服器。 如果需要埠，請使用ServerName：Port 格式指定埠，其中 Port 是埠號碼。 此外，輸入您要在資料庫中存取的 IBM Db2 資料庫。 在此範例中，伺服器名稱和埠為 TestIBMDb2server.contoso.com:4000 ，且正在存取的IBM Db2 資料庫為 NORTHWD2

  3. 選取內部部署數據閘道的名稱。

    注意

    您必須選取此連接器的內部部署數據閘道，不論 IBM Db2 資料庫位於您的局域網路上還是在線。

  4. 如果這是您第一次連線到此 IBM Db2 資料庫，請在 [驗證類型] 中選取連線的認證類型。 如果您打算使用 IBM Db2 資料庫中建立的帳戶，而不是 Windows 驗證，請選擇 [基本]。

  5. 輸入您的認證。

  6. 如果您想要使用加密連線，請選取 [使用加密 連線 ion]，或者如果您想要使用未加密的連線，請清除選項。

    Enter IBM Db2 database online connection.

  7. 選取下一步以繼續。

  8. 在 [導覽器] 中，選取您需要的數據，然後選取 [轉換數據] 以轉換 Power Query 編輯器 中的數據。

    Select the data you want to transform in the Navigator

使用進階選項 連線

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

Advanced options included in the IBM Db2 database connection dialog box.

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

進階選項 描述
驅動程式 判斷用來連線到IBM Db2資料庫的驅動程式。 選擇是 IBM 和 Windows （預設值）。 如果您選取 IBM 驅動程式，您必須先確定電腦上已安裝適用於 .NET 的 IBM Db2 驅動程式。 此選項僅適用於Power Query Desktop。 詳細資訊： 確定已安裝IBM Db2 驅動程式
以分鐘為單位的命令逾時 如果您的連線持續超過 10 分鐘（預設逾時），您可以在幾分鐘內輸入另一個值，讓連線保持開啟時間更長。
套件集合 指定要尋找封裝的位置。 封裝是 Db2 處理 SQL 語句時所使用的控制結構，並在必要時自動建立。 根據預設，此選項會使用 值 NULLID。 只有在使用 Microsoft 驅動程式時才能使用。 詳細資訊： DB2 套件：概念、範例和常見問題
SQL statement 如需詳細資訊，請移至 使用原生資料庫查詢從資料庫匯入數據。
包含關聯性資料行 如果核取，則包含可能與其他數據表有關聯性的數據行。 如果清除此方塊，您就不會看到這些數據行。
使用完整階層架構巡覽 如果核取，導覽器會顯示您要連線之資料庫中數據表的完整階層。 如果清除，導覽器只會顯示其數據行和數據列包含數據的數據表。

選取所需的進階選項之後，請在Power Query Desktop或Power Query Online 中選取 [確定]，以聯機到 IBM Db2 資料庫。

問題和限制

驅動程式限制

Microsoft 驅動程式與 Microsoft Host Integration Server 中使用的驅動程式相同，稱為“ADO.NET Provider for DB2”。 IBM 驅動程式是與 .NET 搭配運作的 IBM Db/2 驅動程式。 此驅動程式的名稱會不時變更，因此請確定它是與 .NET 搭配運作的驅動程式，這與使用 OLE/DB、ODBC 或 JDBC 的 IBM Db2 驅動程式不同。

如果您使用 Power Query Desktop，您可以選擇使用 Microsoft 驅動程式 （預設值） 或 IBM 驅動程式。 目前，Power Query Online 只會使用 Microsoft 驅動程式。 每個驅動程式都有其限制。

  • Microsoft 驅動程式
    • 不支援傳輸層安全性 （TLS）
  • IBM 驅動程式
    • 使用適用於 .NET 的 IBM Db2 驅動程式時，IBM Db2 資料庫連接器不適用於大型主機或 IBM i 系統
    • 不支援 DirectQuery

Microsoft 提供 Microsoft 驅動程序的支援，但不支援 IBM 驅動程式。 不過，如果您的 IT 部門已在您的電腦上設定並設定，IT 部門應該知道如何針對 IBM 驅動程式進行疑難解答。

DirectQuery 中不支援原生查詢

當您在Power Query Desktop 中選取 DirectQuery 作為數據連線模式時，會停用進階選項中的 [SQL 語句] 文字框。 因為 Power Query IBM Db2 連接器目前不支援在原生資料庫查詢上向下推入查詢，所以已停用。

疑難排解

確定已安裝IBM Db2 驅動程式

如果您選擇使用適用於 Power Query Desktop 的 IBM Db2 驅動程式，您必須先在電腦上安裝、安裝及設定驅動程式。 為了確保 IBM Db2 驅動程式已安裝：

  1. 在您的電腦上開啟 Windows PowerShell。

  2. 輸入下列命令：

    [System.Data.Common.DbProviderFactories]::GetFactoryClasses() | ogv

  3. 在開啟的對話框中，您應該會在 InvariantName 數據行中看到下列名稱：

    IBM.Data.DB2

如果此名稱位於 InvariantName 資料行中，則 IBM Db2 驅動程式已安裝並正確設定。

SQLCODE -805 和 SQLCODE -551 錯誤碼

嘗試連線到 IBM Db2 資料庫時，您有時會遇到常見的 SQLCODE -805 錯誤，這表示套件在 或其他集合中 NULLID 找不到（在 Power Query Package 連線 組態中指定）。 您也可能遇到常見的 SQLCODE -551 錯誤，這表示您無法建立套件，因為您缺少套件系結授權單位。

一般而言，SQLCODE -805 後面接著 SQLCODE -551，但您只會看到第二個例外狀況。 事實上，問題相同。 您缺少將套件系結至 NULLID 或指定集合的許可權。

通常，大部分的 IBM Db2 系統管理員不會將套件授權單位提供給終端使用者，特別是在 IBM z/OS（大型主機）或 IBM i （AS/400） 環境中。 Linux、Unix 或 Windows 上的 Db2 在使用者帳戶中預設具有系結許可權，這會在使用者自己的集合中建立MSCS001 （Cursor Stability） 套件（name = 使用者登入名稱）。

如果您沒有繫結套件許可權，您必須向 Db2 系統管理員要求套件系結授權單位。 使用此套件系結授權單位，連線到資料庫並擷取數據，以自動建立封裝。 之後，系統管理員可以撤銷封裝系結授權單位。 此外，之後，系統管理員可以「將」套件「系結」至其他集合，以增加並行性，以更符合套件系結所在位置的內部標準等等。

聯機到 IBM Db2 for z/OS 時，Db2 系統管理員可以執行下列步驟。

  1. 使用下列其中一個命令，授與授權單位，將新套件系結至使用者：

    • 授與系統上的BINDADD以 <authorization_name>
    • 授與PACKADM on <collection_name> 以 <authorization_name>

  2. 使用 Power Query 連線到 IBM Db2 資料庫，並擷取架構、數據表和檢視清單。 Power Query IBM Db2 資料庫連接器會自動建立套件 NULLID。MSCS001，然後將套件上的執行授與公用。

  3. 使用下列其中一個命令撤銷將新套件系結至使用者的授權：

    • REVOKE BINDADD from <authorization_name>
    • REVOKE PACKADM ON collection_name <from authorization_name> <>

聯機到 IBM Db2 for Linux、Unix 或 Windows 時，Db2 系統管理員可以執行下列步驟。

  1. 將資料庫上的BINDADD授與使用者 <authorization_name>。

  2. 使用 Power Query 連線到 IBM Db2 資料庫，並擷取架構、數據表和檢視清單。 Power Query IBM Db2 連接器會自動建立套件 NULLID。MSCS001，然後將套件上的執行授與公用。

  3. 從使用者 <authorization_name>撤銷資料庫上的BINDADD。

  4. GRANT EXECUTE ON PACKAGE collection.package> <TO USER <authorization_name。>

聯機到IBM Db2 for i時，Db2 系統管理員可以執行下列步驟。

  1. WRKOBJ QSYS/CRTSQLPKG。 輸入 「2」 以變更物件授權單位。

  2. 將授權單位從 *EXCLUDE 變更為 PUBLIC 或 <authorization_name>。

  3. 之後，將授權單位變更回 *EXCLUDE。

SQLCODE -360 錯誤碼

嘗試連線到 IBM Db2 資料庫時，您可能會遇到下列錯誤：

Microsoft Db2 Client: The host resource could not be found. Check that the Initial Catalog value matches the host resource name. SQLSTATE=HY000 SQLCODE=-360

這個錯誤訊息表示您未將正確的值放入資料庫名稱中。

SQLCODE -1336 錯誤碼

The specified host could not be found.

請仔細檢查名稱，並確認主機可連線。 例如，在命令提示字元中使用 ping 來嘗試連線到伺服器，並確保 IP 位址正確，或使用 telnet 與伺服器通訊。

SQLCODE -1037 錯誤碼

Host is reachable, but is not responding on the specified port.

埠是在伺服器名稱結尾指定，並以冒號分隔。 如果省略，則會使用預設值 50000。

若要尋找適用於Linux、Unix和 Windows 的埠 Db2，請執行下列命令：

db2 get dbm cfg | findstr SVCENAME

查看輸出中是否有 SVCENAME 的專案（以及 TLS 加密連線的SSL_SVCENAME）。 如果此值為數位，即為埠。 否則，會交叉參考值與系統的「服務」數據表。 您通常可以在 /etc/services 或 c：\windows\system32\drivers\etc\services for Windows 找到此專案。

下列螢幕快照顯示此命令在Linux/Unix中的輸出。

Image with output of the db2 command in Linux and Unix

下列螢幕快照顯示 Windows 中此命令的輸出。

Image with output of the db2 command in Windows

判斷資料庫名稱

若要判斷要使用的資料庫名稱：

  1. 在 IBM i 上執行 。 DSPRDBDIRE

    Image showing the output of the Display Relational Database Directory Entries

  2. 其中一個專案會有 *LOCAL 的遠端位置。 這個專案是要使用的專案。

判斷埠號碼

Microsoft 驅動程式會使用分散式關係資料庫架構 （DRDA） 通訊協定連接到資料庫。 DRDA 的預設埠是埠 446。 請先嘗試此值。

若要尋找DRDA服務正在執行的特定埠：

  1. 執行 IBM i 指令 WRKSRVTBLE。

  2. 向下捲動，直到您找到DRDA的項目為止。

    Service Table Entries

  3. 若要確認DRDA服務已啟動並接聽該連接埠，請執行 NETSTAT。

    DRDA listening

  4. 選擇選項 3 （適用於 IPv4） 或選項 6 （適用於 IPv6）。

  5. 按 F14 以查看埠號碼而非名稱，並捲動直到您看到有問題的埠為止。 它應該有狀態為 「Listen」 的專案。

    IP connection status

其他相關資訊