Versão do artigo: Enterprise Server 2.17
Entender a sintaxe de pesquisa
Durante a pesquisa no GitHub Enterprise, é possível criar consultas que correspondam a palavras e números específicos.
Consultar por valores maiores ou menores que outro valor
Você pode usar >, >=, < e <= para pesquisar valores que sejam maiores, maiores ou iguais, menores e menores ou iguais a outro valor.
| Consulta | Exemplo |
|---|---|
>n | cats stars:>1000 matches repositories with the word "cats" that have more than 1000 stars. |
>=n | cats topics:>=5 matches repositories with the word "cats" that have 5 or more topics. |
<n | cats size:<10000 matches code with the word "cats" in files that are smaller than 10 KB. |
<=n | cats stars:<=50 matches repositories with the word "cats" that have 50 or fewer stars. |
Você também pode usar consultas de intervalo para pesquisar valores que são maiores ou iguais ou menores ou iguais a outro valor.
| Consulta | Exemplo |
|---|---|
n..* | cats stars:10..* é equivalente a stars:>=10 e corresponde a repositórios com a palavra "cats" que têm até 10 estrelas. |
*..n | cats stars:*..10 é equivalente a stars:<=10 e corresponde a repositórios com a palavra "cats" que têm até 10 estrelas. |
Consultar por valores dentro de um intervalo
Você pode usar a sintaxe de intervalo n..n para pesquisar valores dentro de um intervalo, em que o primeiro número n é o valor mais baixo e o segundo é o valor mais alto.
| Consulta | Exemplo |
|---|---|
n..n | cats stars:10..50 corresponde a repositórios com a palavra "cats" que têm entre 10 e 50 estrelas. |
Consultar por datas
Você pode usar >, >=, <, <= e consultas de intervalo para pesquisar por datas anteriores ou posteriores a outra data ou que se enquadram em um intervalo de datas. Date formatting must follow the ISO8601 standard, which is YYYY-MM-DD (year-month-day).
| Consulta | Exemplo |
|---|---|
>YYYY-MM-DD | cats created:>2016-04-29 matches issues with the word "cats" that were created after April 29, 2016. |
>=YYYY-MM-DD | cats created:>=2017-04-01 matches issues with the word "cats" that were created on or after April 1, 2017. |
<YYYY-MM-DD | cats pushed:<2012-07-05 matches code with the word "cats" in repositories that were pushed to before July 5, 2012. |
<=YYYY-MM-DD | cats created:<=2012-07-04 matches issues with the word "cats" that were created on or before July 4, 2012. |
YYYY-MM-DD..YYYY-MM-DD | cats pushed:2016-04-30..2016-07-04 corresponde a repositórios com a palavra "cats" nos quais foi feito push entre o final de abril e julho de 2016. |
YYYY-MM-DD..* | cats created:2012-04-30..* corresponde a problemas criados após 30 de abril de 2012 contendo a palavra "cats". |
*..YYYY-MM-DD | cats created:*..2012-04-30 corresponde a problemas criados antes de 4 de julho de 2012 contendo a palavra "cats". |
You can also add optional time information THH:MM:SS+00:00 after the date, to search by the hour, minute, and second. That's T, followed by HH:MM:SS (hour-minutes-seconds), and a UTC offset (+00:00).
| Consulta | Exemplo |
|---|---|
YYYY-MM-DDTHH:MM:SS+00:00 | cats created:2017-01-01T01:00:00+07:00..2017-03-01T15:30:15+07:00 corresponde a problemas criados entre 01 de janeiro de 2017 à 1h, com uma diferença de fuso horário de 07:00 em relação ao UTC, e 01 de março de 2017 às 15h, com uma diferença de fuso horário de 07:00 em relação ao UTC. |
YYYY-MM-DDTHH:MM:SSZ | cats created:2016-03-21T14:11:00Z..2016-04-07T20:45:00Z corresponde a problemas criados entre 21 de março de 2016 às 14h11 e 07 de abril de 2106 às 20h45. |
Excluir determinados resultados
Usando a sintaxe NOT, é possível excluir resultados contendo uma determinada palavra. O operador NOT só pode ser usado para palavras-chave de string. Ele não funciona com numerais ou datas.
| Consulta | Example |
|---|---|
NOT | hello NOT world corresponde a repositórios que têm a palavra "hello", mas não a palavra "world". |
Outra maneira de restringir os resultados da pesquisa é excluir determinados subconjuntos. Adicione um prefixo a qualquer qualificador de pesquisa com um - para excluir todos os resultados correspondentes a esse qualificador.
| Consulta | Exemplo |
|---|---|
-QUALIFIER | cats stars:>10 -language:javascript matches repositories with the word "cats" that have more than 10 stars but are not written in JavaScript. |
| mentions:defunkt -org:github corresponde a problemas mencionando @defunkt que não estão em repositórios na organização do GitHub. |
Usar aspas para consultas com espaço em branco
Se a consulta de pesquisa contém espaço em branco, é preciso colocá-lo entre aspas. Por exemplo:
- cats NOT "hello world" corresponde a repositórios com a palavra "cats", mas não as palavras "hello world".
- build label:"bug fix" corresponde a problemas com a palavra "build" que têm a etiqueta "bug fix".
Alguns símbolos não alfanuméricos, como espaços, são descartados de consultas de pesquisa de código entre aspas, por isso os resultados podem ser inesperados.