Jira 查询语言 JQL：灵活的 Jira 搜索方式

JQL 代表 Jira 查询语言，是强大、灵活的 Jira 问题搜索方法。JQL 适合所有人：开发者、测试人员、敏捷项目经理和业务用户。本文旨在为那些没有数据库查询经验、希望更快访问 Jira 信息的人提供相关教程。因此，如果您使用 Jira ，那么不妨看一看本文。

1.在 Jira 中搜索：如何开始？

搜索框（The search box）

在 Jira 中，最简单的搜索功能是屏幕右上方的搜索框。

您可以使用此搜索框

搜索特定问题 、搜索文本（在问题摘要、描述和评论中搜索）、最后，该字段支持智能查询

这将列出所有处于未决状态并分配给您的 bug

2.搜索问题 

您也可以利用下拉菜单的“问题”菜单搜索问题。

在点击[搜索问题]后打开的屏幕中，您可以很方便地根据某些字段的值过滤问题。您可以过滤 Jira 中可用的任何字段（取决于选定的项目）。

3.基本搜索和高级搜索

Jira 有两种类型的搜索：基本搜索和高级搜索。如上所述，基本搜索提供一组可填写的表单，例如项目名称、问题类型、状态和被指定人。基本搜索对于获得问题和状态的高级视图非常有用。

而在高级搜索中，您就可以用到 JQL 进行查询了。查询是一系列简单元素构成一个复杂的问题。查询分为三个基本部分：字段、运算符和值。

字段——字段是系统中不同类型的信息。Jira 字段包括优先级、fixVersion 、问题类型等

运算符——运算符是查询的核心。它们把字段和值联系起来。常见运算符包括等于（=）、不等于（！=）、小于（<）等。

值——值是查询中的实际数据。它们通常是我们希望查找的东西。

关键字——关键词是语言中具有特殊含义的特定词语。本文中，我们主要介绍 AND 和 OR 。

4.需要了解的重要关键字

Atlassian 创建了 JQL 参考，您可以在其中找到 JQL 使用的所有关键字、运算符等。如果希望了解新的搜索功能，可以查看此指南。以下是部分最常见的关键字和运算符：

返回除状态设置为“ ToDo ”以外的所有问题

5.付诸实践的实例

我们从一个简单的例子开始。假设您想看看队友在某个项目中提出了什么漏洞。查询：

reporter = jsmith AND project = Pipeline

在这里，我们使用关键字“ AND ”来查询 John Smith 在项目“ Pipeline ”中报告的服务工单。

有些时候，您可能希望查询引用一组项目。例如：

项目 A、B 和 C 中哪些问题是关键问题或受到阻碍？

priority in (Blocker, Critical) AND project in (ProjA, ProjB, ProjC)

“ in ”关键字包含与列表中的任何项目相匹配的任何项目。在上面的例子中，将返回项目 A、B 和 C 中的所有阻塞程序和严重错误。

这对于那些与客户群有服务级别协议（ SLA ）的组织是非常有用的。JQL 查询可以很方便地找到不符合该 SLA 的问题。

什么问题没有分配，在最近一天没有更新？

assignee is EMPTY and created < -1d

此查询中，“ is empty ”语句仅包括被指定人字段的值为空的问题。这个查询还显示了 Jira 如何支持相对日期。查询运行时，值 -1d 计算为当前日期后的 1 天。因此，上述查询将返回至少存在一天且没有安排被指定人的问题。

不要被 Jira 的高级搜索吓倒！您可以利用 Jira 的 JQL 编辑器，轻松地学习 JQL 。编辑器具有输入代码提示功能。例如，如果我们想输入下面的 JQL: project = Pipeline ，Jira 会在这三个组件每一步提供建议。如果忘记命令了，可以随时点击“ Syntax help ”。

我们还提供了一份可下载的备忘单，方便您在使用 JQL 搜索时随时查看。您可以将字段、运算符和函数复制并粘贴到 Jira 搜索栏中，学习更高级的查询。更多问题可随时与我们联系。