このページでは、テキスト フ​​ィールドを検索するための構文について説明します。これは、クイック検索、ベーシック検索、詳細検索で使用できます。

Text searches can be done in the advanced search when the CONTAINS (~) operator is used, e.g. summary~"windows*". It can also be done in quick search and basic search when searching on supported fields.

Acknowledgments: Jira uses Apache Lucene for text indexing, which provides a rich query language. Much of the information on this page is derived from the Query Parser Syntax page of the Lucene documentation.

On this page:

クエリ用語

クエリは、用語演算子から構成されます。用語には 2 種類あります: 単一用語フレーズです。

単一用語とは、"test" や " hello" などの単一の単語です。

フレーズとは、"hello dolly" など、二重引用符で囲まれた単語のグループです。

複数の用語をブール演算子と組み合わせてより複雑なクエリを作成することもできます (下記参照)。ブール演算子を指定せずに複数の用語を組み合わせる場合、用語はAND 演算子を使用して結合されます。

注意: Jira では、すべてのクエリ用語で大文字と小文字を区別しません。

用語の修飾子

Jira では、幅広い検索オプションを提供するために、クエリ用語の修飾がサポートされています。

完全検索 (フレーズ)

Jira Software などの完全に一致するフレーズを検索するには、引用符 (") でフレーズ全体を囲む必要があります。これを行わない場合、順番にかかわらず両方のワードを含むすべての課題が返されます。これには "Jira Software" だけではなく "Jira is best software!" も含まれます。

If you’re using advanced search, you need to additionally escape each of the quote-marks with a backslash (\). For details, see the examples below or find your field in Advanced search - field reference.


  • ベーシック検索: フレーズ "Jira Software" を含むすべての課題を検索します。

    Just type "Jira Software" into the search field.
  • 詳細検索: 順番を指定せず、ワード "Jira" および "Software" を含む全ての課題を検索します。

    text ~ "Jira Software"
  • 詳細検索: フレーズ "Jira Software" を含むすべての課題を検索します。

    text ~ "\"Jira Software\""
  • 詳細検索: URL "https://atlassian.com" を含むすべての課題を検索します。

    text ~ "\"https://atlassian.com\""

2 つの例にあるように、クエリには引用符のペアが 2 つ含まれます。外側のものは JQL ルールを満たすために必要なものであり、検索クエリには関係しません。ベーシック検索で検索を実行すると、Jira によって同じ引用符のペアが自動的に追加されます。

特殊文字を使用してフレーズを作成する

Jira の過去のバージョンでは、一部の特殊文字を使用してフレーズ語句をフレーズにまとめることができました。たとえば、Jira+SoftwareJira/Software などです。検索で使用されていたメカニズムが変更され、語句の周辺の特殊文字は無視されるようになったため、この方法は使用できなくなりました。

ワイルドカード検索: ? および *

Jira は、単一文字および複数文字のワイルドカード検索に対応しています。

単一文字のワイルドカード検索には、"?" 記号を使用します。

複数文字のワイルドカード検索には、"*" 記号を使用します。

ワイルドカード文字は引用符で囲む必要があります。これは、これらの文字が詳細検索の予約文字であるためです。次のように引用符を使用します。summary ~ "cha?k and che*"

単一文字のワイルドカード検索では、単一文字部分を置き換える形で一致する用語が検索されます。たとえば、"text" または "test" を検索するには、次のように使用します。

te?t

複数文字のワイルドカード検索は、0 個以上の文字を検索します。たとえば、WindowsWin95 または WindowsNT を検索するには、次のように検索します。

win*

用語の途中でワイルドカード検索を使用することも可能です。たとえば、Win95 または Windows95 を検索するには、次のように検索します。

wi*95

* または ? 記号は、検索の先頭文字として使用できません。 この機能リクエストについては、JRA-6218 を参照してください。


あいまい検索: ~

Jira は、あいまい検索に対応しています。あいまい検索では、単一の用語の末尾にチルダ "~" 記号を使用します。たとえば、"roam" に似たスペルの単語を検索するには、次のようにあいまい検索を使用します。

roam~

この検索では、foam や roams などの単語が検索されます。

注意: あいまい検索で見つかった用語は、自動的にブースト係数 0.2 を取得します。

プリフィックス検索

Jira では単語の部分検索がサポートされています。このような検索を行うには、探している単語やフレーズのプリフィックスを含めます。たとえば、"MagicBox" 課題を探すには、次の検索パターンを使用できます。

プリフィックス検索
summary ~ "magic*"


近接検索

Jira は、特定の距離内にある語句の検索に対応しています。近接検索では、フレーズの末尾にチルダ "~"記号を使用します。たとえば、ドキュメント内で 10 語以内の距離にある "atlassian" と "Jira" を検索するには、次のように検索します。

"atlassian Jira"~10

用語のブースト: ^

Jira では、検索で見つかった用語に基づいて、一致したドキュメントの関連度が提供されます。用語をブーストするには、検索語の末尾にキャレット "^" 記号とブースト係数 (数値) を設定します。ブースト係数が高いほど、用語の関連度が高くなります。

ブーストを使用することで、ドキュメントの関連性を制御できます。たとえば、次の用語を検索する場合を考えます。

atlassian Jira

この "atlassian" という用語の関連度を高めたい場合、用語の横にブースト係数と ^ 記号を付けてブーストさせます。次のように入力します。

atlassian^4 Jira

これで、「atlassian」という用語が含まれるドキュメントの関連性が高くなります。次の例のように、フレーズ用語もブーストできます。

"atlassian Jira"^4 querying

既定では、ブースト係数は 1 です。ブースト係数には正の数を指定する必要がありますが、1 より小さい数値も使用できます (0.2 など)。

ブール演算子

ブール演算子を使用すると、複数の用語を論理演算子で組み合わせることができます。Jira ではブール演算子として AND、"+"、OR、NOT、"-" がサポートされています。

ブール演算子はすべて大文字にする必要があります。

または

OR 演算子は既定の結合演算子です。つまり、2 つの用語間にブール演算子が存在しない場合、OR 演算子が使用されます。OR 演算子は 2 つの用語をリンクし、いずれかの用語を含むドキュメントが見つかった場合は一致するドキュメントを返します。これは和集合に相当します。単語 OR の代わりに、|| 記号を使用することもできます。

"atlassian Jira" または "confluence" を含むドキュメントを検索するには、次のクエリを使用します。

"atlassian Jira" || confluence

または

"atlassian Jira" OR confluence

AND

AND 演算子は、1 つのドキュメントのテキストに両方の用語が存在する場合に、一致するドキュメントを返します。これは論理積に相当します。単語 AND の代わりに、記号 && を使用することもできます。

"atlassian Jira" および "issue tracking" を含むドキュメントを検索するには、次のクエリを使用します。

"atlassian Jira" AND "issue tracking"

必須用語: +

"+" (必須演算子) は、単一ドキュメントのフィールド内のどこかに "+" 記号に続く用語が存在しなければならないことを意味します。

"Jira" を必ず含み、"atlassian" を任意で含むドキュメントを検索するには、次のクエリを使用します。

+Jira atlassian

NOT

NOT 演算子は、NOT に続く単語を含むドキュメントを除外します。これは差集合に相当します。単語 NOT の代わりに、記号 ! を使用することもできます。

"atlassian Jira" を含むが、"japan" は含まないドキュメントを検索するには、次のクエリを使用します。

"atlassian Jira" NOT "japan"

注意: NOT 演算子は、1 つの用語のみで使用することはできません。たとえば、次の検索では、結果は返されません。

NOT "atlassian Jira"

複数のフィールドに対して NOT 演算子を使用すると、指定した除外用語を含む結果が返される可能性があります。これは、検索クエリが各フィールドで順に実行され、各フィールドの結果セットが結合されて、最終的な結果セットとなるためです。したがって、1 つのフィールドで検索クエリが一致したが、別のフィールドでは不一致となった課題は、検索結果セットに含まれることになります。

除外用語: -

"-" は禁止演算子とも呼ばれ、"-" 記号に続く単語を含むドキュメントを除外します。

"atlassian Jira" を含むが、"japan" は含まないドキュメントを検索するには、次のクエリを使用します。

"atlassian Jira" -japan

グループ化

Jira では、サブクエリを形成する句をグループ化するために括弧を使用できます。これは、クエリでブール論理を制御する場合に非常に役立ちます。

bugsatlassian または Jira を検索するには、次のクエリを使用します。

bugs AND (atlassian OR Jira)

これにより曖昧さがなくなり、bugs を必ず含み、atlassian または Jira のいずれかのを含む検索を確実に行うことができます。

検索クエリの先頭にグループ化文字の「(」を使用しないでください。これはエラーを返します。たとえば、"(atlassian OR Jira) AND bugs" は使用できません。

特殊文字

+ - & | ! ( ) { } [ ] ^ ~ * ?\ :

特殊文字はインデックスに保存されないため、検索できません。インデックスはテキストと数字のみを保持します。そのため、"\\[Jira Software\\]" を検索した場合と "Jira Software" を検索した場合、結果は同じになり、エスケープされた検索文字 ([]) は検索では無視されます。 

In previous Jira versions, you could use special characters to combine two separate terms into a phrase, for example "Jira+Software" or "Jira/Software". This doesn’t apply to Jira 8.x. If you’d like to search for phrases, see Exact searches (phrases) .

予約語

Jira の検索インデックスのサイズと検索パフォーマンスを最適に保つため、以下の英語の予約語 (ストップ ワード) は検索インデックスから無視されます。Jira のテキスト検索の予約語は次のとおりです。

"a", "and", "are", "as", "at", "be", "but", "by", "for", "if", "in", "into", "is", "it", "no", "not", "of", "on", "or", "such", "that", "the", "their", "then", "there", "these", "they", "this", "to", "was", "will", "with"

これは予期しない結果を招くことがある可能性にご注意ください。たとえば、1 つの課題に "VSX will crash" というテキスト フレーズが含まれ、別の課題には "VSX will not crash" というフレーズが含まれているとします。"VSX will crash" のテキスト検索では、これら両方の課題が検索結果として返されます。これは、単語 "will" および "not" が予約語リストに含まれているためです。

(info) Your Jira administrator can make Jira index these reserved words (so that Jira will find issues based on the presence of these words) by changing the Indexing Language to Other (under Administration > System > General Configuration).

単語の語幹抽出

Since Jira cannot search for issues containing parts of words (see below), word 'stemming' allows you to retrieve issues from a search based on the 'root' (or 'stem') forms of words instead of requiring an exact match with specific forms of these words. The number of issues retrieved from a search based on a stemmed word is typically larger, since any other issues containing words that are stemmed back to the same root will also be retrieved in the search results.

たとえば、要約フィールドでクエリ用語 "customize" を使って課題を検索する場合、Jira はこの単語の語幹 "custom" を抽出し、"custom" に由来する単語を要約フィールドに含むすべての課題を取得します。したがって、次のクエリを実行した場合:

summary ~ "customize"

要約フィールドに次の単語を含む課題が検索されます。

  • customized
  • customizing
  • customs
  • customer
  • など。

(info) 注意:

  • Jira 管理者は単語の語幹抽出を無効化できます (これにより、Jira は完全に一致する単語を基にして課題を検索します)。これを行うには、 [インデックス言語] を [その他] ([管理] > [システム] > [一般設定]) に変更します。
  • 単語の語幹抽出はすべての Jira フィールド (およびテキスト フィールド) に適用されます。
  • Jira がフィールドのインデックスを作成する際、語幹から "派生した" すべての単語は、Jira の検索インデックスに語幹の形でのみ保管されます。

制限事項

Jira の検索には次の制限が適用される点にご注意ください。

単語レベルの一致のみ

Jira cannot search for issues containing parts of words but on whole words only. The exception to this are words which are stemmed.

この制限は、 あいまい検索の使用にも影響ありません。

次のステップ

関連トピックをご確認ください。