Search query - granularity - required? optional?

[jbguerraz]

Affected Version

0.20.0

Description

https://druid.apache.org/docs/latest/querying/searchquery.html says the Granularity is mandatory but if we don't provide it, it works. Is that a documentation typo ?

Query:

{
  "dataSource": {
    "name": "wikipedia",
    "type": "table"
  },
  "filter": {
    "dimension": "countryName",
    "extractionFn": null,
    "type": "selector",
    "value": "France"
  },
  "intervals": [
    "2016-06-26T23:54:05.880Z/2016-06-27T21:07:39.779Z"
  ],
  "query": {
    "type": "contains",
    "value": "ari"
  },
  "queryType": "search",
  "searchDimensions": [
    {
      "dimension": "regionName",
      "outputType": "STRING",
      "type": "default"
    }
  ]
}

Execution:

› curl -s 'http://localhost:8888/druid/v2' -H 'Content-Type: application/json;charset=UTF-8' --data-binary '{"dataSource":{"name":"wikipedia","type":"table"},"filter":{"dimension":"countryName","extractionFn":null,"type":"selector","value":"France"},"intervals":["2016-06-26T23:54:05.880Z/2016-06-27T21:07:39.779Z"],"query":{"type":"contains","value":"ari"},"queryType":"search","searchDimensions":[{"dimension":"regionName","outputType":"STRING","type":"default"}]}' | jq
[
  {
    "timestamp": "2016-06-27T00:00:00.000Z",
    "result": [
      {
        "dimension": "regionName",
        "value": "Paris",
        "count": 14
      }
    ]
  }
]

[FrankChen021]

It's not mandatory, if it's not provided, its default value is ALL. The doc needs to be updated.