Package org.apache.druid.query.filter

Class TypedInFilter

  • All Implemented Interfaces:
    Cacheable, DimFilter, Filter
    public class TypedInFilter
extends AbstractOptimizableDimFilter
implements Filter
    Approximately like the SQL 'IN' filter, with the main difference being that this will match NULL values if contained in the values list instead of ignoring them.

    This is a typed version of InDimFilter, which allows the match values to exist in their native type and sorted in their type native order for better performance matching against all column types.

    • Constructor Detail

      • TypedInFilter

        public TypedInFilter​(String column,
                     ColumnType matchValueType,
                     @Nullable
                     List<?> values,
                     @Nullable
                     List<?> sortedValues,
                     @Nullable
                     FilterTuning filterTuning)
        Creates a new filter.
        Parameters:
        column - column to search
        values - set of values to match, may or may not be sorted.
        sortedValues - set of values to match this is sorted in matchValueType order. These values absolutely must be sorted in the specified order for proper operation. This value is computed from values to be used 'downstream' to avoid repeating the work of sorting and checking for sortedness over and over.
        matchValueType - type of values contained in values/sortedValues
        filterTuning - optional tuning

    • Method Detail

      • getColumn

        public String getColumn()

      • getSortedValues

        public List<?> getSortedValues()

      • getMatchValueType

        public ColumnType getMatchValueType()

      • getCacheKey

        public byte[] getCacheKey()
        Description copied from interface: Cacheable
        Get a byte array used as a cache key.
        Specified by:
        getCacheKey in interface Cacheable
        Returns:
        a cache key

      • toFilter

        public Filter toFilter()
        Description copied from interface: DimFilter
        Returns a Filter that implements this DimFilter. This does not generally involve optimizing the DimFilter, so it does make sense to optimize first and then call toFilter on the resulting DimFilter.
        Specified by:
        toFilter in interface DimFilter
        Returns:
        a Filter that implements this DimFilter, or null if this DimFilter is a no-op.

      • getDimensionRangeSet

        @Nullable
public com.google.common.collect.RangeSet<String> getDimensionRangeSet​(String dimension)
        Description copied from interface: DimFilter
        Returns a RangeSet that represents the possible range of the input dimension for this DimFilter.This is applicable to filters that use dimensions such as select, in, bound, and logical filters such as and, or, not. Null represents that the range cannot be determined, and will be returned for filters such as javascript and regex where there's no easy way to determine the filtered range. It is treated the same way as an all range in most cases, however there are some subtle difference at logical filters such as not filter, where complement of all is nothing while complement of null is still null.
        Specified by:
        getDimensionRangeSet in interface DimFilter
        Parameters:
        dimension - name of the dimension to get range for
        Returns:
        a RangeSet that represent the possible range of the input dimension, or null if it is not possible to determine for this DimFilter.

      • getRequiredColumns

        public Set<String> getRequiredColumns()
        Description copied from interface: Filter
        Set of columns used by a filter.
        Specified by:
        getRequiredColumns in interface DimFilter
        Specified by:
        getRequiredColumns in interface Filter
        Returns:
        a HashSet that represents all columns' name which the DimFilter required to do filter.

      • makeMatcher

        public ValueMatcher makeMatcher​(ColumnSelectorFactory factory)
        Description copied from interface: Filter
        Get a ValueMatcher that applies this filter to row values.
        Specified by:
        makeMatcher in interface Filter
        Parameters:
        factory - Object used to create ValueMatchers
        Returns:
        ValueMatcher that applies this filter to row values.

      • canVectorizeMatcher

        public boolean canVectorizeMatcher​(ColumnInspector inspector)
        Description copied from interface: Filter
        Returns true if this filter can produce a vectorized matcher from its "makeVectorMatcher" method.
        Specified by:
        canVectorizeMatcher in interface Filter
        Parameters:
        inspector - Supplies type information for the selectors this filter will match against

      • supportsRequiredColumnRewrite

        public boolean supportsRequiredColumnRewrite()
        Description copied from interface: Filter
        Returns true is this filter is able to return a copy of this filter that is identical to this filter except that it operates on different columns, based on a renaming map.
        Specified by:
        supportsRequiredColumnRewrite in interface Filter

      • rewriteRequiredColumns

        public Filter rewriteRequiredColumns​(Map<String,​String> columnRewrites)
        Description copied from interface: Filter
        Return a copy of this filter that is identical to the this filter except that it operates on different columns, based on a renaming map where the key is the column to be renamed in the filter, and the value is the new column name. For example, if I have a filter (A = hello), and I have a renaming map (A -> B), this should return the filter (B = hello)
        Specified by:
        rewriteRequiredColumns in interface Filter
        Parameters:
        columnRewrites - Column rewrite map
        Returns:
        Copy of this filter that operates on new columns based on the rewrite map

      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class Object