Entender a sintaxe de pesquisa
Durante a pesquisa no GitHub Enterprise, é possível criar consultas que correspondam a palavras e números específicos.
Neste artigo
- Consultar por valores maiores ou menores que outro valor
- Consultar por valores dentro de um intervalo
- Consultar por datas
- Excluir determinados resultados
- Usar aspas para consultas com espaço em branco
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 corresponde a repositórios com a palavra "cats" que têm mais de 1.000 estrelas. |
>=n |
cats topics:>=5 corresponde a repositórios com a palavra "cats" que têm cinco tópicos ou mais. |
<n |
cats size:<10000 corresponde a código com a palavra "cats" em arquivos que têm menos de 10 KB. |
<=n |
cats stars:<=50 corresponde a repositórios com a palavra "cats" que têm até 50 estrelas. |
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 corresponde a problemas com a palavra "cats" que foram criados após 29 de abril de 2016. |
>=YYYY-MM-DD |
cats created:>=2017-04-01 corresponde a problemas com a palavra "cats" que foram criados após 01 de abril de 2017. |
<YYYY-MM-DD |
cats pushed:<2012-07-05 corresponde a código com a palavra "cats" em repositórios dos quais foi feito push antes de 05 de julho de 2012. |
<=YYYY-MM-DD |
cats created:<=2012-07-04 corresponde a problemas com a palavra "cats" que foram criados antes de 4 de julho de 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 corresponde a repositórios com a palavra "cats" que têm mais de 10 estrelas, mas não são escritos em 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.