Looker 篩選運算式

篩選運算式是篩選 Looker 查詢的進階方式。您可以使用下列方式使用篩選器運算式：

• 在 Looker 的「探索」部分中，您可以新增篩選器，選擇「比對 (進階)」選項，然後輸入此頁面所列的篩選器類型的其中一個運算式，做為篩選器值。
• 在使用 filter 參數的 LookML 元素中。

本頁面列出 Looker Explore 中使用「相符 (進階)」條件選項的篩選器可輸入的值。視篩選器類型和您輸入的篩選器值而定，Looker 可能會將「相符 (進階)」選項轉換為更適當的篩選器條件。

篩選運算式相關注意事項

使用 Looker 篩選器運算式時，請注意下列事項：

• 當 Looker 連接器參照 Looker Explore 做為資料來源，且篩選器採用「相符 (進階)」條件時，Looker Studio 也支援此頁面的篩選器運算式，適用於某些篩選器類型。在 Looker Studio 中，相符 (進階) 條件的運作方式與 Looker 探索有所不同。Looker 可能會根據使用者的輸入內容，將「比對 (進階)」條件轉換為更合適的條件。不過，如果使用者輸入的內容不適合 Looker Studio 支援的其他篩選器條件，Looker Studio 會使用「符合條件 (進階)」選項做為萬用條件，但不會轉換條件。
• 在探索中，基本篩選器使用的某些詞彙與本頁說明的篩選器運算式意義不同。
• 在 LookML 中使用篩選運算式時，請將運算式放在引號內 (如要瞭解正確用法，請參閱 filters 說明文件頁面)。這對 NULL 等邏輯值來說尤其重要。在 Looker 的「探索」部分使用篩選運算式時，您不需要在運算式前後加上引號。
• 存取權授予不支援篩選器運算式。詳情請參閱 access_grant 說明文件頁面。

每種篩選器類型的篩選運算式

在 Looker 探索篩選器中使用「相符 (進階)」條件選項時，請輸入下列範例做為篩選器值。下列篩選器類型支援篩選運算式：

• 字串
• 日期與時間
• 布林
• Number
• 位置

字串

在字串篩選器中加入特殊字元

請注意在字串篩選器中加入特殊字元的規則：

• 如要加入 "、% 或 _，請在前置字串中加入逸出字元 ^。例如：^"、^% 和 ^_
• 如要加入開頭的 -，請以 ^- 加以逸出。只有在 - 為開頭字元時才需要使用這個選項；如果 - 位於字串內，則不需要逸出 -。
• 如要加入 ^，請以 ^^ 的形式加以逸出。
• 如要在一般 UI 字串篩選器中加入半形逗號，請在半形逗號前加上反斜線字元 \。例如：Santa Cruz\, CA。
• 如要在篩選器中使用「相符 (進階)」選項，並加入半形逗號，請在半形逗號前加上轉義字元 ^。例如：Santa Cruz^, CA。
• 如要在 LookML 的篩選運算式中加入半形逗號，請在前面加上逸出字元 ^。例如：

  field: filtered_count {
      type: count
      filters: [city: "Santa Cruz^, CA"]
    }

日期和時間

Looker 日期篩選功能可讓您使用英文詞組，而非 SQL 日期函式。

日期和時間篩選器的基本結構

以下列範例來說：

• {n} 為整數。

• {interval} 是時間增量，例如小時、天、週或月。

  您使用的措辭會決定 {interval} 是否會包含部分時間範圍，或是只包含完整時間範圍。舉例來說，運算式 3 days 包含目前的部分天數，以及前兩天的資料。運算式 3 days ago for 3 days 包含前三個完整天，但不包含目前的部分天。詳情請參閱「相對日期」一節。

• {time} 可指定格式為 YYYY-MM-DD HH:MM:SS 或 YYYY/MM/DD HH:MM:SS 的時間，或格式為 YYYY-MM-DD 或 YYYY/MM/DD 的日期。使用 YYYY-MM-DD 格式時，請務必在月份和日期中加入兩位數字，例如 2016-01。將月份或日期截斷為單一數字會解讀為偏移量，而非日期。舉例來說，2016-1 會解讀為 2016 減去 1 年，也就是 2015 年。

以下是日期篩選器的所有可能組合：

日期篩選器也可以合併使用：

• 如要使用 OR 邏輯：在同一個篩選器中輸入多個條件，並以半形逗號分隔。例如 today, 7 days ago 表示「今天或 7 天前」。
• 如要使用 AND 邏輯：請將條件逐一輸入多個日期或時間篩選器。舉例來說，您可以將 after 2014-01-01 放入「Created Date」篩選器，然後將 before 2 days ago 放入「Created Time」篩選器。這表示「2 天前之前和之後的 2014 年 1 月 1 日」。

絕對日期

絕對日期篩選器會使用特定日期值產生查詢結果。這類參數可用於建立特定日期範圍的查詢。

相對日期

相對日期篩選器可讓您建立查詢，其中的日期值會相對於目前日期。這類查詢會在每次執行時更新，因此非常實用。

在以下所有範例中，假設今天是 2018/05/18 星期五 18:30:02。在 Looker 中，週期從星期一開始，除非您使用 week_start_day 變更該設定。

秒

分鐘

小時

天

週

月

季

年

布林值

在 Looker 中依 true 或 false 類型值進行篩選時，您必須知道要與哪種 true 或 false 值互動。

數字

數字篩選器支援自然語言運算式 (例如 3 to 10) 和關係運算子 (例如 >20)。Looker 支援 OR 運算子，可用於表示多個篩選器範圍 (例如 3 to 10 OR 30 to 100)。AND 運算子可搭配關係運算子 (例如 >=3 AND <=10) 用於表示數值範圍，以便指定範圍。數字篩選器也可以使用代數間隔符號來篩選數值欄位。

位置

位置篩選運算式是以經緯度為依據，但可接受部分自然語言，用來定義限制搜尋範圍的方形和圓形。

支援的度量單位

如要篩選特定位置附近的區域，可以使用下列單位：

• 公尺
• 英尺
• 公里
• 英里

系統不支援單一測量單位。例如，篩選一英里半徑的範圍應寫為 within 1 miles of 36.97, -122.03。

使用者屬性值

如要在篩選運算式中使用使用者屬性的值，請使用資料庫方言所需的語法，透過 _user_attributes Liquid 變數參照使用者屬性：

{{ _user_attributes['name_of_attribute'] }}

舉例來說，假設您需要在 salesforce_username 使用者屬性的值上套用 sf_ 前置字串，因為值會以這種方式儲存在資料庫中。如要在使用者屬性值中加入前置字串，您可以在相關欄位上新增相符 (進階) 篩選器，並在篩選器運算式中使用 _user_attributes Liquid 變數，如下所示：

sf_{{_user_attributes['salesforce_username']}}

您可以使用相同的模式，將使用者屬性插入 LookML 資訊主頁篩選器和資訊主頁元素篩選器。