Jira クエリ言語 (JQL) チート シート

Jira クエリ言語 (JQL) を使用すると、柔軟かつ強力なクエリによって Jira ワークスペース内の課題の検索、フィルタリング、レポートの作成を行い、精度の高い結果を得ることができます。これは、フィルターをクリックするだけでは不十分な場合に、Jira を検索する方法です。

JQL は、ステータス レポートを抽出するプロジェクト マネージャー、バックログを監査する管理者、特定のリリースに関連付けられたすべてのバグを探し出すエンジニアなど、作業項目全体で正確かつ反復可能な検索を必要とするすべてのユーザー向けに設計されています。

JQL クエリの 4 つの構成要素

すべての JQL 句は、同じ 4 つの要素で構成されています。

構成要素

動作

例

フィールド

検索対象の属性

priority、assignee、fixVersion

演算子

フィールドを値に関連付ける

=、!=、<、IN

値または関数

照合対象

"High"、currentUser()

キーワード

複数の句を結合する

AND、OR、ORDER BY

一般的な演算子

演算子により、Jira がフィールドと検索対象の値を比較する方法が定義されます。演算子を使用して、完全一致の検索、条件の組み合わせ、値のリスト全体の検索、またはフィールドが空であるかどうかの確認を行います。

演算子

意味

例

=

完全一致

project = "マーケティング キャンペーン"

!=

等しくない

assignee != currentUser()

AND

条件の組み合わせ (すべてを満たす必要がある)

priority = High AND status = Open

OR

条件の組み合わせ (いずれかを満たす必要がある)

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 による高度な検索を使用します。

手法

例

使い方

カスタム フィールドの使用

"カスタム フィールド名" ~ "検索語句"

カスタム フィールド内を検索して、よりカスタマイズされたクエリを可能にします。

サブクエリ

project IN subTaskIssueTypes() AND assignee = currentUser()

別のクエリの結果に基づいて課題をフィルタリングします。

特定の課題タイプ

issuetype = Epic AND status != Done

特定の課題タイプとステータスを対象にします。

検索を実行する前にミスを見つける方法

JQL エディタでのエラーの検出
Easily and quickly error-check or debug JQL, verify results, and have Rovo make the corrected change on the spot in the editor.

Jira Cloud の現在の JQL エディターは、検索を実行した後ではなく、入力中に問題を見つけるように構築されています。

  • エラー チェック: 無効な構文はすぐにフラグが付けられ、修正するためのガイダンスが表示される

  • 構文ハイライト: フィールド、演算子、値、関数は色分けされる

  • オートコンプリート: 入力中に関連するキーワードや関数が表示される

  • 複数行の編集: エディターを展開し、行番号を使用してエラーを見つける

  • 読みやすいユーザー参照: 生のアカウント ID の代わりに名前とアバターが表示される

  • JQL デバッガー: クエリがエラーを返した場合、Rovo によってユーザーがレビューして承認できる修正済みのクエリが提案される

Rovo による検索

正確な検索を実行するために、上記の JQL 構文を覚える必要はありません。アトラシアンの AI である Rovo は、入力した内容を自動的に JQL に変換します。Jira の検索バーから [Rovo に質問] を選択し、普段話すような自然な言葉で質問を入力してください。次に例を示します。

「今月モバイル アプリ プロジェクトで報告されたすべてのバグを検索してください」

Rovo はそれを一致する JQL に変換して検索を実行し、結果と生成された JQL の両方を下に表示します。この最後の部分は重要です。なぜなら、平易な日本語で入力した質問がどのフィールド、演算子、関数にマッピングされたかを正確に確認できるため、実例を通して JQL を学ぶ上で非常に役立つ方法だからです。クエリが複雑すぎて Rovo が基本モードで解決できない場合、自動的に JQL モードに切り替わり、より正確な結果を提供します。その他の操作メニューからいつでも [基本] に切り替えることができます。

Rovo 検索が最も効果的な場合

直接 JQL に切り替えるタイミング

探したいものは大体わかっているが、正確なフィールド名や構文がわからない場合

保存されたフィルター、ボード、またはダッシュボードに正確で繰り返し使用できるクエリが必要なとき

日常的な言葉や、作業項目、スペース、またはボードのキーワードを使用して検索している場合

クエリに、自然言語では確実に表現できない関数やロジックが必要なとき

JQL 構文を使いながら学びたい場合

英語以外の言語で検索しているとき

JQL: よくある質問

Jira で特定の課題を検索するために、JQL はどのように役立ちますか?

JQL を使用すると、担当者、ステータス、プロジェクト、日付などのフィールドで課題をフィルタリングするカスタム クエリを作成できるため、最も重要な課題をすばやく見つけることができます。

JQL クエリを保存してチームと共有できますか?

JQL 検索をフィルターとして保存してチーム メイトと共有することで、全員が一連の同じ課題に簡単にアクセスできるようになります。

プロジェクト管理における JQL の一般的なユース ケースにはどのようなものがありますか?

チームは多くの場合、JQL を使用して期限切れのタスクを追跡し、スプリントの進捗を監視し、ブロッカーを特定して、ワークフローに合ったレポートを生成します。

より高度な JQL クエリを作成するためのヒントはありますか?

演算子や関数を使用し、AND/OR で複数の条件を組み合わせることで、詳細な課題トラッキングとレポート作成のための複雑なクエリを構築できます。

推奨

Guide to Jira Work Items

Learn how to review work item types and relationships in Jira to make search conditions easier to interpret.

Guide to Jira Reports and Dashboards

Track progress, spot blockers, and share real-time reports with Jira dashboards built for your team.

Guide to Jira Boards

Visualize work, spot bottlenecks, and keep every sprint moving with Scrum and Kanban boards in Jira.