The JSON Query DSL provides a simple yet powerful query language for the JSON Request API.
Structure of JSON Query DSL
A JSON query can be:
-
A valid query string for default
deftype
(the standard query parser in most cases), as in,title:solr
. -
A valid local parameters query string, as in,
{!dismax qf=myfield}solr rocks
. -
A JSON object with query parser name and arguments. The special key
v
in local parameters is replaced by keyquery
in JSON object query, as in this example:
{
"query-parser-name" : {
"param1": "value1",
"param2": "value2",
"query": "a-json-query",
"another-param": "another-json-query"
}
}
Basic Examples
The four requests below are equivalent for searching for solr lucene
in a field named content
:
-
Passing all parameters on URI, with "lucene" as the default query parser.
curl -XGET "http://localhost:8983/solr/books/query?q=content:(solr lucene)"
-
Using the JSON Query DSL with valid query string for default
deftype
, with "lucene" as default query parser.curl -XGET http://localhost:8983/solr/books/query -d ' {"query": "content:(solr lucene)"}'
-
Using JSON Query DSL with valid local parameters query defining the "lucene" query parser.
curl -XGET http://localhost:8983/solr/books/query -d ' {"query": "{!lucene df=content v='solr lucene'}"}'
-
Using JSON Query DSL in verbose way, as a valid JSON object with parser name and arguments.
curl -XGET http://localhost:8983/solr/books/query -d ' {"query": {"lucene": { "df": "content", "query": "solr lucene" } }}'
Note that the JSON query in the examples above is provided under the key query
of JSON Request API.
Nested Queries
Some query parsers accept a query as an argument. JSON Query DSL makes it easier to write and read such complex query.
The three requests below are equivalent for wrapping the above example query (searching for solr lucene
in field content
) with a boost query:
-
Passing all parameters on URI.
http://localhost:8983/solr/books/query?q={!boost b=log(popularity) v='{!lucene df=content}(lucene solr)'}
-
Converted into JSON Query DSL with use of local parameters. As you can see, the special key
v
is replaced by keyquery
.curl -XGET http://localhost:8983/solr/books/query -d ' { "query" : { "boost": { "query": {!lucene df=content}(lucene solr), "b": "log(popularity)" } } }'
-
Using a verbose JSON Query DSL without local parameters.
curl -XGET http://localhost:8983/solr/books/query -d ' { "query": { "boost": { "query": { "lucene": { "df": "content", "query": "solr lucene" } }, "b": "log(popularity)" } } }'
Compound Queries
With the support of the BoolQParser, the JSON Query DSL can create a very powerful nested query.
This query searches for books where content
contains lucene
or solr
, title
contains solr
and their ranking
must larger than 3.0:
curl -XGET http://localhost:8983/solr/books/query -d '
{
"query": {
"bool": {
"must": [
"title:solr",
{"lucene": {"df: "content", query: "lucene solr"}}
],
"must_not": [
{"frange": {"u": "3.0", query: "ranking"}}
]
}
}
}'
If lucene is the default query parser query, the above can be rewritten in much less verbose way as in:
curl -XGET http://localhost:8983/solr/books/query -d '
{
"query": {
"bool": {
"must": [
"title:solr",
"content:(lucene solr)"
],
"must_not": "{!frange u:3.0}ranking"
}
}
}'
Use JSON Query DSL in JSON Request API
JSON Query DSL is not only supported with the key query
but also with the key filter
of the JSON Request API.
For example, the above query can be rewritten using filter clause like this:
curl -XGET http://localhost:8983/solr/books/query -d '
{
"query": {
"bool": {
"must_not": "{!frange u:3.0}ranking"
}
},
"filter: [
"title:solr",
{ "lucene" : {"df: "content", query : "lucene solr" }}
]
}'
We welcome feedback on Solr documentation. However, we cannot provide application support via comments. If you need help, please send a message to the Solr User mailing list.