always_filter

사용

explore: explore_name {
  always_filter:  {
    filters:  [field_name: "filter expression", field_name: "filter expression", ...]
  }
}
계층 구조
explore
always_filter
기본값
없음

수락
필드 이름과 Looker 필터 표현식

정의

always_filter 매개변수를 사용하면 사용자가 Explore에 필터 세트를 포함하도록 요구할 수 있습니다. always_filter 매개변수를 사용하여 필터와 기본값을 정의하면 Explore에 구성된 필터 설정이 자동으로 표시됩니다.

always_filter 매개변수에 지정한 필터는 Explore에서 삭제할 수 없습니다. 하지만 사용자는 필터의 값을 변경하거나 조건 드롭다운 메뉴에서 필터의 조건을 변경하여 필터를 수정할 수 있습니다. 사용자가 필터에서 모든 값을 삭제할 수도 있으며, 이는 필터를 삭제하는 것과 동일한 효과를 갖습니다.

수정하거나 삭제할 수 없는 필터가 Explore에 포함되도록 하려면 다음 매개변수 중 하나를 대신 사용하세요.

  • 모든 사용자에게 동일하고 어떤 방식으로도 보거나 변경할 수 없는 필터를 구성하려면 sql_always_where를 사용하면 됩니다.
  • 각 사용자에게만 적용되고 어떤 방식으로도 보거나 변경할 수 없는 필터를 구성하려면 access_filter를 사용하면 됩니다.

always_filter 매개변수에서 filters 하위 매개변수에서 참조되는 필드는 측정기준, 측정항목, 필터 또는 매개변수일 수 있습니다. 이 Explore의 일부가 아닌 조인된 뷰의 일부인 측정기준 또는 측정값을 참조해야 하는 경우 view_name.field_name를 사용하세요. 예를 들면 다음과 같습니다.

explore: order {
  always_filter: {
    filters: [id: "123", customer.id: "789"]
  }
  join: customer {
    sql_on: ${order.customer_id} = ${customer.id} ;;
  }
}

여기서 id 필터는 order의 id 필드를 참조합니다. customer.id 필터는 customer의 id 필드를 참조합니다. 이 예에서는 여러 필터를 추가할 수 있다는 점도 보여줍니다.

각 field_name: "filter expression" 쌍의 경우 필터링하는 필드의 유형에 따라 필터 표현식이 절대값일 수도 있고 Looker 필터 표현식을 사용할 수도 있습니다.

예시

주문 ID 필드에서 Explore의 기본 필터를 구성합니다('123' 기본값).

explore: order {
  always_filter: {
    filters: [id: "123"]
  }
}

주문 생성일 필드에 Explore의 기본 필터를 구성합니다 (기본값은 지난 7일).

explore: order {
  always_filter: {
    filters: [created_date: "7 days"]
  }
}

주문 ID 필드('123' 기본값), 주문 도시 필드('Chicago' 기본값), 고객 연령 필드 (18 이상 기본값)의 Explore에 기본 필터를 구성합니다.

explore: order {
  always_filter: {
    filters: [id: "123", city: "Chicago", customer.age: ">=18"]
  }
  join: customer {
    sql_on: ${order.customer_id} = ${customer.id} ;;
  }
}

고려사항

사용자는 always_filter로 지정된 필터를 삭제할 수 없습니다.

사용자가 쿼리의 조건이나 기본값을 변경할 수는 있지만 always_filter에서 추가한 필터를 삭제할 수는 없습니다. 사용자가 필터를 완전히 삭제할 수 있는 방식으로 Explore의 필터를 미리 로드하려면 추천 필터가 포함된 쿼리를 만든 다음 사용자가 쿼리와 필터를 시작점으로 사용할 수 있도록 쿼리를 공유하세요.

빈 기본값 설정

빈 기본값이 있는 기본 필터를 만들려면 필터 값에 "-EMPTY"를 지정하면 됩니다.

always_filter: {
  filters: [products.category: "-EMPTY"]
}

always_filter 매개변수는 default_value 필터 설정을 재정의합니다.

always_filter 매개변수는 필드의 default_value 설정을 재정의합니다. always_filter로 값을 선언하면 탐색에서 해당 값이 기본값이 됩니다. always_filter로 값을 선언하지 않으면 탐색에서 '값 상관없음'이 필터 기본값입니다.

always_filter는 기존 Look 및 대시보드 타일에 영향을 미칩니다.

기존 explore 정의에 always_filter 매개변수를 추가하면 해당 explore를 기반으로 하는 모든 Look, Explore 또는 대시보드 타일에 기본값이 있는 필터 집합이 추가됩니다. 여기에는 explore를 기반으로 하는 이전에 저장된 Look 및 대시보드 타일이 포함됩니다.