查詢

本頁面是指 探索中的 query 參數。

如 aggregate_table 參數說明頁面所述，query 也可用於匯總資料表。

用量

explore: explore_name {
  query: query_name {
    dimensions: [dimension1, dimension2, ... ]
    measures: [measure1, measure2, ... ]
    label: "Display Name in Field Picker"
    description: "Information about this query"
    pivots: [dimension1, dimension2, ... ]
    sorts: [field1: asc, field2: desc, ... ]
    filters: [field1: "value1", field2: "value2", ... ]
    limit: 100
  }
  ...
}
階層
explore
query
預設值
無

接受
查詢和子參數的名稱，用於定義查詢

定義

您可以使用 query 參數，為探索建立模型化分析。空白「探索」的「快速入門」部分，或「探索」執行完畢後顯示的「快速入門」彈出式視窗，都會列出已建立模型的分析。如要瞭解運作方式，請參閱本頁面的「範例」一節。

模型化分析有助於 Looker 初學者指定維度、指標、篩選器和資料透視表等元素，找出最相關且有洞察力的資料。

在 LookML 中定義查詢

您不必從頭建立查詢的 LookML，而是可以使用「探索」功能，為您建立查詢的基礎 LookML。詳情請參閱下一節「從探索取得查詢 LookML」。

query 參數包含下列子參數：

參數名稱 說明 範例
label 視需要為 query 新增標籤。標籤會顯示在查詢的「探索」欄位選擇器中。 label: "Weekly Sales Totals"
description (選用) 新增查詢說明，讓使用者瞭解查詢內容。在「探索」中，凡是附有說明的查詢都會顯示資訊圖示。使用者將游標懸停在資訊圖示上時，系統會顯示說明文字。 description: "Total value of all sales per day"
dimensions 以半形逗號分隔的「探索」維度清單，這些維度會納入查詢。dimensions 欄位使用下列語法：

dimensions: [dimension1, dimension2, ...] 		dimensions:

  [orders.created_month, orders.country]
measures 以半形逗號分隔的清單，列出要納入查詢的探索量值。measures 欄位使用下列語法：

measures: [measure1, measure2, ...] 		measures:

  [orders.count]
filters 視需要將篩選器新增至 query。篩選器會新增至產生查詢的 SQL WHERE 子句。

filters 欄位使用下列語法：

filters: [field_name_1: "value1", field_name_2: "value2", ...] 		filters: [orders.country: "United States", orders.state: "California"]
limit (選用) 指定查詢的資料列限制。 limit: 10
sorts (選用) 指定 query 的排序欄位和排序方向 (遞增或遞減)。

sorts 欄位使用下列語法：

sorts: [field1: asc|desc, field2: asc|desc, ...] 		sorts: [order_items.total_sales: asc]
pivots 視需要根據查詢的指定維度，透視分析結果。pivots 欄位使用下列語法：

pivots: [dimension1, dimension2, ...]

NOTE：在 pivots 參數中指定的欄位，也必須在查詢的 dimensions 參數中指定。 		pivots: [created_quarter]
timezone 不支援：timezone 參數不支援 query 參數 (explore 的子參數)。explore 下的 query 會使用與 explore 相同的時區。

從探索取得查詢 LookML

為求方便，Looker 開發人員可以借用從「探索」產生 aggregate_table LookML 時使用的功能，然後複製匯總資料表查詢 LookML，並將其做為模型化分析 LookML 的起點。

複製匯總資料表的 LookML 時，您也會複製一些不適用於模型化查詢 LookML 的參數。具體來說，複製匯總資料表 LookML 後，您需要刪除 aggregate_table 和 materialization 參數，因為這些參數只適用於匯總資料表。(如要進一步瞭解這些參數，請參閱 aggregate_table 參數說明文件頁面)。

此外，匯總資料表 query 參數僅支援部分參數，這些參數是由已建立模型的探索查詢所支援。也就是說，複製匯總資料表的 query LookML 後，您就能為模型化查詢使用其他參數。如需模型化查詢支援的完整參數清單，請參閱本頁的「在 LookML 中定義查詢」一節。

如要使用「探索」取得已建立模型查詢的 LookML 基礎：

  1. 在「探索」中，選取要納入模型化查詢的所有欄位和篩選器。
  2. 選取「執行」即可取得結果。

  3. 從「探索動作」齒輪選單中選取「取得 LookML」。這個選項僅適用於 Looker 開發人員。

  4. 選取「匯總表格」分頁標籤。

  5. Looker 會提供匯總資料表的「探索」修正 LookML。我們可以運用匯總資料表的 query LookML，並針對已建模的「探索」查詢進行修改。複製 LookML，然後貼到相關聯的模型檔案中 (探索調整項前的註解會指出該檔案)。如果探索是在「個別探索檔案」中定義，而非模型檔案，您可以將精細化項目新增至探索檔案，而非模型檔案。

    您可以在這裡修改匯總資料表 LookML，以用於模型化查詢：

  6. 只保留 query 參數及其子參數。刪除 aggregate_table 和 materialization 參數，因為這些參數只適用於匯總資料表。

  7. 為查詢新增名稱。如本頁「範例」一節所示，語法如下：

    query: query_name

  8. 視需要填寫已建立模型查詢的其他參數。如需模型化查詢支援的完整參數清單，請參閱本頁的「在 LookML 中定義查詢」一節。

範例

這個範例會為 order_items 探索建立 order_count_by_month 模擬查詢：


explore: +order_items {
  query: order_count_by_month {
     description: "Number of orders placed by month in 2019"
     dimensions: [orders.created_month]
      measures: [orders.count]
     filters: [orders.created_date: "2019"]
    }
  }

使用者可以從「訂單項目」探索的「快速入門」部分執行快速入門分析。