사용
explore: explore_name {
always_filter: {
filters: [field_name: "filter expression", field_name: "filter expression", ...]
}
}
|
계층 구조
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"]
}
}
주문 생성일 필드(기본값은 이전 7일)와 불리언(type: yesno) 완료됨 필드(대소문자를 구분하는 기본값은 "No")에서 Explore의 기본 필터를 구성합니다.
explore: order {
always_filter: {
filters: [created_date: "7 days", is_complete: "No"]
}
}
주문 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 매개변수의 type: yesno 필드를 필터링할 때 불리언 필터 표현식은 대소문자를 구분하며 대문자("Yes" 또는 "No")여야 합니다. 이는 불리언 값에 대해 대소문자를 구분하지 않는 측정의 filters 하위 매개변수와 다릅니다.
사용자는 always_filter로 지정된 필터를 삭제할 수 없습니다.
사용자가 쿼리의 조건이나 기본값을 변경할 수는 있지만 always_filter에서 추가한 필터를 삭제할 수는 없습니다. 사용자가 필터를 완전히 삭제할 수 있는 방식으로 Explore의 필터를 미리 로드하려면 추천 필터가 포함된 쿼리를 만든 다음 사용자가 쿼리와 필터를 시작점으로 사용할 수 있도록 쿼리를 공유하는 것이 좋습니다.
빈 기본값 설정
공백 기본값으로 기본 필터를 만들려면 필터 값에 "-EMPTY"를 지정하면 됩니다.
always_filter: {
filters: [products.category: "-EMPTY"]
}
always_filter 매개변수가 default_value 필터 설정을 재정의합니다.
always_filter 매개변수는 필드의 default_value 설정을 재정의합니다. always_filter로 값을 선언하면 해당 값이 Explore의 기본값이 됩니다. always_filter로 값을 선언하지 않으면 '값 상관없음'이 Explore의 필터 기본값입니다.
always_filter은 기존 Look 및 대시보드 타일에 영향을 미칩니다.
기존 explore 정의에 always_filter 매개변수를 추가하면 해당 explore를 기반으로 하는 모든 Look, Explore 또는 대시보드 타일에 기본값이 있는 필터 집합이 추가됩니다. 여기에는 이전에 저장된 Look과 explore를 기반으로 하는 대시보드 타일이 포함됩니다.