Jira 쿼리 언어(JQL) 치트 시트

Jira 쿼리 언어(JQL)를 사용하면 유연하고 강력한 쿼리를 통해 Jira 작업 영역 내의 이슈를 검색, 필터링 및 보고하여 정확한 결과를 얻을 수 있습니다. 이는 필터를 클릭하는 것만으로는 부족할 때 Jira에서 검색하는 방법입니다.

JQL은 상태 보고서를 추출하는 프로젝트 관리자, 백로그를 감사하는 관리자, 특정 릴리스와 관련된 모든 버그를 추적하는 엔지니어 등 업무 항목에 대한 정확하고 반복 가능한 검색이 필요한 모두를 위해 만들어졌습니다.

Jira 무료 사용

JQL 쿼리의 4가지 구성 요소

모든 JQL 절은 동일한 4가지 요소로 구성됩니다.

부분

Rovo의 역할

예

필드

검색 중인 특성

priority, assignee, fixVersion

연산자

필드를 값에 연결

=, !=, <, IN

값 또는 함수

대조할 대상

"높음", currentUser()

키워드

여러 절을 함께 연결

AND, OR, ORDER BY

일반적인 연산자

연산자는 Jira가 필드를 검색 중인 값과 비교하는 방법을 정의합니다. 연산자를 사용하여 정확한 일치 항목을 찾거나 조건을 결합하거나 값 목록에서 검색하거나 필드가 비어 있는지 확인하세요.

연산자

의미

예

=

정확히 일치

project = "마케팅 캠페인"

!=

같지 않음

assignee != currentUser()

AND

조건을 결합하며, 모두 참이어야 함

priority = High AND status = Open

또는

조건을 결합하며, 둘 중 하나만 참이면 됨

status = Open OR status = Reopened

IN

목록의 값 중 하나와 일치

priority IN (High, Highest)

~

포함(텍스트 검색)

summary ~ "로그인 오류"

IS EMPTY

필드에 값이 없음

assignee IS EMPTY

주요 JQL 함수 및 사용 방법

JQL 함수를 사용하면 사용자가 더 복잡한 연산을 수행하고 결과를 정렬하며 동적 기준에 따라 필터링할 수 있어 쿼리 기능이 향상됩니다. 이 함수에는 다음이 포함됩니다.

함수

설명

예

ORDER BY

필드를 기준으로 결과를 정렬합니다.

project = "마케팅" ORDER BY created DESC

WAS

이전에 특정 상태에 있었던 이슈를 찾습니다.

status WAS "해결됨" AND status = "미해결"

CHANGED

특정 기간 내에 수정된 이슈를 식별합니다.

status CHANGED AFTER -1w

MEMBERSOF

그룹 멤버십을 기준으로 이슈를 필터링합니다.

assignee IN MEMBERSOF("개발자")

일반적인 Jira 사용 사례에 대한 JQL 예시

Jira에서 JQL을 사용할 수 있는 몇 가지 방법이 있습니다.

사용 사례

JQL 쿼리

본인에게 할당된 우선 순위가 높은 모든 이슈를 찾습니다

priority = High AND assignee = currentUser()

특정 프로젝트의 기한 초과 이슈를 나열합니다

project = "고객 지원" AND duedate < now() AND status != Closed

최근 만들어진 이슈 표시

created >= -7d ORDER BY created DES

고급 JQL 기법

JQL의 고급 검색을 사용하여 사용자 지정 필드 및 복잡한 쿼리를 활용하세요.

기법

예

사용 방법

사용자 지정 필드 사용

"사용자 지정 필드 이름" ~ "검색어"

더 맞춤화된 쿼리를 위해 사용자 지정 필드 내에서 검색합니다.

Subqueries

project IN subTaskIssueTypes() AND assignee = currentUser()

다른 쿼리의 결과를 바탕으로 이슈를 필터링합니다.

특정 이슈 유형

issuetype = Epic AND status != Done

특정 이슈 유형 및 상태를 대상으로 지정합니다.

검색을 실행하기 전에 실수를 발견하는 방법

JQL 편집기에서 오류 확인

Jira Cloud의 현재 JQL 편집기는 검색을 누른 후가 아니라 입력하는 동안 문제를 찾아내도록 만들어졌습니다.

  • 오류 검사: 유효하지 않은 구문을 즉시 표시하고 이것을 수정하기 위한 안내를 제공합니다.

  • 구문 강조: 필드, 연산자, 값 및 함수는 색상으로 구분됩니다

  • 자동 완성: 입력 시 관련 키워드와 함수가 표시됩니다

  • 여러 줄 편집: 편집기를 확장하고 줄 번호를 사용하여 오류를 찾습니다

  • 읽기 쉬운 사용자 참조: 이름 및 아바타가 원시 계정 ID를 대체합니다

  • JQL 디버깅 도구: 쿼리에서 오류가 발생하면 사용자가 검토하고 수락할 수 있는 수정된 쿼리를 Rovo가 제안합니다

Rovo로 검색

정확한 검색을 실행하기 위해 위의 JQL 구문을 외울 필요는 없습니다. Atlassian의 AI인 Rovo는 사용자가 입력하는 내용을 JQL로 자동으로 변환합니다. Jira 검색 표시줄에서 Rovo에 요청을 선택하고 평소에 말하듯이 질문을 입력합니다. 예를 들면 다음과 같습니다.

"이번 달 모바일 앱 프로젝트에서 보고된 모든 버그를 찾아 줘"

Rovo는 이것을 일치하는 JQL로 변환하고 검색을 실행하며, 결과 및 생성된 JQL을 그 아래에 함께 표시합니다. 이 마지막 부분이 중요합니다. 자연어로 된 질문이 어떤 필드, 연산자 및 함수에 매핑되었는지 정확히 볼 수 있으므로 예시를 통해 JQL을 배우는 데 정말 유용한 방법입니다. 쿼리가 너무 복잡하여 Rovo가 기본 모드에서 해결할 수 없는 경우, 더 정확한 결과를 제공하기 위해 자동으로 JQL 모드로 전환됩니다. 추가 작업 메뉴에서 언제든지 Basic으로 다시 전환할 수 있습니다.

Rovo 검색이 가장 효과적인 경우

직접 JQL로 전환해야 하는 경우

원하는 것을 대략적으로는 알고 있지만 정확한 필드 이름 또는 구문은 모르는 경우

저장된 필터, 보드 또는 대시보드에 사용할 정확하고 반복 가능한 쿼리가 필요한 경우

일상적인 언어와 업무 항목, 스페이스 또는 보드의 키워드를 사용하여 검색하는 경우

쿼리에 자연어로 확실하게 표현할 수 없는 함수 또는 논리가 필요한 경우

JQL 구문을 사용하면서 배우고 싶은 경우

영어가 아닌 다른 언어로 검색하는 경우

JQL: 자주 묻는 질문

JQL은 Jira에서 특정 이슈를 찾는 데 어떻게 도움이 됩니까?

JQL을 사용하면 담당자, 상태, 프로젝트 또는 날짜와 같은 필드를 기준으로 이슈를 필터링하는 사용자 지정 쿼리를 작성할 수 있으므로, 가장 중요한 이슈를 빠르게 찾을 수 있습니다.

JQL 쿼리를 저장하여 팀과 공유할 수 있습니까?

JQL 검색을 필터로 저장하고 팀원과 공유하면 모두가 동일한 이슈에 쉽게 액세스할 수 있습니다.

프로젝트 관리에서 JQL의 일반적인 사용 사례는 무엇입니까?

팀은 흔히 JQL을 사용하여 기한 초과 작업을 추적하고 스프린트 진행률을 모니터링하고 블로커를 식별하고 워크플로에 맞는 보고서를 생성합니다.

더 고급 JQL 쿼리를 작성하기 위한 팁이 있습니까?

연산자와 함수를 사용하고 AND/OR로 여러 기준을 결합하여, 상세한 이슈 추적 및 보고를 위한 복잡한 쿼리를 만들 수 있습니다.