連結試算表快速連結

本頁面說明如何啟用及使用 Looker「探索動作」齒輪選單中的「連結試算表」快速連結選項。「連結試算表」選項會開啟 Google 試算表,並啟動 Google 試算表與 Looker 探索之間的連線。接著,您可以使用所選 Looker 探索中的欄位,在新建立的 Google 試算表中建立報表、資料透視表或圖表。

事前準備

如要使用連結試算表快速連結,您必須具備下列條件:

  • Looker 執行個體,且管理員已啟用並設定這項功能,如本頁「啟用及設定連結試算表快速連結」一節所述
  • Looker 使用者帳戶,且具備要連結至試算表的 LookML 模型 explore 權限
  • Google 帳戶的電子郵件地址與 Looker 帳戶相同

如果 Looker 管理員已啟用這項功能,您就能在 Google 試算表和您有權存取的任何探索之間建立連結:

  1. 使用與 Google 帳戶相關聯的電子郵件地址登入 Looker。

  2. 在 Looker 中,前往要用做資料來源的探索。

  3. 按一下「探索動作」齒輪圖示 ,然後選取「連結試算表」。

  4. 首次使用這項功能時,系統會提示您授權 Looker 存取 Google 帳戶。選擇要使用的 Google 帳戶,Google 帳戶的電子郵件地址必須與 Looker 使用者帳戶相關聯的電子郵件地址相符。

  5. 查看同意畫面中要求的權限,然後按一下「允許」。

  6. 系統會開啟新的瀏覽器分頁,前往 Google 試算表,並顯示對話方塊,詢問是否要將 Google 帳戶連結至 Looker 帳戶。按一下「連結帳戶」。

Google 試算表現在已連結至您一開始使用的 Looker 探索。在 Google 試算表中,您可以新增「探索」中的欄位、建立資料透視表、製作圖表,以及套用公式,分析 Looker「探索」中的資料。

如要進一步瞭解如何在連結試算表中建構查詢,請參閱「使用 Looker 連結試算表」說明文件頁面。

啟用及設定連結試算表快速連結

如要在「探索動作」齒輪選單中啟用「連結試算表」快速連結,Looker 執行個體必須符合下列規定:

如要在 Looker 執行個體的「探索動作」齒輪選單中啟用「連結試算表」選項,管理員必須執行下列一般工作,詳情請參閱以下各節:

在 Google Cloud 控制台中啟用 Google Sheets API

連結試算表快速連結會使用 Google Sheets API,因此您必須在建立 OAuth 用戶端的專案中啟用這個 API。具備 IAM roles/serviceusage.serviceUsageAdmin 權限的 IAM 使用者可以啟用 Google Sheets API。

請按照下列步驟啟用 Google Sheets API:

  1. 在 Google Cloud 控制台的導覽選單中,依序前往「API 和服務」>「程式庫」,然後開啟 Google Sheets API。

    前往 Google Sheets API

  2. 在 Google Cloud 控制台開啟專案挑選器,選取要用於從 Looker 探索連結至 Google 試算表的專案。在設定連結試算表快速連結的過程中,您必須使用同一個 Google Cloud 控制台專案,這樣才能在設定 OAuth 的專案中啟用 Google Sheets API。

  3. 在 Google Sheets API 頁面,點選「啟用」(如果尚未啟用)。

建立 OAuth 用戶端

具備必要角色的 IAM 使用者必須建立 OAuth 用戶端。

您可以在任何 Google Cloud 專案中設定 OAuth 用戶端。不過,您必須在同一個專案中啟用 Google Sheets API。

如要建立用戶端和憑證,請按照下列步驟操作:

  1. 在 Google Cloud 控制台,使用 Google Cloud 控制台的「開啟專案挑選器」,開啟啟用 Google Sheets API 的專案。

    前往 Google Cloud 控制台

  2. 使用 Google Cloud 控制台主選單,依序前往「API 和服務」>「憑證」。

  3. 在「憑證」頁面中,按一下「建立憑證」下拉式選單,然後選取「OAuth 用戶端 ID」。

  4. 在「應用程式類型」下拉式選單中,選取「網頁應用程式」。

  5. 在「Name」(名稱) 欄位中,輸入 OAuth 用戶端的名稱,例如 Looker to Connected Sheets。

  6. 在「已授權的重新導向 URI」部分,點選「新增 URI」按鈕。新增下列 URI:

    https://LOOKER_INSTANCE_URL/oauth2callback
    
  7. 按一下「新增 URI」按鈕,新增下列 URI:

    https://LOOKER_INSTANCE_URL/external_oauth/redirect
    
  8. 點選「建立」。

  9. 點選「建立」後,系統會顯示「已建立 OAuth 用戶端」視窗。這個視窗會顯示 Google Cloud 控制台為 OAuth 用戶端建立的用戶端 ID 和用戶端密鑰。複製並記下這些值,因為在設定「啟用連結試算表」快速連結選項時會用到。

設定「啟用連結試算表快速連結」選項

在 Google Cloud 控制台啟用 Google Sheets API,並在 Google Cloud 控制台建立 OAuth 用戶端後,請按照下列步驟,在 Looker 執行個體啟用連結試算表快速連結:

  1. 在 Looker 執行個體中,依序選取「管理」面板「平台」部分的「商業智慧連接器」。
  2. 如果尚未啟用「Google 試算表」,請啟用切換鈕 (您也可以在「管理 OAuth 用戶端」頁面啟用預先設定的「連結試算表」用戶端;這兩個頁面的設定會同步)。
  3. 啟用巢狀切換鈕「啟用連結試算表快速連結」。
  4. 在「用戶端 ID」和「用戶端密鑰」欄位中,貼上您在 Google Cloud 控制台建立 OAuth 用戶端時,從 Google Cloud 控制台複製的值。
  5. 按一下 [儲存]。

「探索動作」齒輪選單中的「連結試算表」選項,現在已為 Looker 執行個體設定完成。

從前測計畫遷移

如果貴組織曾參與「在試算表中開啟」功能的前測計畫,Looker 執行個體會使用 Looker 提供的集中管理 OAuth 用戶端。這項設定即將淘汰,改用更安全且可擴充的方法,讓每位 Looker 管理員為自己的 Looker 執行個體設定 OAuth 用戶端。現有的前測計畫客戶應改用這項新設定,確保功能持續運作。

如要遷移至新版本,管理員必須在 Google Cloud 控制台中設定貴組織的 OAuth 用戶端,然後在 Looker BI 連接器管理頁面中設定憑證。步驟與首次設定相同,請參閱本頁以下各節:

管理員完成這些步驟後,執行個體就會自動使用新的客戶管理 OAuth 流程。先前的前測功能和對 Looker 代管 OAuth 用戶端的依賴將不再有效。

疑難排解

  • 電子郵件不符錯誤:如果在 Google 驗證步驟中發生錯誤,請確認所選 Google 帳戶的電子郵件地址與 Looker 使用者帳戶完全相同。
  • 看不到「連結試算表」選項:只有在 Looker 管理員於「商業智慧連接器」設定中啟用這項功能時,探索動作齒輪選單才會顯示這個選項。請與 Looker 管理員聯絡,尋求協助。
  • Google Cloud 控制台權限:設定 OAuth 用戶端和同意畫面的管理員,必須具備 Google Cloud 專案的 roles/oauthconfig.editor 和 roles/serviceusage.serviceUsageAdmin 權限。
  • 如在公開測試期間遇到其他問題或想提供意見,請傳送電子郵件至 looker-connected-sheets-external@google.com。