このページでは、テキスト フィールドを検索する構文について説明します。テキスト フィールド検索ではクイック検索、基本検索 (サポートされているフィールドでの検索時)、高度な検索 (CONTAINS (~) 演算子の使用時) を使用できます。

クエリ用語

クエリは、単語と演算子で構成されます。単語には、単一語 ("hello" など) とフレーズ ("hello dolly" など) の 2 種類があります。Jira では、クエリ用語の大文字と小文字を区別しません。複数の単語をブール演算子と組み合わせてより複雑なクエリを作成することもできます (下記参照)。ブール演算子を指定せずに複数の単語を組み合わせる場合、単語は AND 演算子を使用して結合されます。

用語の検索

複数文字のワイルドカード検索には、単語の末尾に "*" 記号を使用します。引用符で囲まれた複数文字のワイルドカード検索は、0 個以上の文字を検索します。たとえば、Windows、Win95 または WindowsNT は、次のように検索します。

win*

完全検索 (フレーズ)

To find exact matches for phrases, for example Jira Software, you need to enclose the whole phrase in quote-marks ("). Otherwise, the search will return all issues that contain both words in no particular order - this would include Jira Software, but also Jira is the best software!

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

例

Basic search: Find all issues that contain the phrase Jira Software:


Just type "Jira Software" into the search field.

Advanced search: Find all issues that contain the words Jira and Software, in no particular order.


text ~ "Jira Software"


Advanced search: Find all issues that contain the exact phrase Jira Software.


text ~ "\"Jira Software\""


Advanced search: Find all issues that contain the words Jira and Software in no particular order (a “fuzzy” search), and that also contain the exact phrase “hello world”.

text ~ "Jira Software" AND text ~ "\"hello world\""

As you can see in the two preceding examples, the phrase query contains two pairs of quote-marks. The external ones are needed to meet the JQL rules and aren’t related to your search query.

ブール演算子

ブール演算子を使用すると、複数の用語を論理演算子で組み合わせることができます。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"

The NOT operator cannot be used with multiple terms. For example, the following search will return no results:

NOT "atlassian jira"

除外用語: -

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

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

"atlassian jira" -japan

グループ化

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

bugsと atlassian または jira を検索するには、次のクエリを使用します。

bugs AND (atlassian OR jira)

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

予約語

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

"a", "an", "abort", "access", "add", "after", "alias", "all", "alter", "and", "any", "are", "as", "asc", "at", "audit", "avg", "be", "before", "begin", "between", "boolean", "break", "but", "by", "byte", "catch", "cf", "char", "character", "check", "checkpoint", "collate", "collation", "column", "commit", "connect", "continue", "count", "create", "current", "date", "decimal", "declare", "decrement", "default", "defaults", "define", "delete", "delimiter", "desc", "difference", "distinct", "divide", "do", "double", "drop", "else", "empty", "encoding", "end", "equals", "escape", "exclusive", "exec", "execute", "exists", "explain", "false", "fetch", "file", "field", "first", "float", "for", "from", "function", "go", "goto", "grant", "greater", "group", "having", "identified", "if", "immediate", "in", "increment", "index", "initial", "inner", "inout", "input", "insert", "int", "integer", "intersect", "intersection", "into", "is", "isempty", "isnull", "it", "join", "last", "left", "less", "like", "limit", "lock", "long", "max", "min", "minus", "mode", "modify", "modulo", "more", "multiply", "next", "no", "noaudit", "not", "notin", "nowait", "null", "number", "object", "of", "on", "option", "or", "order", "outer", "output", "power", "previous", "prior", "privileges", "public", "raise", "raw", "remainder", "rename", "resource", "return", "returns", "revoke", "right", "row", "rowid", "rownum", "rows", "select", "session", "set", "share", "size", "sqrt", "start", "strict", "string", "subtract", "such", "sum", "synonym", "table", "that", "the", "their", "then", "there", "these", "they", "this", "to", "trans", "transaction", "trigger", "true", "uid", "union", "unique", "update", "user", "validate", "values", "view", "was", "when", "whenever", "where", "while", "will", "with"

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

単語の語幹抽出

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

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

summary ~ "customize"

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

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