本頁面說明如何啟用及使用 Looker「探索動作」齒輪選單中的「連結試算表」快速連結選項。「連結試算表」選項會開啟 Google 試算表,並啟動 Google 試算表與 Looker 探索之間的連結。接著,您可以使用所選 Looker 探索中的欄位,在新建的 Google 試算表中建立報表、資料透視表或圖表。
事前準備
如要使用「連結試算表」快速連結,請務必符合下列條件:
- 管理員已啟用並設定連結試算表快速連結的 Looker 執行個體,如本頁「啟用及設定連結試算表快速連結」一節所述
- 具有 LookML 模型
explore權限的 Looker 使用者帳戶,可連結至試算表 - 與 Looker 帳戶相關聯的電子郵件地址所屬的 Google 帳戶
從「探索」使用連結試算表快速連結
如果 Looker 管理員已啟用這項功能,您就可以在 Google 試算表與任何您有權存取的探索之間建立連結:
使用與 Google 帳戶相關聯的電子郵件地址登入 Looker。
在 Looker 中,前往要用做資料來源的「探索」。
按一下「探索動作」齒輪圖示 ,然後選取「已連結的試算表」。
首次使用這項功能時,系統會提示您授權 Looker 存取您的 Google 帳戶。選擇要使用的 Google 帳戶,Google 帳戶的電子郵件地址必須與 Looker 使用者帳戶的電子郵件地址相同。
在同意畫面中查看要求的權限,然後按一下「允許」。
系統會開啟新的瀏覽器分頁,並顯示對話方塊,詢問您是否要將 Google 帳戶連結至 Looker 帳戶。按一下「連結帳戶」。
Google 試算表現在已連結至您啟動的 Looker 探索。在 Google 試算表中,您可以新增探索資料中的欄位、建立資料透視表、製作圖表,以及套用公式來分析 Looker 探索資料。
如要進一步瞭解如何在連結試算表中建立查詢,請參閱「使用 Looker 連結試算表」說明文件頁面。
啟用及設定連結試算表快速連結
如要在「探索動作」齒輪選單中啟用「連結試算表」快速連結,Looker 執行個體必須符合下列規定:
- 執行個體必須搭載 Looker 25.20 以上版本。
- 對於 Looker (Google Cloud Core) 執行個體,已連結試算表快速連結僅支援公開安全連線或混合式連線網路連線。不支援 Looker (Google Cloud Core) 私人連線 (私人服務存取權) 執行個體。
- 如果是 Looker (原始版) 執行個體,只有託管於 Looker 的執行個體支援「連結試算表」快速連結。不支援客戶代管的 Looker 執行個體。
如要在 Looker 執行個體的「探索動作」齒輪選單中啟用「已連結的試算表」選項,管理員必須執行下列一般工作 (詳情請參閱後續章節):
- 在 Google Cloud 控制台中啟用 Google Sheets API。
- 在啟用 Google Sheets API 的 Google Cloud 控制台專案中,於 Google Cloud 控制台建立 OAuth 用戶端。
- 在 Looker BI 連接器頁面上,啟用並設定「啟用連結試算表快速連結」選項。
在 Google Cloud 控制台中啟用 Google Sheets API
「已連結的試算表」快速連結會使用 Google Sheets API,因此您必須在建立 OAuth 用戶端的專案中啟用這項 API。IAM 使用者必須具備 IAM roles/serviceusage.serviceUsageAdmin 權限,才能啟用 Google Sheets API。
請按照下列步驟啟用 Google Sheets API:
在 Google Cloud 控制台的導覽選單中,依序前往「API 和服務」>「程式庫」,然後開啟 Google Sheets API。
在 Google Cloud 控制台開啟專案選擇工具,然後選取要用於從 Looker 探索連結至 Google 試算表的專案。在整個連結試算表快速連結設定程序中,您必須使用相同的 Google Cloud 控制台專案,這樣才能在設定 OAuth 的專案中啟用 Google Sheets API。
如果尚未啟用 Google Sheets API,請在該 API 的頁面中點選「啟用」。
建立 OAuth 用戶端
具有必要角色的 IAM 使用者必須建立 OAuth 用戶端。
您可以在任何 Google Cloud 專案中設定 OAuth 用戶端。不過,您必須在同一個專案中啟用 Google Sheets API。
如要建立用戶端及其憑證,請按照下列步驟操作:
在 Google Cloud 控制台中,使用 Google Cloud 控制台的專案挑選器,開啟啟用 Google Sheets API 的專案。
使用 Google Cloud 控制台主選單,依序前往「API 和服務」>「憑證」。
在「憑證」頁面中,按一下「建立憑證」下拉式選單,然後選取「OAuth 用戶端 ID」。
在「應用程式類型」下拉式選單中,選取「網頁應用程式」。
在「Name」(名稱) 欄位中,輸入 OAuth 用戶端的名稱,例如
Looker to Connected Sheets。在「已授權的重新導向 URI」部分中,按一下「新增 URI」按鈕。新增下列 URI:
https://LOOKER_INSTANCE_URL/oauth2callback按一下「新增 URI」按鈕,新增下列 URI:
https://LOOKER_INSTANCE_URL/external_oauth/redirect點選「建立」。
按一下「建立」後,系統會顯示「已建立 OAuth 用戶端」視窗。這個視窗會顯示 Google Cloud 控制台為 OAuth 用戶端建立的用戶端 ID 和用戶端密鑰。複製並記下這些值,因為您設定「啟用連結的試算表」快速連結選項時會需要用到。
設定「啟用連結試算表快速連結」選項
在 Google Cloud 管理中心啟用 Google Sheets API,並在 Google Cloud 管理中心建立 OAuth 用戶端後,即可按照下列步驟在 Looker 執行個體中啟用「已連結的試算表」快速連結:
- 在 Looker 執行個體中,從「管理」面板的「平台」部分選取「BI 連接器」。
- 如果尚未啟用「Google 試算表」切換鈕,請啟用。
- 啟用巢狀切換按鈕「啟用連結試算表快速連結」。
- 在「用戶端 ID」和「用戶端密鑰」欄位中,貼上您在 Google Cloud 控制台中建立 OAuth 用戶端時,從 Google Cloud 控制台複製的值。
- 按一下 [儲存]。
「探索動作」齒輪選單中的「連結試算表」選項現在已為 Looker 執行個體設定完畢。
從測試計畫遷移
如果貴機構先前參與「在 Google 試算表開啟」功能的前測計畫,Looker 執行個體會使用 Looker 提供的集中管理 OAuth 用戶端。我們將淘汰這項設定,改用更安全且可擴充的方法,讓每位 Looker 管理員為自己的 Looker 執行個體設定 OAuth 用戶端。現有的試用客戶應改用這項新設定,確保功能持續運作。
如要遷移至新版,管理員必須在 Google Cloud 控制台中設定貴機構的 OAuth 用戶端,然後在 Looker BI Connectors 管理頁面中設定憑證。步驟與首次設定相同,請參閱本頁面以下各節:
- 在 Google Cloud 控制台啟用 Google Sheets API
- 在啟用 Google Sheets API 的 Google Cloud 控制台專案中,於 Google Cloud 控制台建立 OAuth 用戶端
- 在 Looker BI Connectors 頁面上,啟用並設定「啟用連結試算表快速連結」選項
管理員完成這些步驟後,執行個體就會自動使用新的客戶管理 OAuth 流程。先前的試用功能及其對 Looker 管理的 OAuth 用戶端的依賴關係將不再有效。
疑難排解
- 電子郵件地址不符錯誤:如果在 Google 驗證步驟中發生錯誤,請確認您選取的 Google 帳戶電子郵件地址與 Looker 使用者帳戶完全相同。
- 未顯示「已連結的試算表」選項:只有在 Looker 管理員已在 BI Connectors 設定中啟用這項功能時,探索動作齒輪選單才會顯示這個選項。請與 Looker 管理員聯絡以取得協助。
- Google Cloud 控制台權限:設定 OAuth 用戶端和同意畫面的管理員,必須在 Google Cloud 專案中具備
roles/oauthconfig.editor和roles/serviceusage.serviceUsageAdmin權限。 - 如果在公開測試期間遇到其他問題或有任何意見回饋,請傳送電子郵件至
looker-connected-sheets-external@google.com 。