Guia de consulta rápida da Linguagem de Consulta do JIRA (JQL)
A Linguagem de Consulta do JIRA (JQL) permite que você pesquise, filtre e gere relatórios sobre itens em um espaço de trabalho do Jira usando consultas flexíveis e poderosas para obter resultados precisos. É assim que você pesquisa no Jira quando clicar nos filtros não for suficiente.
A JQL foi criada para qualquer pessoa que precise de pesquisas exatas e repetíveis em tickets: gerentes de projeto extraindo um relatório de status, administradores auditando um backlog ou engenheiros procurando todos os bugs vinculados a uma versão específica.
Os 4 fundamentos de uma consulta de JQL
Toda cláusula de JQL é formada pelas mesmas quatro partes:
Parte | O que faz | Exemplo |
Campo | O atributo que você está pesquisando |
|
Operador | Relaciona o campo a um valor |
|
Valor ou função | Com o que você está comparando |
|
Palavra-chave | Conecta várias cláusulas |
|
Operadores comuns
Os operadores definem como o Jira compara um campo com o valor que você está procurando. Use para encontrar correspondências exatas, combinar condições, pesquisar em uma lista de valores ou verificar se um campo está vazio.
Operador | Significado | Exemplo |
| Correspondência exata |
|
| Diferente de |
|
| Combina condições, todas devem ser verdadeiras |
|
| Combina condições, qualquer uma pode ser verdadeira |
|
| Corresponde a qualquer valor em uma lista |
|
| Contém (pesquisar texto) |
|
| O campo não tem valor |
|
Principais funções JQL e como elas podem ser usadas
As funções JQL aprimoram os recursos de consulta ao permitir que os usuários realizem operações mais complexas, classifiquem os resultados e filtrem com base em critérios dinâmicos. Essas funções incluem:
Função | Descrição | Exemplo |
| Ordena os resultados por um campo. |
|
| Encontra itens que antes estavam em um estado específico. |
|
| Identifica itens modificados em um período. |
|
| Filtra itens por associação ao grupo. |
|
Exemplos de JQL para casos de uso comuns do Jira
Confira algumas formas de usar a JQL no Jira.
Caso de uso | Consulta JQL |
Encontrar todos os itens de alta prioridade atribuídos a você |
|
Listar itens atrasados em um projeto específico |
|
Mostrar itens recém-criados |
|
Técnicas avançadas da JQL
Use a pesquisa avançada com a JQL para ter campos personalizados e fazer consultas complexas.
Técnica | Exemplo | Como usar |
Campos personalizados |
| Pesquise em campos personalizados para consultas mais específicas. |
Subconsultas |
| Filtre itens com base nos resultados de outra consulta. |
Tipos de item específicos |
| Direcionar para tipos de item e status específicos. |
Como identificar erros antes da pesquisa
O editor de JQL atual no Jira Cloud foi desenvolvido para detectar problemas enquanto você digita, em vez de só depois de clicar em pesquisar:
Verificação de erros: a sintaxe inválida é sinalizada de imediato com orientações para correção
Destaque de sintaxe: campos, operadores, valores e funções são codificados por cores
Preenchimento automático: palavras-chave e funções relevantes aparecem enquanto você digita
Edição de várias linhas: expanda o editor e use os números das linhas para encontrar erros
Referências de usuário legíveis: nomes e avatares substituem os IDs de conta brutos
Depurador da JQL: quando uma consulta retorna um erro, o Rovo sugere uma consulta corrigida que você pode revisar e aceitar
Pesquisar com o Rovo
Você não precisa memorizar a sintaxe JQL acima para pesquisar com precisão. O Rovo, a IA da Atlassian, faz a tradução automática do que você digita para a JQL. Na barra de pesquisa do Jira, selecione Pergunte ao Rovo e digite sua pergunta do jeito que você faria em voz alta. Por exemplo:
"Encontre todos os bugs relatados no projeto do aplicativo móvel neste mês"
O Rovo converte isso na JQL correspondente, executa a pesquisa e mostra os resultados e a JQL gerada logo abaixo. Essa última parte é importante: é uma maneira útil de aprender de verdade JQL por meio de exemplos, pois você consegue ver de fato quais campos, operadores e funções foram usados para transformar sua pergunta em linguagem natural em uma consulta JQL. Se uma consulta for muito complexa para o Rovo resolver no modo Basic, ele faz uma mudança automática para o modo JQL para oferecer um resultado mais preciso. Você pode voltar para o Basic a qualquer momento pelo menu de mais ações.
Quando a Pesquisa Rovo funciona melhor | Quando mudar direto para a JQL |
Você sabe mais ou menos o que quer, mas não os nomes exatos dos campos ou a sintaxe | Você precisa de consultas precisas e repetíveis para quadros, painéis ou filtros salvos |
Você está pesquisando usando linguagem do dia a dia e palavras-chave dos seus tickets, espaços ou quadros | Sua consulta precisa de funções ou lógica que não podem ser expressas em linguagem natural com confiança |
Você quer aprender a sintaxe JQL aos poucos | A pesquisa foi feita em um idioma diferente do inglês |
JQL: perguntas mais frequentes
Como a JQL pode me ajudar a encontrar itens específicos no Jira?
A JQL permite criar consultas personalizadas para filtrar itens por campos, como assignee (responsável), status, project (projeto) ou date (data), para que você possa localizar rápido os itens que mais importam para você.
Posso salvar e compartilhar minhas consultas JQL com a minha equipe?
Você pode salvar suas pesquisas JQL como filtros e compartilhar com colegas de equipe, facilitando o acesso de todos ao mesmo conjunto de itens.
Quais são alguns casos de uso comuns para JQL no gerenciamento de projetos?
As equipes costumam usar JQL para rastrear tarefas atrasadas, monitorar o progresso do sprint, identificar bloqueadores e gerar relatórios que se adaptem ao seu fluxo de trabalho.
Há alguma dica para escrever consultas JQL mais avançadas?
Ao usar operadores, funções e combinar vários critérios com AND/OR, você pode fazer consultas complexas para o rastreamento detalhado de itens e relatórios.