TermFilter document (Data API 18.6)

Document representing a term filter.

A term filter allows you to restrict a search result to hits that match (exactly) one of the values configured for the filter. A term filter is useful for general restrictions that can be shared between searches. Use term filters whenever the criteria you filter on is a shared property of multiple searches (for example, like filtering by an order status). Use term filters for fields that have a discrete and small set of values only.

Example: (id="my_id")

    query: {
        filtered_query: {
            query: { match_all_query: {} },
            filter: {
                term_filter: {
                    field: "id",
                    operator: "is",
                    values: ["my_id"]
                }
            }
        }
    }
 

Example: (id IN ("my_id","other_id"))

    query: {
        filtered_query: {
            query: { match_all_query: {} },
            filter: {
                term_filter: {
                    field: "id",
                    operator: "one_of",
                    values: ["my_id","other_id"]
                }
            }
        }
    }
 

Example: (description=NULL)

    query: {
        filtered_query: {
            query: { match_all_query: {} },
            filter: {
                term_filter: {
                    field: "description",
                    operator: "is_null"
                }
            }
        }
    }