Advanced Syntax Search
Notes:
- Introduced in GitLab Enterprise Starter 9.2
- This is the user documentation. To install and configure Elasticsearch, visit the admin docs.
Use advanced queries for more targeted search results.
Overview
The Advanced Syntax Search is a subset of the Advanced Global Search, which you can use if you want to have more specific search results.
Use cases
Let's say for example that the product you develop relies on the code of another product that's hosted under some other group.
Since under your GitLab instance there are hosted hundreds of different projects, you need the search results to be as efficient as possible. You have a feeling of what you want to find (e.g., a function name), but at the same you're also not so sure.
In that case, using the regular expressions in your query will yield much better results.
Using the Advanced Syntax Search
The Advanced Syntax Search supports queries of ranges, wildcards, regular expressions, fuzziness and much more.
Full details can be found in the Elasticsearch documentation, but here's a quick guide:
- Searches look for all the words in a query, in any order - e.g.: searching
issues for
display bugwill return all issues matching both those words, in any order. - To find the exact term, use double quotes:
"display bug" - To find bugs not mentioning display, use
-:bug -display - To find a bug in display or sound, use
|:bug display | sound - To group terms together, use parentheses:
bug | (display +sound) - To match a partial word, use
*:bug find_by_* - To find a term containing one of these symbols, use
\:argument \-last - To limit the results based on the time "created_at:[2012-01-01 TO 2012-12-31]" and other sweet stuff