テキスト フィールドの検索構文

このページの内容

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

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

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.

謝辞:JIRA ではテキストのインデックス作成に、豊富なクエリ言語を提供する Apache Lucene を使用しています。このページに記載する情報の多くは、Lucene ドキュメントの Query Parser Syntax ページをもとにしています。

このページの内容:

クエリ用語

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

Single Term is a single word, such as "test" or "hello".

Phrase is a group of words surrounded by double quotes, such as "hello dolly".

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

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

用語の修飾子

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

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

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

To perform a single character wildcard search, use the "?" symbol.

To perform a multiple character wildcard search, use the "*" symbol.

Wildcard characters need to be enclosed in quote-marks, as they are reserved characters in advanced search. Use quotations, e.g. summary ~ "cha?k and che*"

The single character wildcard search looks for terms that match that with the single character replaced. For example, to search for "text" or "test", you can use the search:

te?t

Multiple character wildcard searches looks for 0 or more characters. For example, to search for Windows, Win95, or WindowsNT, you can use the search:

win*

You can also use the wildcard searches in the middle of a term. For example, to search for Win95 or Windows95, you can use the search:

wi*95

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

あいまい検索: ~

JIRA supports fuzzy searches. To do a fuzzy search, use the tilde, "~", symbol at the end of a single word term. For example, to search for a term similar in spelling to "roam", use the fuzzy search:

roam~

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

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

近接検索

JIRA supports finding words that are within a specific distance away. To do a proximity search, use the tilde, "~", symbol at the end of a phrase. For example, to search for "atlassian" and "jira" within 10 words of each other in a document, use the search:

"atlassian jira"~10

用語のブースト: ^

JIRA では、検索された用語をもとにして、一致したドキュメントの関連度が設定されます。用語を格上げするには、検索語の末尾にキャレット "^" 記号とブースト係数(数値)を付けます。ブースト係数が高いほど、用語の関連度が高くなります。

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

atlassian jira

and you want the term "atlassian" to be more relevant, boost it using the ^ symbol along with the boost factor next to the term. You would type:

atlassian^4 jira

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

"atlassian jira"^4 querying

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

ブール演算子

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

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

OR

The OR operator is the default conjunction operator. This means that if there is no Boolean operator between two terms, the OR operator is used. The OR operator links two terms, and finds a matching document if either of the terms exist in a document. This is equivalent to a union using sets. The symbol || can be used in place of the word OR.

To search for documents that contain either "atlassian jira" or just "confluence", use the query:

"atlassian jira" || confluence

または

"atlassian jira" OR confluence

AND

The AND operator matches documents where both terms exist anywhere in the text of a single document. This is equivalent to an intersection using sets. The symbol && can be used in place of the word AND.

To search for documents that contain "atlassian jira" and "issue tracking", use the query:

"atlassian jira" AND "issue tracking"

必須用語: +

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

To search for documents that must contain "jira" and may contain "atlassian", use the query:

+jira atlassian

NOT

The NOT operator excludes documents that contain the term after NOT. This is equivalent to a difference using sets. The symbol ! can be used in place of the word NOT.

To search for documents that contain "atlassian jira" but not "japan", use the query:

"atlassian jira" NOT "japan"

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

NOT "atlassian jira"

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

除外用語: -

The "-" or prohibit operator excludes documents that contain the term after the "-" symbol.

To search for documents that contain "atlassian jira" but not "japan", use the query:

"atlassian jira" -japan

グループ化

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

To search for bugs and either atlassian or jira, use the query:

bugs AND (atlassian OR jira)

This eliminates any confusion and makes sure that bugs must exist, and either term atlassian or jira may exist.

Do not use the grouping character '(' at the start of a search query, as this will result in an error. For example, "(atlassian OR jira) AND bugs" will not work.

特殊文字のエスケープ: \ または \\

JIRA では、クエリ構文中で特殊文字をエスケープすることで、課題の特殊文字を検索する機能をサポートしています。以下は、このような特殊文字の現行のリストです。

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

To escape these characters, type a backslash character '\' before the special character (or if using advanced searching, type two backslashes '\\' before the special character).

For example, to search for (1+1) in either a basic or quick search, use the query:

 \(1\+1\) 

and to search for [example] in the summary of an advanced search (in JIRA Query Language or JQL), use the query:

summary ~ "\\[example\\]"

注意: 高度な検索を使用する場合、 Jira クエリ言語でこのような文字をエスケープする方法については、予約文字を参照してください。

予約語

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"

Be aware that this can sometimes lead to unexpected results. For example, suppose one issue contains the text phrase "VSX will crash" and another issue contains the phrase "VSX will not crash". A text search for "VSX will crash" will return both of these issues. This is because the words will and not are part of the reserved words list.

(info) JIRA 管理者は JIRA インデックスをこうした予約語に設定できます(これにより、JIRA はこれらの単語の存在を前提にして課題を検索します)。これを行うには、 インデックス用言語 を その他 ( 管理 > システム > 一般設定)に変更します。

単語の語幹抽出

Jira では単語の一部を含む課題の検索はできませんが (下記参照)、単語の "語幹抽出" を使用すれば、単語の特定の形との完全一致ではなく、その単語の語幹を基にした検索で課題を取得できます。語幹抽出された単語を基にした検索で取得される課題の数は通常、多くなります。これは、同じ語感に由来する単語を含む他の課題も、検索結果として取得されるためです。

たとえば、サマリフィールドでクエリ用語「customize」を使って課題を検索する場合、JIRA はこの単語の語根形「custom」を抽出し、「custom」に由来する単語がサマリ フィールドに含まれている課題をすべて取得します。したがって、クエリは次のようになります:

summary ~ "customize"

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

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

(info) 注意:

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

制限事項

JIRA の検索には次の制限が適用されますので注意してください。

単語レベルの一致のみ

JIRA では、単語の一部を含む課題の検索はできず、単語全体への一致のみサポートされています。ただし、語幹抽出される単語は例外です。

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

次のステップ

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

最終更新日: 2018 年 2 月 9 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.