org.apache.druid.query.dimension.DimensionSpec Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of druid-processing Show documentation
Show all versions of druid-processing Show documentation
A module that is everything required to understands Druid Segments
/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*/
package org.apache.druid.query.dimension;
import com.fasterxml.jackson.annotation.JsonSubTypes;
import com.fasterxml.jackson.annotation.JsonTypeInfo;
import org.apache.druid.annotations.SubclassesMustOverrideEqualsAndHashCode;
import org.apache.druid.java.util.common.Cacheable;
import org.apache.druid.java.util.common.UOE;
import org.apache.druid.query.extraction.ExtractionFn;
import org.apache.druid.segment.DimensionSelector;
import org.apache.druid.segment.column.ColumnType;
import org.apache.druid.segment.vector.MultiValueDimensionVectorSelector;
import org.apache.druid.segment.vector.SingleValueDimensionVectorSelector;
import javax.annotation.Nullable;
/**
* Provides information about a dimension for a grouping query, like topN or groupBy. Note that this is not annotated
* with {@code PublicApi}, since it is not meant to be stable for usage by non-built-in queries.
*/
@JsonTypeInfo(use = JsonTypeInfo.Id.NAME, property = "type", defaultImpl = LegacyDimensionSpec.class)
@JsonSubTypes(value = {
@JsonSubTypes.Type(name = "default", value = DefaultDimensionSpec.class),
@JsonSubTypes.Type(name = "extraction", value = ExtractionDimensionSpec.class),
@JsonSubTypes.Type(name = "regexFiltered", value = RegexFilteredDimensionSpec.class),
@JsonSubTypes.Type(name = "listFiltered", value = ListFilteredDimensionSpec.class),
@JsonSubTypes.Type(name = "prefixFiltered", value = PrefixFilteredDimensionSpec.class)
})
@SubclassesMustOverrideEqualsAndHashCode
public interface DimensionSpec extends Cacheable
{
String getDimension();
String getOutputName();
ColumnType getOutputType();
//ExtractionFn can be implemented with decorate(..) fn
@Deprecated
@Nullable
ExtractionFn getExtractionFn();
/**
* Decorate a {@link DimensionSelector}, allowing custom transformation of underlying behavior (e.g. performing
* extraction functions in the case of {@link ExtractionDimensionSpec}, regex filtering in the case of
* {@link RegexFilteredDimensionSpec}, and so on).
*/
DimensionSelector decorate(DimensionSelector selector);
/**
* Vectorized analog of {@link #decorate(DimensionSelector)} for {@link SingleValueDimensionVectorSelector}, most
* likely produced with
* {@link org.apache.druid.segment.vector.VectorColumnSelectorFactory#makeSingleValueDimensionSelector(DimensionSpec)}
*
* Decoration allows a {@link DimensionSpec} to customize the behavior of the underlying selector, for example
* transforming or filtering values.
*/
default SingleValueDimensionVectorSelector decorate(SingleValueDimensionVectorSelector selector)
{
throw new UOE("DimensionSpec[%s] cannot vectorize", getClass().getName());
}
/**
* Vectorized analog of {@link #decorate(DimensionSelector) for {@link MultiValueDimensionVectorSelector}, most likely
* produced with
* {@link org.apache.druid.segment.vector.VectorColumnSelectorFactory#makeMultiValueDimensionSelector(DimensionSpec)}
*
* Decoration allows a {@link DimensionSpec} to customize the behavior of the underlying selector, for example
* transforming or filtering values.
*/
default MultiValueDimensionVectorSelector decorate(MultiValueDimensionVectorSelector selector)
{
throw new UOE("DimensionSpec[%s] cannot vectorize", getClass().getName());
}
/**
* Does this DimensionSpec require that decorate() be called to produce correct results?
*/
boolean mustDecorate();
/**
* Does this DimensionSpec have working {@link #decorate(SingleValueDimensionVectorSelector)} and
* {@link #decorate(MultiValueDimensionVectorSelector)} methods?
*/
default boolean canVectorize()
{
return false;
}
/**
* If the {@link #decorate} methods alter the underlying behavior of the dimension selector, does this alteration
* preserve the original ordering?
*/
boolean preservesOrdering();
/**
* Returns a copy of this DimensionSpec with the underlying dimension (the value of {@link #getDimension()})
* replaced by "newDimension".
*/
DimensionSpec withDimension(String newDimension);
}