Looker-Excel 連接器

透過 Looker-Excel 連接器,您可以將 Looker 探索查詢匯出為 Microsoft Excel 可辨識的格式。啟用 Looker-Excel 連接器後,Looker 探索資料的「探索」齒輪選單中會顯示「在 Excel 中開啟」選項。選取這個選項後,Looker 會將探索查詢匯出至 Windows 電腦上的 ODC 檔案。如果已安裝 ODBC 驅動程式,您可以在 Windows 版 Microsoft Excel 中開啟 ODC 檔案。

事前準備

如要使用 Looker-Excel 連接器,您必須具備下列條件:

  • Windows 64 位元或 32 位元電腦。
  • 符合下列條件的 Looker 執行個體:
    • 執行 Looker 25.16 以上版本。
    • 已為 Microsoft Excel BI 連接器啟用。Looker 管理員必須在 Looker BI Connectors 頁面上啟用「Microsoft Excel」切換鈕。
  • Looker 帳戶的使用者角色必須包含 explore 權限,且使用者要透過 Looker-Excel 連接器存取 LookML 模型。

您也必須按照下一節所述安裝 ODBC 驅動程式

安裝 ODBC 驅動程式

Looker ODBC 驅動程式是軟體,必須安裝在每位 Looker-Excel 連接器使用者的本機電腦上。ODBC 驅動程式可讓相容於 ODBC 的用戶端連線至 Looker 執行個體,就像連線至 SQL 資料庫一樣。

如要使用 ODBC 驅動程式,必須安裝 ODBC 管理員程式。Windows 通常會預先安裝名為「ODBC 資料來源」的程式做為管理工具。詳情請參閱 Microsoft 說明文件:ODBC 資料來源管理員

如要安裝 ODBC 驅動程式,請按照下列步驟操作:

  1. 請使用下列連結,下載適用於 Windows 系統架構 (64 位元或 32 位元) 的最新 ODBC 安裝程式:

  2. 開啟 ODBC 安裝程式檔案,然後按照畫面上的指示操作。

  3. 您可能會看到 Windows 對話方塊,指出「Windows 已保護您的電腦」。如果看到這個對話方塊,請按一下「詳細資訊」連結,然後按一下「仍要執行」按鈕。

在 Windows 電腦上安裝 ODBC 驅動程式後,首次開啟 ODC 檔案時,Windows 會提示您建立資料來源名稱 (DSN),以便搭配 Excel 等 ODBC 用戶端使用 ODBC 驅動程式。DSN 是儲存的設定,內含 Looker 執行個體資訊和驗證憑證。

使用 Looker-Excel 連接器

符合必要條件並在電腦上安裝 ODBC 驅動程式後,請按照下列步驟在 Microsoft Excel 中開啟 Looker 資料:

  1. 在 Windows 電腦上,於瀏覽器中開啟 Looker 執行個體。
  2. 開啟「探索」並執行查詢。
  3. 按一下「探索」齒輪選單,然後選取「在 Excel 中開啟」選項。
  4. 在「在 Excel 中開啟」對話方塊中,選取「要納入的列數和欄數」的下列其中一個選項:

    • 當前結果資料表:選取這個選項,即可在探索中納入當前結果資料表的所有資料列和資料欄。資料列數量受限於探索的「資料列限制」值。
    • 所有結果:選取這個選項,即可將查詢傳回資料庫的所有結果納入匯出範圍。如果查詢已啟用「列總計」,或從「無法串流結果」的資料庫方言擷取資料,或包含「占總計百分比」,或包含下列類型的指標:「占前一期百分比」或「累計總計」,通常會停用「所有結果」選項。 警告:即使有「所有結果」選項,下載所有結果時仍應謹慎。部分查詢非常龐大,包含成千上萬或數百萬列,這可能會超出大多數試算表程式的負荷,甚至導致 Looker 執行個體不堪重負。
    • 自訂:選取這個選項,即可手動指定要納入 ODC 檔案下載內容的列數和欄數。
    • 擁有 download_without_limit 權限的使用者最多可輸入 100,000 列和 200 欄。
    • 擁有 download_with_limit 權限的使用者最多可輸入 5,000 列,以及 200 欄。
    • 如果使用者沒有 download_with_limitdownload_without_limit 權限,系統就不會顯示「在 Excel 中開啟」選項。
  5. 在「在 Excel 開啟」對話方塊中,按一下「下載」。系統會將 ODC 檔案下載到電腦上。

  6. 使用 Microsoft Excel 開啟 ODC 檔案。

  7. Microsoft Excel 會顯示有關資料連線遭封鎖的安全通知。按一下「啟用」,啟用資料連線。

  8. Windows 會顯示對話方塊,用於設定 Google Looker DSN。請按照下列步驟設定 DSN:

    1. 在「Auth Type」下拉式選單中,選取「OAuth」。雖然 OAuth 是首選選項,但您也可以視需要選取「基本驗證」。如果選取「基本驗證」,則必須輸入 Looker API 憑證。請參閱本頁面的「使用基本驗證進行驗證」一節。
    2. 按一下 [Login] (登入),系統會開啟網路瀏覽器,驗證您的 Looker 帳戶。網路瀏覽器顯示登入成功後,請關閉網路瀏覽器,然後返回 DSN 對話方塊。
    3. 按一下「DSN」對話方塊中的「確定」
    4. 如果系統提示您覆寫 DSN,請按一下「確定」

Excel 會執行查詢,並將資料插入新的樞紐分析表物件。接著就能在計算和視覺化作業中使用資料。

如要擷取最新資料,請執行下列任一操作:

  • 如要重新執行相同查詢,從 Looker 取得最新資料,請按一下 Excel 功能區中的「重新整理」按鈕。
  • 如要修改查詢,請使用 Looker 探索 UI 更新查詢,然後選取「在探索中開啟」探索選項,下載新的 ODC 檔案 (換句話說,從這個程序的步驟 1 重新開始)。根據預設,Excel 會在新 Excel 活頁簿中開啟新的 ODC 檔案。如要將樞紐分析表從一個活頁簿移至另一個活頁簿,請在 Excel 活頁簿之間按一下並拖曳工作表,或將樞紐分析表從一個活頁簿複製並貼到另一個活頁簿。

限制

Looker-Excel 連接器僅支援 Windows,不支援 Mac 或 Linux 電腦。

Looker-Excel 連接器不支援下列「探索」查詢功能:

如要在 Microsoft Excel 中開啟探索查詢,請先移除表格計算和樞紐分析欄,然後從「探索」齒輪選單中選取「在 Excel 中開啟」

疑難排解

以下各節提供疑難排解程序和工具的相關資訊:

手動新增 DSN

使用 Excel 開啟 ODC 檔案時,Windows 會提示您建立 DSN。如要手動建立或編輯 DSN,可以使用 Windows ODBC 驅動程式資料來源管理員。

如要手動建立或編輯 DSN,請按照下列步驟操作:

  1. 在 Windows 電腦的控制台中,開啟「ODBC Data Sources」(ODBC 資料來源) 應用程式 (在 Windows 8 之前,這個應用程式稱為「ODBC Driver Data Source Administrator」(ODBC 驅動程式資料來源管理員))。
  2. 按一下 [新增] 按鈕。
  3. 按兩下「Google Looker ODBC Driver」
  4. 在「設定 Google Looker DSN」對話方塊中,填寫下列欄位:
    • 資料來源名稱*:(選填) 輸入資料來源名稱,方便日後辨識這個 DSN。
    • 主機:輸入 Looker 執行個體的網址。
    • 「通訊埠」:輸入要連線的 Looker 執行個體通訊埠。預設值為 443
    • 在「Auth Type」下拉式選單中,選取「OAuth」。雖然 OAuth 是首選選項,但您也可以視需要選取「基本驗證」。如果選取「基本驗證」,則必須輸入 Looker API 憑證。請參閱本頁面的「使用基本驗證進行驗證」一節。
  5. 按一下 [Login] (登入),系統會開啟網路瀏覽器,驗證您的 Looker 帳戶。網路瀏覽器顯示登入成功後,請關閉網路瀏覽器,然後返回 DSN 對話方塊。
  6. 按一下「測試」,驗證連線。
  7. 按一下「DSN」對話方塊中的「確定」
  8. 如果系統提示您覆寫 DSN,請按一下「確定」

使用基本驗證進行驗證

建議使用 OAuth 驗證 Looker。或者,如果您在 DSN 對話方塊中選取「Basic Auth」做為「Auth Type」,可以使用 API 金鑰「Client ID」和「Client Secret」進行驗證。如要瞭解如何建立 API 金鑰,請參閱「管理設定 - 使用者」說明文件頁面。

安裝程式記錄

如要存取安裝程式記錄檔,以便排解 Looker-Excel 連接器問題,請前往 C:\Users\<username>\lookerODBCLogs 目錄。安裝程式記錄檔名稱的格式如下:

  Google_Looker_ODBC_<32/64>-bit_Driver_<timestamp>

升級 Microsoft Visual C++ 可轉散發套件 (MSVC)

如果系統尚未安裝 Microsoft Visual C++ 可轉散發套件第 14 版 (MSVC),系統會自動安裝。

如果已安裝 MSVC 套件,Google Looker ODBC 驅動程式安裝程式不會升級該套件。如要使用驅動程式隨附的 MSVC 版本,請先解除安裝現有的 MSVC 套件,再執行安裝程式。

解除安裝驅動程式後,MSVC 套件仍會保留在裝置上,以支援其他應用程式。如果不再需要,可以手動解除安裝。