使用 Looker 連結試算表

Looker 連結試算表可讓使用者透過熟悉的 Google 試算表試算表介面，以互動方式探索 LookML 模型的資料。試算表使用者可存取 Looker 支援的 50 多個資料庫中的受管理資料。探索功能相當直覺，因為連結試算表會以有條理的檢視畫面呈現模型，其中的檢視畫面、欄位和指標皆與 Looker 中定義的項目一致。透過連結試算表提供的 Looker 資料，可用於資料透視表、圖表和公式等標準試算表結構，讓您透過熟悉的結構靈活地進行分析。

啟用連結試算表

如要使用連結試算表，請按照下列步驟操作：

  • 在 Looker (原始版) 中，Looker 管理員必須在 Looker 的「Admin」選單的「Platform」部分，透過「BI Connectors」面板啟用「All Looker BI Connectors」或「Connected Sheets」切換鈕。在 Looker (Google Cloud Core) 中，這些選項預設為啟用。
  • Looker 執行個體必須由 Looker 代管。
  • 如果 Looker 執行個體託管在 Google Cloud上，則必須執行 Looker 22.20 以上版本。如果 Looker 執行個體未託管在 Google Cloud上，則必須執行 Looker 23.4 以上版本。
  • 每位使用者如要透過 Google 試算表連線至 Looker 執行個體，都必須在 Looker 使用者帳戶中使用與 Google Workspace 帳戶相同的電子郵件地址。如果 Google Workspace 和 Looker 帳戶電子郵件地址不同，使用者在嘗試透過試算表連結至 Looker 時，就會收到錯誤訊息。
  • 您必須在 Google Workspace 管理控制台中開啟非個別控制項的服務存取權。這項功能通常會預設為啟用。詳情請參閱「管理非獨立控制服務的存取權」說明文章。

透過 Google 試算表連結至 Look

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

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

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

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

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

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

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

透過 Google 試算表連結至 Looker Explore

「探索」是查詢的起點，Explore 會顯示相關聯檢視畫面檔案中的指定欄位組合，你可以選取這些欄位，在試算表中建構查詢。

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

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

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

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

使用 Google 試算表建構 Looker 查詢

Looker 查詢是使用試算表樞紐分析表建立。如要在試算表中加入 Looker 資料，請按照下列步驟操作：

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

  2. 選取要插入新樞紐分析表的新工作表或現有工作表，然後選取「建立」。

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

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

    • 資料列相當於 Looker 維度。
    • 資料欄等同於 Looker 透視維度。
    • 這些值等同於 Looker 測量指標。您可以選取 Looker 維度和試算表「Summarize by」函式，建立自訂評量。
    • 篩選器與 Looker 篩選器相同。

    樞紐編輯器也會顯示探索中包含的檢視畫面清單，您可以選取要顯示的檢視畫面，並顯示該檢視畫面中的維度和指標。

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

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

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

篩選選項

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

依值篩選

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

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

系統會開啟側欄，並從 Looker 擷取最常出現的 500 個值。

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

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

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

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

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

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

  3. 在「Value」欄位中輸入任意 Looker 篩選器運算式。

    舉例來說，如要篩選過去 7 天，可以輸入「7 天」或「最近 7 天」。

  4. 按一下 [確定]。

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

  • 字串開頭不是 -FOO%
  • 包含開頭但不包含結尾的數值範圍：(12, 20]

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

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

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

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

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

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

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

資料透視表和顯示 Look 或探索的試算表都會顯示最近一次更新的時間。

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

安排定期重新整理時間

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

編輯資料透視表設定

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

監控連結試算表

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

在「查詢 API 用戶端屬性」欄位群組中，有三個新的「連結工作表」欄位：

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

以下是顯示 Connected 試算表用量的系統活動網址範例。將 <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 試算表工作流程。
  • 與其他應用程式整合：您可以使用 AppsScript 或 Google 試算表 API，將 Looker 資料連結至外部工具和服務。

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

注意事項

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

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

使用連結試算表建立的查詢，最多只能包含 100,000 列。如果查詢結果包含更多資料列，試算表會向使用者顯示錯誤。如果使用者沒有 download_without_limit 權限，則系統會截斷結果，使其最多只包含 5,000 列，不受 Google 試算表限制影響。

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

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

連結試算表疑難排解

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

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

造成這項錯誤的原因如下：

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

錯誤：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 管理員也可以使用您目前的 Google 電子郵件地址，為您建立新的 Looker 使用者帳戶。

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

這個錯誤表示未啟用連結試算表連接器。Looker 管理員必須在 Looker 的「管理」選單「平台」部分的「BI Connectors 面板」中，啟用「所有 Looker BI Connectors」或「連結試算表」切換按鈕。

錯誤：403 禁止

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