探索

本頁面是指 模型的 explore 參數。

explore 也可做為資訊主頁篩選器的一部分，詳情請參閱「資訊主頁參數」說明文件頁面。

explore 也可以做為資訊主頁元素的一部分。如需使用範例，請參閱「LookML 資訊主頁的直條圖參數」說明文件頁面。

用量

explore: explore_name { . . . }

階層 模型檔案 explore

預設值 無 接受 現有檢視區塊的名稱，或使用 from 時 explore 的名稱 特別規則 explore 名稱不得與模型中的其他名稱重複

定義

如果「探索」名稱前方有加號 (+)，例如 explore: +orders，表示這是「探索」的精選。詳情請參閱 LookML 修飾說明文件頁面。

explore 會將現有檢視區塊新增至「探索」的 Looker 選單，如「LookML 術語和概念」說明文件頁面所述。最佳做法是在模型檔案中定義探索。

探索通常會以現有的檢視區塊命名。不過，如果您想根據相同檢視區塊建立多個探索，可以將 from 參數新增至探索。在這種情況下，您可以為探索內容指定任何有效名稱，包括小寫字母 (a-z)、數字 (0-9) 和底線。

explore 在 Looker 產生的 SQL 中扮演重要角色。假設使用者從「探索」選單選擇「客戶」並執行查詢。這個「探索」customers是以名為「customers」的檢視區塊為基礎，該檢視區塊與資料庫資料表相關聯。該資料表會放在使用者 SQL 查詢的 FROM 子句中。

explore 可以有多個子參數，這些參數會影響顯示和篩選行為，並指定要為「探索」新增聯結。如果探索包含一或多個聯結，這些聯結可以有聯結參數，指定偏好的聯結行為。

範例

根據名為 users 的檢視區塊，在「探索」選單中新增選項：

explore: users {
  # additional explore parameters go here
}

根據名為「user_events」的檢視畫面，在「探索」選單中新增名為「事件」的選項：

explore: events {
  from: user_events
}

常見挑戰

explore 必須參照現有檢視區塊名稱

您無法使用 explore 參數定義資料庫資料表、維度、指標，以及檢視表中的其他欄位。請先使用 view 參數定義檢視區塊，然後，您可以在 explore 中參照該檢視區塊的名稱。

explore 必須參照檢視區塊名稱，而非檔案名稱

一般來說，檢視區塊的名稱與定義檢視區塊的檢視區塊檔案相同。這並非必要步驟，檢視名稱和檢視檔案名稱可以不同。

舉例來說，您在名為 company_users 的檔案中定義了名為 users 的檢視區塊。檢視檔案 company_users 如下所示：

view: users { ... }

然後使用下列程式碼，將 users 檢視畫面新增至「探索」選單：

explore: users { ... }

即使 users 檢視畫面位於名為 company_users 的檔案中，檔案名稱也不重要。view 參數中只有檢視區塊名稱有意義。

在「探索」中使用 type: count 的測量時，視覺化會以檢視區塊名稱標示結果值，而非「計數」。為避免混淆，建議您將檢視名稱設為複數，在視覺化設定中選取「顯示完整欄位名稱」「系列」下方，或使用 view_label，並將檢視名稱設為複數。

注意事項

explore 通常會與其他參數搭配使用

您可以單獨使用 explore，不必搭配其他參數。在實務上，您通常會看到 explore 與其他選項搭配使用。舉例來說，很常會將其他檢視區塊join探索。

與 explore 相關聯的所有其他參數都會顯示在「探索參數」頁面。「彙整參數」頁面會顯示探索中可用的 join 參數。