JQL 치트 시트

이 Jira JQL 치트 시트를 Atlassian의 프로젝트 관리 도구에서 고급 검색 및 필터링용 Jira 쿼리 언어를 마스터하기 위한 종합 가이드로 사용하세요.

Jira 쿼리 언어(JQL) 소개

JQL은 Jira를 위해 특별히 설계된 강력한 검색 언어로, 사용자는 이를 통해 이슈 추적, 고급 필터링, 보고를 위한 복잡한 쿼리를 만들 수 있습니다. Jira JQL의 유연성을 통해 프로젝트 매니저 및 애자일 팀은 대규모 데이터 세트를 탐색할 수 있습니다.

Jira Free 사용하기

JQL 쿼리의 기본 구조

일반적인 JQL 쿼리는 다음 컴포넌트로 구성됩니다.

필드: JQL 필드는 우선 순위, fixVersion, 이슈 유형 등 다양한 유형의 정보를 나타냅니다.
연산자: 연산자는 쿼리의 핵심으로 필드와 값을 연관시킵니다. 보통 등호(=), 부등호(!=) 및 미만(<) 등이 포함됩니다.
값 및 함수: 값은 찾고 있는 특정 데이터 포인트입니다. JQL 함수는 계산을 수행하거나 동적 결과를 반환합니다.
키워드: JQL 키워드는 AND 및 OR와 같이 의미가 미리 정의된 특수 단어입니다. 보다 복잡한 쿼리를 구성하는 데 사용합니다.

예: project = “Marketing Campaign” AND status = “In Progress”

이 구조를 통해 사용자는 Jira 내에서 특정 이슈 또는 그룹을 대상으로 하는 쿼리를 빠르게 작성할 수 있습니다.

일반적인 JQL 연산자

효과적인 쿼리를 만들려면 JQL 연산자를 이해하는 것이 중요합니다. JQL의 중추를 형성하는 JQL 연산자는 사용자가 정밀한 검색을 통해 대량의 데이터를 필터링하여 필요한 것을 정확히 찾을 수 있게 해줍니다. JQL의 일반적인 연산자는 다음과 같습니다.

=: 정확히 일치합니다. 예: 프로젝트 = “마케팅 캠페인”. 이렇게 하면 “마케팅 캠페인” 프로젝트에 속한 모든 이슈가 반환됩니다.
.!=: 같지 않습니다. 예: 담당자 != currentUser( ). 이렇게 하면 현재 사용자에게 할당되지 않은 모든 이슈를 찾을 수 있어 다른 사람의 주의가 필요할 수 있는 작업을 파악하는 데 도움이 됩니다.
AND: 여러 조건을 조합합니다(모두 참이어야 함). 예: 우선 순위 = 높음 AND 상태 = 미해결. 이렇게 하면 우선 순위가 높고 미해결 상태인 이슈만 반환되므로 즉각적인 주의가 필요한 중요 작업을 파악할 수 있습니다.
OR: 여러 조건을 조합합니다(적어도 하나는 참이어야 함). 예: 컴포넌트 = “사용자 인터페이스” OR 컴포넌트 = “API”. 이를 통해 사용자 인터페이스 또는 API 컴포넌트 관련 이슈를 찾을 수 있어 여러 시스템 부분에서 관련 작업을 볼 수 있습니다.
IN: 지정된 목록의 값과 일치되는 모든 결과를 찾습니다. 예: 상태 IN (“진행 중”, “검토 중”, “테스트 중”). 이렇게 하면 이 세 가지 상태 중 하나에 해당하는 모든 이슈가 반환되어 모든 활성 작업 항목을 빠르게 볼 수 있습니다.

주요 JQL 함수 및 사용 방법

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

ORDER BY: 결과를 정렬합니다. 예: 프로젝트 = "마케팅" ORDER BY 생성된 날짜 내림차순. 이렇게 하면 마케팅 프로젝트의 모든 이슈가 생성 날짜별로 최신 항목에서 오래된 항목으로 정렬되어 반환되므로 가장 최근 작업을 빠르게 파악할 수 있습니다.
WAS: 특정 상태에 있었던 이슈를 찾아냅니다. 예: 상태 WAS "해결됨" AND 상태 = "미해결." 이렇게 하면 해결되었다가 다시 시작된 이슈를 모두 찾을 수 있어 반복되는 문제를 추적할 수 있습니다.
CHANGED: 기간 내에 수정된 이슈를 파악합니다. 예: 상태 CHANGED AFTER -1주. 이렇게 하면 지난주에 상태가 변경된 모든 이슈가 반환되므로 프로젝트의 최근 진행률 또는 변경 사항을 검토하는 데 유용합니다.
MEMBERSOF: 그룹 멤버십에 따라 필터링합니다. 예: 담당자 IN MEMBERSOF("개발자"). 이렇게 하면 "개발자" 그룹의 모두에게 할당된 모든 이슈를 찾아 팀 전체의 워크로드를 볼 수 있습니다.

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

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

할당된 우선 순위가 높은 이슈 모두 찾기: 우선 순위 = 높음 AND 담당자 = currentUser()
특정 프로젝트의 기한 초과 이슈 나열: 프로젝트 = "고객 지원" AND 마감 날짜 < now() AND 상태 != 닫힘
최근에 만든 이슈 보기: 생성됨 >= -7일 ORDER BY 생성된 날짜 내림차순

고급 JQL 기법

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

사용자 지정 필드 사용: "사용자 지정 필드 이름" ~ "검색어". JQL을 사용하여 사용자 지정 필드 내에서 검색하면 비즈니스 고유 데이터 구조를 기반으로 보다 구체적인 맞춤형 쿼리가 가능합니다.
하위 쿼리: 프로젝트 IN subTaskIssueTypes() AND 담당자 = currentUser(). JQL을 사용하여 중첩된 쿼리를 만들면 다른 쿼리의 결과를 기반으로 이슈를 필터링할 수 있으므로 프로젝트의 복잡한 계층 관계에 특히 유용합니다.
특정 이슈 유형: issuetype = 에픽 AND 상태 != 완료됨. JQL을 사용하면 특정 이슈 유형 및 상태를 대상으로 지정하여 프로젝트 전반에서 특정 업무 범주를 추적 및 관리할 수 있습니다.

JQL 전문가 되기

이 Atlassian JQL 치트 시트를 사용하면 JQL로 고급 검색을 탐색하고 프로젝트 관리 기술을 향상할 수 있습니다.

JQL을 마스터하면 주요 프로젝트 인사이트를 얻고 팀과 관련된 중요한 질문에 답할 수 있습니다. Jira의 세 가지 검색 유형(빠른 검색, 기본 검색, 고급 검색)은 프로젝트에 대한 중요한 정보를 찾는 데 도움이 됩니다. 또한 쿼리 결과를 저장하여 Jira에서 필터 및 보기로 사용할 수 있습니다(보드 포함).

Jira JQL의 유연성에 대해 자세히 살펴볼 준비가 되셨습니까?