22.4. クエリ言語
前のページ | 第22章 Zend_Search | 次のページ

## 22.4. クエリ言語

Java Lucene および Zend_Search_Lucene では、非常に強力なクエリ言語を使用できます。

これら二つはほぼ同じですが、微妙に異なる点もあります。 異なる点については以下で説明します。

Java Lucene のクエリ言語の文法についての完全な文書は ここ にあります。

### 22.4.1. 用語

クエリは、単語と演算子から成り立ちます。単語には三種類の形式があります。 単一の単語、フレーズ、そしてサブクエリです。

単一の単語とは、"test" や "hello" のようなひとつの単語です。

フレーズとは、ダブルクォートで囲まれた複数の単語のグループ、たとえば "hello dolly" です。

サブクエリとは、括弧で囲まれたクエリ、たとえば "(hello dolly)" です。

複数の単語を論理演算子で組み合わせることで、より複雑なクエリを作成できます (以下を参照ください)。

### 22.4.2. フィールド

Lucene は、フィールド指定したデータをサポートしています。 検索を行う際には、クエリを指定することもできますし、 デフォルトのフィールドを使用することもできます。 フィールド名はインデックス化されたデータに依存します。また、 デフォルトのフィールドは現在の設定によって決まります。

Java Lucene との最初の (そして大きな) 違いは、デフォルトでは すべてのフィールド が検索の対象になるということです。

Zend_Search_Lucene クラスにはふたつの静的メソッドがあり、 この設定を操作することができます。

    <?php
    $defaultSearchField = Zend_Search_Lucene::getDefaultSearchField();
    ...
    Zend_Search_Lucene::setDefaultSearchField('contents');
    ?>

`null` 値は、すべてのフィールドを検索の対象とすることを意味します。 これがデフォルトの設定です。

フィールドを指定するには、まずフィールド名をタイプし、その後にコロン ":" を続け、探したい単語を指定します。

例を見てみましょう。Lucene インデックスにはふたつのフィールド title および text があり、text がデフォルトのフィールドであるとします。 タイトルが "The Right Way" で本文に "don't go this way" が含まれるドキュメントを探したいなら、

    title:"The Right Way" AND text:go

あるいは

    title:"Do it right" AND go

とします。"text" がデフォルトのフィールドなら、フィールドの指定は必須ではなくなります。

注意: フィールドが有効なのは、その直後にある単語、 フレーズあるいはサブクエリだけであることに注意しましょう。つまり、クエリ

    title:Do it right

は "Do" だけを title フィールドから探し、"it" や "right" はデフォルトのフィールドから探します。デフォルトのフィールドが `null` に設定されている場合は、"it" や "right" はすべてのフィールドから探します。

### 22.4.3. 単語の修正子

Lucene は、クエリの単語を修飾して幅広い検索オプションを指定することをサポートしています。

Zend_Search_Lucene では、現在は "~" 修正子をフレーズについてのみサポートしています。 [8]

### 22.4.4. 近接検索

Lucene は、複数の単語が指定した範囲内にあらわれる状態の検索をサポートしています。 近接検索を行うには、チルダ記号 "~" をフレーズの最後に指定します。 たとえば、"Zend" と "Framework" がお互い 10 ワードの範囲内にあらわれるドキュメントを検索するには

    "Zend Framework"~10

とします。

### 22.4.5. 単語の強調

Java Lucene および Zend_Search_Lucene は、 見つかった単語にもとづいてドキュメントの関連度を提供します。 ある単語の関連性を高くするには、キャレット記号 "^" に強調度 (数値) をあわせたものを、検索する単語の最後につなげます。 強調度を高くするほど、その単語の関連性が高くなります。

この機能を使用すると、単語の強調度によってドキュメントの関連性を制御できるようになります。 たとえば

    PHP framework

を検索しようとしており、単語 "PHP" をより重視したいとしましょう。 そんな場合は ^ 記号と強調度を単語の後に続けます。つまり

    PHP^4 framework

のようにします。これにより、PHP という単語を含むドキュメントがより重視されるようになります。 フレーズやサブクエリを強調することも可能です。たとえば

    "PHP framework"^4 "Zend Framework"

のようになります。デフォルトの強調度は 1 です。強調度には正の数値を指定しますが、 1 より小さくする (たとえば 0.2 など) ことも可能です。

### 22.4.6. 論理演算子

論理演算子によって、複数の単語を組み合わせることができます。 Lucene では、論理演算子として AND、"+"、OR、NOT および "-" をサポートしています。Java Lucene では論理演算子をすべて大文字にする必要がありますが、 Zend_Search_Lucene ではその必要はありません。

論理演算子によって、複数の単語を組み合わせることができます。 Lucene では、論理演算子として AND、"+"、OR、NOT および "-" をサポートしています。

論理クエリを作成するための方式は、大きく AND、OR および NOT の組と "+"、"-" の組に分けられます。Java Lucene とは異なり、Zend_Search_Lucene ではこれらの二つの組を混ぜて使うことはできません。

AND/OR/NOT 形式を使用する場合は、AND/OR 演算子がすべてのクエリ単語の間に存在する必要があります。 各単語の前には NOT 演算子をつけることができます。AND 演算子の優先順位は OR より高くなります。これは Java Lucene の挙動とは異なります。

#### 22.4.6.1. AND

AND 演算子の意味は、"AND グループ" のすべての単語がドキュメントにマッチしなければならないということです。

"PHP framework" および "Zend Framework" を含むドキュメントを検索するには

    "PHP framework" AND "Zend Framework"

を使用します。

#### 22.4.6.2. OR

OR 演算子は、クエリをいくつかのオプションに分割します。

"PHP framework" あるいは "Zend Framework" を含むドキュメントを検索するには

    "PHP framework" OR "Zend Framework"

を使用します。

#### 22.4.6.3. NOT

NOT 演算子は、NOT の後に続く単語を含むドキュメントを除外します。 しかし "AND グループ" が NOT 演算子つきの単語しか含まない場合は、 インデックス化されたドキュメント全体ではなく空の結果を返します。

"PHP framework" を含むが "Zend Framework" は含まないドキュメントを検索するには

    "PHP framework" AND NOT "Zend Framework"

を使用します。

#### 22.4.6.4. &&、|| および ! 演算子

&&、|| および ! は、それぞれ AND、OR および NOT 演算子の代わりに使用します。

#### 22.4.6.5. +

"+" 演算子 (必須演算子) は、 "+" 記号の後の単語が必ずドキュメントにマッチしなければならないことを意味します。

"Zend" を必ず含み、"Framework" を含んでも含まなくてもかまわないドキュメントを検索するには

    +Zend Framework

を使用します。

#### 22.4.6.6. -

"-" 演算子 (禁止演算子) は、 "-" 記号の後の単語を含むドキュメントを検索結果から除外します。

"PHP framework" は含むが "Zend Framework" は含まないドキュメントを検索するには

    "PHP framework" -"Zend Framework"

を使用します。

#### 22.4.6.7. 演算子なし

演算子を使用しなかった場合は、 その挙動は "デフォルトの boolean 演算子" として定義されます。

これは、デフォルトでは `OR` となります。

つまり、その単語は任意となるということです。 その単語はドキュメント中に存在するかもしれないし、しないかもしれません。 ただ、その単語を含むドキュメントのほうが高いスコアとなります。

"PHP framework" は必須で "Zend Framework" は含んでも含まなくてもかまわないドキュメントを検索するには

    +"PHP framework" "Zend Framework"

を使用します。

デフォルトの boolean 演算子を設定したり取得したりするには、それぞれ `Zend_Search_Lucene_Search_QueryParser::setDefaultOperator($operator)` および `Zend_Search_Lucene_Search_QueryParser::getDefaultOperator()` を使用します。

これらのメソッドで使用する定数は、 `Zend_Search_Lucene_Search_QueryParser::B_AND` および `Zend_Search_Lucene_Search_QueryParser::B_OR` です。

### 22.4.7. グループ化

Java Lucene および Zend_Search_Lucene では、 括弧を使用して条件をグループ化することによるサブクエリの作成をサポートしています。 これは、クエリのロジックを制御したい場合や異なるスタイルの論理クエリを共用したい場合などに便利です。

    +(framework OR library) +php

Zend_Search_Lucene は、あらゆるレベルのサブクエリをサポートしています。

### 22.4.8. フィールドのグループ化

Lucene では、括弧を使用して複数の条件をひとつのフィールドに適用することができます。

タイトルに単語 "return" とフレーズ "pink panther" の両方を含むドキュメントを検索するには

    title:(+return +"pink panther")

を使用します。Zend_Search_Lucene は、あらゆるレベルのサブクエリをサポートしています。

### 22.4.9. 特殊文字のエスケープ

Lucene は、クエリの文法に含まれる特殊文字のエスケープをサポートしています。 特殊文字に含まれるの文字は次のとおりです。

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

+ および - が単一の単語の中に含まれる場合は、通常の文字として扱われます。

これらの文字をエスケープするには、その文字の前に \ をつけます。 たとえば、(1+1):2 を検索するには

    \(1\+1\)\:2

を使用します。

[8] "~" はあいまい検索に用いられます。しかし、あいまい検索のクエリはまだサポートされていません。

前のページ | 上に戻る | 次のページ
22.3. インデックスの検索 | ホーム | 22.5. クエリ作成用の API