Add timestampSpec to metadata.drd and SegmentMetadataQuery (apache#3227)

* save TimestampSpec in metadata.drd

* add timestampSpec info in SegmentMetadataQuery

api/src/main/java/io/druid/data/input/impl/TimestampSpec.java

@@ -23,7 +23,9 @@
 import com.metamx.common.parsers.TimestampParser;
 import org.joda.time.DateTime;
 
+import java.util.List;
 import java.util.Map;
+import java.util.Objects;
 
 /**
  */
@@ -130,4 +132,24 @@ public int hashCode()
     result = 31 * result + (missingValue != null ? missingValue.hashCode() : 0);
     return result;
   }
+
+  //simple merge strategy on timestampSpec that checks if all are equal or else
+  //returns null. this can be improved in future but is good enough for most use-cases.
+  public static TimestampSpec mergeTimestampSpec(List<TimestampSpec> toMerge) {
+    if (toMerge == null || toMerge.size() == 0) {
+      return null;
+    }
+
+    TimestampSpec result = toMerge.get(0);
+    for (int i = 1; i < toMerge.size(); i++) {
+      if (toMerge.get(i) == null) {
+        continue;
+      }
+      if (!Objects.equals(result, toMerge.get(i))) {
+        return null;
+      }
+    }
+
+    return result;
+  }
 }

docs/content/querying/segmentmetadataquery.md

@@ -126,6 +126,10 @@ dimension columns.
 
 * `intervals` in the result will contain the list of intervals associated with the queried segments.
 
+#### timestampSpec
+
+* `timestampSpec` in the result will contain timestampSpec of data stored in segments. this can be null if timestampSpec of segments was unknown or unmergeable (if merging is enabled).
+
 #### queryGranularity
 
 * `queryGranularity` in the result will contain query granularity of data stored in segments. this can be null if query granularity of segments was unknown or unmergeable (if merging is enabled).

indexing-hadoop/src/main/java/io/druid/indexer/IndexGeneratorJob.java

@@ -222,6 +222,7 @@ private static IncrementalIndex makeIncrementalIndex(
     final HadoopTuningConfig tuningConfig = config.getSchema().getTuningConfig();
     final IncrementalIndexSchema indexSchema = new IncrementalIndexSchema.Builder()
         .withMinTimestamp(theBucket.time.getMillis())
+        .withTimestampSpec(config.getSchema().getDataSchema().getParser().getParseSpec().getTimestampSpec())
         .withDimensionsSpec(config.getSchema().getDataSchema().getParser())
         .withQueryGranularity(config.getSchema().getDataSchema().getGranularitySpec().getQueryGranularity())
         .withMetrics(aggs)

processing/src/main/java/io/druid/query/metadata/SegmentMetadataQueryQueryToolChest.java

@@ -37,6 +37,7 @@
 import com.metamx.emitter.service.ServiceMetricEvent;
 import io.druid.common.guava.CombiningSequence;
 import io.druid.common.utils.JodaUtils;
+import io.druid.data.input.impl.TimestampSpec;
 import io.druid.granularity.QueryGranularity;
 import io.druid.query.CacheStrategy;
 import io.druid.query.DruidMetrics;
@@ -332,6 +333,13 @@ public static SegmentAnalysis mergeAnalyses(
       }
     }
 
+    final TimestampSpec timestampSpec = TimestampSpec.mergeTimestampSpec(
+        Lists.newArrayList(
+            arg1.getTimestampSpec(),
+            arg2.getTimestampSpec()
+        )
+    );
+
     final QueryGranularity queryGranularity = QueryGranularity.mergeQueryGranularities(
         Lists.newArrayList(
             arg1.getQueryGranularity(),
@@ -354,6 +362,7 @@ public static SegmentAnalysis mergeAnalyses(
         arg1.getSize() + arg2.getSize(),
         arg1.getNumRows() + arg2.getNumRows(),
         aggregators.isEmpty() ? null : aggregators,
+        timestampSpec,
         queryGranularity
     );
   }
@@ -368,6 +377,7 @@ public static SegmentAnalysis finalizeAnalysis(SegmentAnalysis analysis)
         analysis.getSize(),
         analysis.getNumRows(),
         analysis.getAggregators(),
+        analysis.getTimestampSpec(),
         analysis.getQueryGranularity()
     );
   }

processing/src/main/java/io/druid/query/metadata/SegmentMetadataQueryRunnerFactory.java

@@ -29,6 +29,7 @@
 import com.metamx.common.guava.Sequence;
 import com.metamx.common.guava.Sequences;
 import com.metamx.common.logger.Logger;
+import io.druid.data.input.impl.TimestampSpec;
 import io.druid.granularity.QueryGranularity;
 import io.druid.query.AbstractPrioritizedCallable;
 import io.druid.query.BaseQuery;
@@ -127,6 +128,16 @@ public Sequence<SegmentAnalysis> run(Query<SegmentAnalysis> inQ, Map<String, Obj
           aggregators = null;
         }
 
+        final TimestampSpec timestampSpec;
+        if (query.hasTimestampSpec()) {
+          if (metadata == null) {
+            metadata = segment.asStorageAdapter().getMetadata();
+          }
+          timestampSpec = metadata != null ? metadata.getTimestampSpec() : null;
+        } else {
+          timestampSpec = null;
+        }
+
         final QueryGranularity queryGranularity;
         if (query.hasQueryGranularity()) {
           if (metadata == null) {
@@ -146,6 +157,7 @@ public Sequence<SegmentAnalysis> run(Query<SegmentAnalysis> inQ, Map<String, Obj
                     totalSize,
                     numRows,
                     aggregators,
+                    timestampSpec,
                     queryGranularity
                 )
             )

processing/src/main/java/io/druid/query/metadata/metadata/SegmentAnalysis.java

@@ -21,6 +21,7 @@
 
 import com.fasterxml.jackson.annotation.JsonCreator;
 import com.fasterxml.jackson.annotation.JsonProperty;
+import io.druid.data.input.impl.TimestampSpec;
 import io.druid.granularity.QueryGranularity;
 import io.druid.query.aggregation.AggregatorFactory;
 import org.joda.time.Interval;
@@ -37,6 +38,7 @@ public class SegmentAnalysis implements Comparable<SegmentAnalysis>
   private final long size;
   private final long numRows;
   private final Map<String, AggregatorFactory> aggregators;
+  private final TimestampSpec timestampSpec;
   private final QueryGranularity queryGranularity;
 
   @JsonCreator
@@ -47,6 +49,7 @@ public SegmentAnalysis(
       @JsonProperty("size") long size,
       @JsonProperty("numRows") long numRows,
       @JsonProperty("aggregators") Map<String, AggregatorFactory> aggregators,
+      @JsonProperty("timestampSpec") TimestampSpec timestampSpec,
       @JsonProperty("queryGranularity") QueryGranularity queryGranularity
   )
   {
@@ -56,6 +59,7 @@ public SegmentAnalysis(
     this.size = size;
     this.numRows = numRows;
     this.aggregators = aggregators;
+    this.timestampSpec = timestampSpec;
     this.queryGranularity = queryGranularity;
   }
 
@@ -89,6 +93,12 @@ public long getNumRows()
     return numRows;
   }
 
+  @JsonProperty
+  public TimestampSpec getTimestampSpec()
+  {
+    return timestampSpec;
+  }
+
   @JsonProperty
   public QueryGranularity getQueryGranularity()
   {
@@ -111,6 +121,7 @@ public String toString()
            ", size=" + size +
            ", numRows=" + numRows +
            ", aggregators=" + aggregators +
+           ", timestampSpec=" + timestampSpec +
            ", queryGranularity=" + queryGranularity +
            '}';
   }
@@ -134,6 +145,7 @@ public boolean equals(Object o)
            Objects.equals(interval, that.interval) &&
            Objects.equals(columns, that.columns) &&
            Objects.equals(aggregators, that.aggregators) &&
+           Objects.equals(timestampSpec, that.timestampSpec) &&
            Objects.equals(queryGranularity, that.queryGranularity);
   }
 
@@ -144,7 +156,7 @@ public boolean equals(Object o)
   @Override
   public int hashCode()
   {
-    return Objects.hash(id, interval, columns, size, numRows, aggregators, queryGranularity);
+    return Objects.hash(id, interval, columns, size, numRows, aggregators, timestampSpec, queryGranularity);
   }
 
   @Override

processing/src/main/java/io/druid/query/metadata/metadata/SegmentMetadataQuery.java

@@ -57,6 +57,7 @@ public enum AnalysisType
     INTERVAL,
     AGGREGATORS,
     MINMAX,
+    TIMESTAMPSPEC,
     QUERYGRANULARITY;
 
     @JsonValue
@@ -188,6 +189,11 @@ public boolean hasAggregators()
     return analysisTypes.contains(AnalysisType.AGGREGATORS);
   }
 
+  public boolean hasTimestampSpec()
+  {
+    return analysisTypes.contains(AnalysisType.TIMESTAMPSPEC);
+  }
+
   public boolean hasQueryGranularity()
   {
     return analysisTypes.contains(AnalysisType.QUERYGRANULARITY);

processing/src/main/java/io/druid/segment/Metadata.java

@@ -20,6 +20,7 @@
 package io.druid.segment;
 
 import com.fasterxml.jackson.annotation.JsonProperty;
+import io.druid.data.input.impl.TimestampSpec;
 import io.druid.granularity.QueryGranularity;
 import io.druid.query.aggregation.AggregatorFactory;
 
@@ -42,6 +43,9 @@ public class Metadata
   @JsonProperty
   private AggregatorFactory[] aggregators;
 
+  @JsonProperty
+  private TimestampSpec timestampSpec;
+
   @JsonProperty
   private QueryGranularity queryGranularity;
 
@@ -61,6 +65,17 @@ public Metadata setAggregators(AggregatorFactory[] aggregators)
     return this;
   }
 
+  public TimestampSpec getTimestampSpec()
+  {
+    return timestampSpec;
+  }
+
+  public Metadata setTimestampSpec(TimestampSpec timestampSpec)
+  {
+    this.timestampSpec = timestampSpec;
+    return this;
+  }
+
   public QueryGranularity getQueryGranularity()
   {
     return queryGranularity;
@@ -111,6 +126,7 @@ public static Metadata merge(
                                                    ? new ArrayList<AggregatorFactory[]>()
                                                    : null;
 
+    List<TimestampSpec> timestampSpecsToMerge = new ArrayList<>();
     List<QueryGranularity> gransToMerge = new ArrayList<>();
 
     for (Metadata metadata : toBeMerged) {
@@ -120,6 +136,10 @@ public static Metadata merge(
           aggregatorsToMerge.add(metadata.getAggregators());
         }
 
+        if (timestampSpecsToMerge != null && metadata.getTimestampSpec() != null) {
+          timestampSpecsToMerge.add(metadata.getTimestampSpec());
+        }
+
         if (gransToMerge != null) {
           gransToMerge.add(metadata.getQueryGranularity());
         }
@@ -128,6 +148,7 @@ public static Metadata merge(
         //if metadata and hence aggregators and queryGranularity for some segment being merged are unknown then
         //final merged segment should not have same in metadata
         aggregatorsToMerge = null;
+        timestampSpecsToMerge = null;
         gransToMerge = null;
       }
     }
@@ -143,6 +164,10 @@ public static Metadata merge(
       result.setAggregators(overrideMergedAggregators);
     }
 
+    if (timestampSpecsToMerge != null) {
+      result.setTimestampSpec(TimestampSpec.mergeTimestampSpec(timestampSpecsToMerge));
+    }
+
     if (gransToMerge != null) {
       result.setQueryGranularity(QueryGranularity.mergeQueryGranularities(gransToMerge));
     }
@@ -171,17 +196,21 @@ public boolean equals(Object o)
     if (!Arrays.equals(aggregators, metadata.aggregators)) {
       return false;
     }
-    return !(queryGranularity != null
-             ? !queryGranularity.equals(metadata.queryGranularity)
-             : metadata.queryGranularity != null);
+    if (timestampSpec != null ? !timestampSpec.equals(metadata.timestampSpec) : metadata.timestampSpec != null) {
+      return false;
+    }
+    return queryGranularity != null
+           ? queryGranularity.equals(metadata.queryGranularity)
+           : metadata.queryGranularity == null;
 
   }
 
   @Override
   public int hashCode()
   {
     int result = container.hashCode();
-    result = 31 * result + (aggregators != null ? Arrays.hashCode(aggregators) : 0);
+    result = 31 * result + Arrays.hashCode(aggregators);
+    result = 31 * result + (timestampSpec != null ? timestampSpec.hashCode() : 0);
     result = 31 * result + (queryGranularity != null ? queryGranularity.hashCode() : 0);
     return result;
   }
@@ -190,9 +219,9 @@ public int hashCode()
   public String toString()
   {
     return "Metadata{" +
-
            "container=" + container +
            ", aggregators=" + Arrays.toString(aggregators) +
+           ", timestampSpec=" + timestampSpec +
            ", queryGranularity=" + queryGranularity +
            '}';
   }

processing/src/main/java/io/druid/segment/incremental/IncrementalIndex.java

@@ -410,6 +410,7 @@ public IncrementalIndex(
 
     this.metadata = new Metadata()
         .setAggregators(getCombiningAggregators(metrics))
+        .setTimestampSpec(incrementalIndexSchema.getTimestampSpec())
         .setQueryGranularity(this.gran);
 
     this.aggs = initAggs(metrics, rowSupplier, deserializeComplexMetrics);