22.3. インデックスの検索
前のページ | 第22章 Zend_Search | 次のページ

## 22.3. インデックスの検索

### 22.3.1. クエリの作成

インデックスを検索するには二通りの方法があります。 クエリパーサを使用して文字列からクエリを作成する方法と、 Zend_search_Lucene API を使用して独自のクエリを作成する方法です。

提供されているクエリパーサを使用する前に、以下の点を考慮してください。

1. プログラムで生成したクエリ文字列をクエリパーサに渡そうとしているなら、 クエリ API を使用してクエリを直接作成すべきです。言い換えると、 クエリパーサというのは人間が入力したテキストのために設計されたものであり、 プログラムが生成したテキストのためのものではないのです。

2. トークン化されていないフィールドについては、 クエリパーサを使用するよりも直接クエリに追加するほうが適しています。 フィールドの値がアプリケーションによって生成されるのなら、 フィールドのクエリ条件についても自動処理で作成すべきです。 クエリパーサが使用している解析器は、人間が入力したテキストを 単語に分解するために設計されています。 日付やキーワードなどのプログラムが生成した値は、 そのままにしておくべきでしょう。

3. 検索フォームにおいては、 テキストで入力された内容はクエリパーサを使用すべきでしょう。 その他のフィールド、例えば範囲指定やキーワードなどについては、 クエリ API に直接渡すようにしましょう。 限られた内容、例えばプルダウンメニューで選択するフィールドは、 クエリ文字列に追加すべきではありません。 その代わりに、TermQuery 条件として使用します。

4. 論理クエリにより、複数のクエリをひとつにまとめることができます。 これは、クエリ文字列で定義されるユーザ検索に条件を追加するための最良な方法です。

どちらの方法を使用したとしても、インデックスを検索する API メソッドは同じです。

    <?php

    require_once('Zend/Search/Lucene.php');

    $index = Zend_Search_Lucene::open('/data/my_index');

    $index->find($query);

    ?>

`Zend_Search_Lucene::find()` メソッドは、 入力の型を自動的に判別し、クエリパーサを使用して文字列から Zend_Search_Lucene_Search_Query オブジェクトを作成します。

重要なのは、クエリパーサは標準の解析器を使用してクエリ文字列をトークン化するということです。 インデックス化されたテキストに対するすべての変換は、クエリ文字列エントリに対しても行われます。

小文字変換を行うことで大文字小文字を区別しない検索を行えるようにしたり、 ストップワードを取り除いたりなどのさまざまなことを行います。

それに対して、API メソッドは単語の変換やフィルタリングを行いません。これは、 コンピュータが生成したフィールドやトークン化されていないフィールドに適しています。

#### 22.3.1.1. クエリのパース

`Zend_Search_Lucene_Search_QueryParser::parse()` メソッドを使用してクエリ文字列をパースし、 クエリオブジェクトに格納します。

このオブジェクトをクエリ作成 API メソッドで使用し、 ユーザが入力したクエリと機械が生成したクエリを結合します。

実際のところ、これが トークン化されたいないフィールドを検索する唯一の方法となることもあります。

    <?php
    $userQuery = Zend_Search_Lucene_Search_QueryParser::parse($queryStr);

    $pathTerm  = new Zend_Search_Lucene_Index_Term('/data/doc_dir/' . $filename, 'path');
    $pathQuery = new Zend_Search_Query_Term($pathTerm);

    $query = new Zend_Search_Query_Boolean();
    $query->addSubquery($userQuery, true /* required */);
    $query->addSubquery($pathQuery, true /* required */);

    $hits = $index->find($query);

    ?>

`Zend_Search_Lucene_Search_QueryParser::parse()` メソッドはオプションのパラメータでエンコーディングを受け取ることができます。 ここで、クエリ文字列のエンコーディングを指定します。

    $userQuery = Zend_Search_Lucene_Search_QueryParser::parse($queryStr, 'iso-8859-5');

エンコーディングを省略した場合は、現在のロケールを使用します。

デフォルトのクエリ文字列エンコーディングを `Zend_Search_Lucene_Search_QueryParser::setDefaultEncoding()` メソッドで指定することもできます。

    Zend_Search_Lucene_Search_QueryParser::setDefaultEncoding('iso-8859-5');
    ...
    $userQuery = Zend_Search_Lucene_Search_QueryParser::parse($queryStr);

`Zend_Search_Lucene_Search_QueryParser::getDefaultEncoding()` は、デフォルトのクエリ文字列エンコーディングを返します (空文字列は "現在のロケール" を表します)。

### 22.3.2. 検索結果

検索結果は Zend_Search_Lucene_Search_QueryHit オブジェクトの配列となります。 各オブジェクトは、2 つのプロパティを保持しています。 `$hit->document` がインデックス内のドキュメント番号、 `$hit->score` が検索結果のスコアを表します。 結果はスコア順に並べられます (スコアの高い結果が最初になります)。

Zend_Search_Lucene_Search_QueryHit オブジェクトでは、 検索結果としてヒットした Zend_Search_Lucene_Document の各フィールドも公開しています。 この例で、ヒットしたドキュメントには title と author の 2 つのフィールドが含まれています。

    <?php

    require_once('Zend/Search/Lucene.php');

    $index = Zend_Search_Lucene::open('/data/my_index');

    $hits = $index->find($query);

    foreach ($hits as $hit) {
        echo $hit->score;
        echo $hit->title;
        echo $hit->author;
    }

    ?>

保存されたフィールドは、常に UTF-8 エンコーディングで返されます。

オプションで、 Zend_Search_Lucene_Search_QueryHit から元の Zend_Search_Lucene_Document を取得することができます。 保存されたドキュメントを取得するには、 インデックスオブジェクトの `getDocument()` メソッドを使用し、その `getFieldValue()` メソッドでフィールドの値を取得します。

    <?php

    require_once('Zend/Search/Lucene.php');

    $index = Zend_Search_Lucene::open('/data/my_index');

    $hits = $index->find($query);
    foreach ($hits as $hit) {
        // ヒットした結果の Zend_Search_Lucene_Document オブジェクトを返します
        echo $document = $hit->getDocument();

        // Zend_Search_Lucene_Document から
        // Zend_Search_Lucene_Field オブジェクトを返します
        echo $document->getField('title');

        // Zend_Search_Lucene_Field オブジェクトを値を文字列で返します
        echo $document->getFieldValue('title');

        // getFieldValue() と同じです
        echo $document->title;
    }

    ?>

Zend_Search_Lucene_Document オブジェクトで使用可能なフィールドは、 インデックス化の際に決まります。ドキュメントのフィールドは、 インデックス化用アプリケーション (例えば LuceneIndexCreation.jar) によってインデックス化、あるいはインデックス化して保存されます。

ドキュメントを識別するフィールド (例では 'path') もインデックス化して取得できるようにしなければならないことに注意しましょう。

### 22.3.3. 結果の重み付け

Zend_Search_Lucene は、Java Lucene と同じ重み付けアルゴリズムを使用します。 検索結果に一致したものが、デフォルトで重み順に並べ替えられます。スコアの高いものが先頭となり、 スコアの高いもののほうが低いものよりクエリにマッチするようになります。

大雑把に言うと、文書の中に検索語句が頻繁に登場するほどスコアが高くなります。

検索結果のスコアを取得するには `score` プロパティを使用します。

    <?php
    $hits = $index->find($query);

    foreach ($hits as $hit) {
        echo $hit->id;
        echo $hit->score;
    }

    ?>

重みを計算するために使用されるのが Zend_Search_Lucene_Search_Similarity クラスです。詳細は 拡張性 - 重み付けのアルゴリズム を参照ください。

### 22.3.4. 検索結果の並べ替え

検索結果は、デフォルトではスコアで並べ替えられます。 これを変更するには、並べ替え用の (ひとつあるいは複数の) フィールドと並べ替えの形式、そして並べ替えの方向をパラメータで指定します。 and sort order parameters.

`$index->find()` のコール時に、オプションのパラメータを指定することができます。

    $index->find($query [, $sortField [, $sortType [, $sortOrder]]] [, $sortField2 [, $sortType [, $sortOrder]]] ...);

`$sortField` は、結果の並べ替えを行う保存されたフィールドの名前です。

`$sortType` は省略可能です。 `SORT_REGULAR` (通常の並べ替え。デフォルト)、 `SORT_NUMERIC` (数値として並べ替え)、 `SORT_STRING` (文字列として並べ替え) のいずれかとなります。

`$sortOrder` は省略可能です。 `SORT_ASC` (昇順で並べ替え。デフォルト)、 `SORT_DESC` (降順で並べ替え) のいずれかとなります。

例を以下に示します。

    $index->find($query, 'quantity', SORT_NUMERIC, SORT_DESC);

    $index->find($query, 'fname', SORT_STRING, 'lname', SORT_STRING);

    $index->find($query, 'name', SORT_STRING, 'quantity', SORT_NUMERIC, SORT_DESC);

デフォルト以外の並び順を使用する際には注意しましょう。 並べ替えのためにはドキュメント全体をインデックスから読み込む必要があり、 検索のパフォーマンスが著しく低下してしまいます。

前のページ | 上に戻る | 次のページ
22.2. インデックスの構築 | ホーム | 22.4. クエリ言語