使用 Looker 連結試算表

Looker 連結試算表讓使用者可以透過熟悉的 Google 試算表介面，以互動方式探索來自 LookML 模型的資料。試算表使用者可以存取 Looker 支援的 50 多個資料庫中的受管理資料。連結試算表會以有條理的方式呈現模型，包括在 Looker 中定義的檢視表、欄位和測量指標，因此探索起來非常直覺。透過連結試算表，Looker 資料可用於標準試算表結構，例如資料透視表、圖表和公式，讓您透過熟悉的結構彈性分析資料。

啟用連結試算表

如要使用連結試算表，執行個體必須符合下列規定：

  • 在 Looker (原始版) 中，Looker 管理員必須前往「管理 OAuth 用戶端」頁面 (依序點選「管理」>「驗證」>「管理 OAuth 用戶端」)，在「應用程式庫」分頁啟用預先設定的連結試算表用戶端，或是在 Looker「管理」選單「平台」部分的「商業智慧連接器」面板，啟用「所有 Looker 商業智慧連接器」或「Google 試算表」切換鈕。在 Looker (Google Cloud Core) 中，這些選項預設為啟用。
  • Looker (原始版本) 執行個體必須由 Looker 代管。
  • 如果 Looker (原始) 執行個體已設定 IP 許可清單，您必須停用 IP 許可清單，才能使用連結試算表。Google 試算表 IP 位址沒有特定或精選的靜態清單，可供新增至許可清單。
  • 在 Looker (Google Cloud Core) 中，連結試算表預設為啟用。不過，如果您使用的 Looker (Google Cloud Core) 執行個體已設定 IP 許可清單，則必須在 Google Cloud 控制台的執行個體「執行個體」頁面中，勾選「詳細資料」分頁上的「將 Google 服務連結至這個執行個體」核取方塊，才能連結至連結試算表。
  • 使用者如要從 Google 試算表連線至 Looker 執行個體，Looker 使用者帳戶和 Google Workspace 帳戶必須使用相同的電子郵件地址。如果 Google Workspace 和 Looker 帳戶的電子郵件地址不同，使用者嘗試從試算表連結至 Looker 時，就會收到錯誤訊息。
  • 您必須在 Google Workspace 管理控制台中，開啟非獨立控制服務的存取權。這項功能通常預設為啟用。詳情請參閱「管理非獨立控制服務的存取權」說明文章。

從 Google 試算表連結至 Look 圖表

在 Looker 中，Look 是先前儲存的單一查詢。您可以將 Look 圖表的結果新增至試算表，然後在 Google 試算表中與 Look 圖表輸出內容互動。

  1. 在 Google 試算表的「資料」選單中，依序選取「資料連接器」和「連線到 Looker」。

  2. 在「連結至 Looker」對話方塊中，輸入 Looker 執行個體的名稱，或選取最近連結的執行個體名稱，然後選取「連結至 Look 圖表」。

  3. 在隨即顯示的對話方塊中，選取要新增至 Google 試算表的 Look，然後選取「連結」。您可以使用「搜尋 Look 圖表」欄位，依名稱或 Look 圖表 ID 搜尋已儲存的 Look 圖表，也可以輸入 Look 圖表名稱中的子字串，篩選對話方塊中顯示的 Look 圖表清單。

  4. 在「連結至 Look 圖表」對話方塊中，選取要為 Look 圖表輸出內容建立新工作表，還是將 Look 圖表輸出內容新增至現有工作表，然後選取「建立」。

Google 試算表連線至 Looker 執行個體後，會新增所選 Look 的輸出內容。

您無法在試算表中編輯 Look 圖表，但可以隨時點選「重新整理」來重新整理 Look 圖表資料。點選 Look 圖表網址，即可在 Looker 中開啟 Look 圖表。您也可以在 Look 側欄中查看 Look 名稱、ID 和網址。

從 Google 試算表連結至 Looker 探索

「探索」是查詢的起點，探索會顯示相關聯檢視表檔案中的一組指定欄位，您可以選取這些欄位，在工作表中建構查詢。

  1. 在 Google 試算表的「資料」選單中，依序選取「資料連接器」和「連線到 Looker」。

  2. 在「連結至 Looker」對話方塊中，輸入 Looker 執行個體的名稱，或選取最近連結的執行個體名稱，然後選取「連結至『探索』」。

  3. 在後續對話方塊中，選取要用於查詢的 Looker 模型和探索，然後選取「Connect」(連結)。

試算表連結至 Looker 執行個體後，會開啟新試算表，顯示所選探索的結構，包括檢視表、維度、測量指標，以及 Looker 開發人員新增的任何欄位說明。

使用 Google 試算表建立 Looker 查詢

Looker 查詢是使用試算表資料透視表建立。如要將 Looker 資料新增至試算表，請按照下列步驟操作：

  1. 在顯示「探索」的工作表中，選取「資料透視表」。

  2. 選取要在新工作表或現有工作表中插入新的資料透視表，然後選取「建立」。

    系統會建立新的空白資料透視表，並開啟「資料透視表編輯器」視窗。您可以根據 Looker 探索中的維度和測量指標，新增資料列、資料欄、值和篩選器，建立查詢。

    資料透視表編輯器中的列、欄、值和篩選器，與 Looker 維度和測量指標的對應關係如下：

    • 資料列相當於 Looker 維度。
    • 資料欄相當於 Looker 的透視維度。
    • 值相當於 Looker 測量指標。您可以選取 Looker 維度和試算表的「摘要依據」函式，建立自訂測量指標。
    • 篩選器等同於 Looker 篩選器。

    資料透視編輯器也會顯示「探索」中的檢視表清單，您可以選取檢視表，顯示其中包含的維度和測量指標。

  3. 選取「新增」，即可新增列、欄、值或篩選器。連結試算表會顯示「探索」中可用的檢視表清單。選取檢視表名稱，即可查看檢視表中的維度和測量指標清單，然後選取要為列、欄、值或篩選器提供資料的欄位。

  4. 新增 Looker 欄位和篩選器來建立查詢後，請選取「套用」。系統會將 Looker 執行個體的資料填入工作表。

將 Looker 資料新增至資料透視表後，您可以使用 Google 試算表設定資料格式，或根據 Looker 資料建立新的試算表公式。

篩選選項

自 Looker 連結試算表推出以來，我們新增了篩選選項。

依值篩選

在 Looker 連結試算表的資料透視表中，您可以查看值清單，並選取或取消選取所需的值，藉此篩選 Looker 維度。以往使用條件篩選時，您必須手動輸入篩選值。

如要使用這項功能，請在資料透視表的「篩選器」部分新增欄位，然後按一下「狀態」下拉式選單，開啟篩選器選項。然後按一下「新增篩選器」：

側欄隨即開啟，試算表會從 Looker 擷取 500 個最常出現的值。

接著，您可以搜尋項目、選擇或清除所有項目，或依頻率或字母順序排序項目。按一下底部的「確定」，Google 試算表就會儲存您的選擇。接著，您可以按一下「套用」，照常重新整理資料透視表，並套用新的篩選條件。

使用 Looker 篩選運算式的篩選器

您可以使用 Looker 篩選運算式，在連結試算表中套用相對日期篩選器，以及許多其他進階篩選器。舉例來說，你可以在連結試算表中套用「過去 30 分鐘內」或「過去 10 天內」等篩選條件。

如要使用 Looker 篩選運算式，請按照下列步驟操作：

  1. 在資料透視表的篩選器部分新增欄位。

  2. 按一下「狀態」下拉式選單，顯示篩選器選項，然後選取「篩選運算式」。

  3. 在「Value」(值) 欄位中輸入任何 Looker 篩選運算式。

    舉例來說，如要篩選最近 7 天的資料，可以輸入「7 days」或「last 7 days」。

  4. 按一下 [確定]。

除了相對日期篩選外，現在還可使用其他篩選條件，例如：

  • 開頭不是 -FOO% 的字串
  • 包含和排除的數值範圍：(12, 20]

如要查看所有可用的篩選運算式，請參閱「Looker 篩選運算式」說明文件頁面。

使用 Looker 參數和篩選器限定欄位

您現在可以在連結試算表中使用參數和篩選器限定欄位。

篩選器限定欄位和參數會顯示在 Google 試算表欄位挑選器的「篩選器限定欄位」部分，就像在 Looker 中一樣。如要使用，請按照下列步驟操作：

  1. 將所選參數和篩選器限定欄位新增或拖曳至「篩選器」部分，就像依維度或測量指標篩選一樣。
  2. 如果參數有允許值，這些值會顯示在「依條件篩選」對話方塊的下拉式選單中。
  3. 如果是僅限篩選的欄位，您可以使用一般的「依條件篩選」對話方塊。如果欄位在 Looker 模型中定義了建議，您也可以使用「依值篩選」功能。

在 Google 試算表中重新整理資料

資料透視表中的資料是靜態資料，但隨時可以重新整理。重新整理資料後，Looker 會查詢資料庫，並以最新資料更新資料透視表。

資料透視表和顯示 Look 或探索的工作表，都會顯示最近重新整理的時間。

選取「重新整理」，更新資料透視表中的資料。

安排定期重新整理時間

如要排定資料自動更新，請選取資料透視表中的三點圖示選單，然後選取「重新整理選項」，或在「探索」工作表中選取「重新整理選項」。Looker 會顯示「Scheduled Refresh」(排定重新整理) 對話方塊。

編輯資料透視表設定

如要修改資料透視表中的列、欄、值或篩選器，請選取三點圖示選單旁的鉛筆圖示，開啟資料透視表編輯面板。

監控連結試算表

Looker 管理員可以使用系統活動記錄探索中的「Query API 用戶端屬性」欄位群組，查看連結試算表的使用情形。每次執行新查詢時，系統都會在「History」(記錄) 探索中建立項目。

在「Query API Client Properties」(查詢 API 用戶端屬性) 欄位群組中，有三個新的連結試算表欄位：

  • API Client Name：這個欄位一律會顯示 Connected Sheets，用於識別連結試算表項目。
  • 連結試算表 ID：這個欄位會顯示工作表 ID，該 ID 包含在該工作表的 Google 試算表網址中。
  • 連結試算表觸發條件：這個欄位會顯示查詢是由使用者在試算表中選取「重新整理」按鈕，還是由排定的重新整理作業觸發。

以下是顯示連結試算表用量的系統活動網址範例。將 <instance_name.looker.com> 替換為執行個體網址。

https://<instance_name.looker.com>/explore/system__activity/history?fields=query_api_client_context.name,query_api_client_context.cs_spreadsheet_id,query_api_client_context.cs_trigger,user.name,history.created_date,history.created_time_of_day&f[query_api_client_context.cs_spreadsheet_id]=-NULL&sorts=history.created_time_of_day+desc&limit=5000

連結試算表 API 支援

您可以透過 AppsScript 和 Google Sheets API，使用 Looker 連結試算表的 API 支援。

您可以透過 API 支援，以程式輔助方式執行下列操作：

  • 自動重新整理資料：您可以排定定期更新 Looker 支援的試算表，確保使用的是最新資訊。
  • 自訂工作流程：您可以建立複雜的程序，將 Looker 資料整合至現有的 Google 試算表工作流程。
  • 與其他應用程式整合：您可以使用 Apps Script 或 Google 試算表 API，將 Looker 資料連結至外部工具和服務。

如要使用 Google Sheets API 指定 Looker 做為資料來源，請搭配 DataSourceSpec REST 資源使用 looker 物件。

注意事項

  • 資料透視表中顯示的資料是否區分大小寫，取決於模型的大小寫設定。不過，如果篩選器不區分原生試算表資料的大小寫，資料透視表的篩選器就會強制不區分大小寫。
  • 凡是具備工作表檢視者權限的使用者，都能查看資料透視表中的快取資料。
  • 除了工作表的編輯者權限外，任何需要編輯或重新整理資料透視表的使用者，也必須具備 Looker 的正確權限，才能存取資料模型。包括資料透視表所依據模型的存取權、查看資料的權限，以及透過存取篩選器或存取權授予適當存取資料。
  • 如果使用者透過 OAuth 向 BigQuery 資料庫驗證身分，可能需要取得基礎資料庫的權限。

連結試算表的資料列和資料限制

使用連結試算表建立的查詢最多可有 100,000 列。如果查詢結果包含更多列，試算表會向使用者顯示錯誤。如果使用者沒有 download_without_limit 權限，無論 Google 試算表限制為何，結果都會截斷至最多 5,000 列。

此外，連結試算表查詢也有資料大小限制。如果查詢傳回過多資料，也會導致錯誤。

如果看到上述任一錯誤，建議您在查詢中新增篩選器，或減少維度數量和/或採用較不精細的維度。

疑難排解連結試算表問題

嘗試從 Google 試算表連結至 Looker 時，可能會遇到一些問題。本節將說明這些問題及修正方法。

錯誤：連線到 Looker 執行個體時發生錯誤，請再試一次。如果問題仍未解決，請傳送意見回饋。

發生這項錯誤的原因有很多：

  • 輸入的 Looker 執行個體名稱有誤。在這種情況下，請確認 Looker 執行個體名稱，然後再次嘗試連線。
  • 試算表無法連線至 Looker API。如果 Looker 執行個體未使用預設 API 主機網址，就可能發生這種情況。如要修正這個問題，請將 API 管理面板中的「API Host URL」欄位留空。

錯誤：Looker 執行個體未設為可使用這項功能。請聯絡 Looker 管理員確認你符合相關資格。

發生這項錯誤的原因有很多：

  • 您正嘗試連結新建立的 Looker 執行個體。新的 Looker 執行個體最多可能需要 24 小時，才會顯示在連結試算表中。
  • 您嘗試連結的 Looker 執行個體並非由 Looker 代管。連結至其他由 Looker 代管的 Looker 執行個體。

連結至 Looker 執行個體後，未顯示任何模型

這表示您缺少必要權限，無法查看執行個體上的模型。

具備檢視者角色的 Looker 使用者，沒有足夠的權限在試算表中建立連結，就像他們沒有足夠的權限在 Looker 中使用探索 UI 一樣。如要使用 Looker 連結試算表，使用者必須具備 explore 權限。管理員、開發人員和使用者角色具備 explore 權限。Looker 管理員可以授予使用者 explore 權限，讓使用者查看執行個體上的模型。

錯誤：你連結的 Looker 帳戶電子郵件地址與 Google 帳戶電子郵件地址不同。

這表示 Looker 帳戶電子郵件地址與 Google 帳戶電子郵件地址不符。請確認您登入的 Google 帳戶電子郵件地址與 Looker 帳戶相同。或者，Looker 管理員可以建立新的 Looker 使用者帳戶，並使用您目前的 Google 電子郵件地址。

錯誤：要求無效，找不到啟用的用戶端。

這項錯誤表示連結試算表連接器尚未啟用。Looker 管理員必須在「管理 OAuth 用戶端」頁面 (依序點選「管理」>「驗證」>「管理 OAuth 用戶端」) 的「應用程式庫」分頁，啟用預先設定的「連結試算表」用戶端，或在 Looker「管理」選單「平台」部分的「商業智慧連接器」面板，啟用「所有 Looker 商業智慧連接器」或「Google 試算表」切換鈕。

錯誤：403 禁止

如果 Looker 執行個體已設定 IP 許可清單，該清單可能會阻止 Google 試算表連線至 Looker API。如要判斷是否為許可清單造成，請嘗試前往 Looker 執行個體網址，看看是否收到「IP Address Not on Allowlist」(IP 位址不在許可清單中) 錯誤。

  • 如果 Looker (原始版) 執行個體使用 IP 許可清單，則沒有特定或精選的 Google 試算表 IP 位址靜態清單可新增至許可清單。如要使用連結試算表，請停用 IP 許可清單。
  • 如果 Looker (Google Cloud Core) 執行個體使用 IP 許可清單，您必須在 Google Cloud 控制台的執行個體「詳細資料」分頁中，勾選「將 Google 服務連結至這個執行個體」核取方塊。