第19章 Ickle クエリー言語を使用したクエリーの構築

フルテキスト拡張を持つ JP-QL の軽量小型のサブセットである Ickle を使用すると、ライブラリーモードとリモートクライアントサーバーモードの両方でリレーショナルおよびフルテキストクエリーを作成することができます。Ickleは文字別ベースのクエリー言語で、以下の特徴があります。

API を使用するには、最初に QueryFactory をキャッシュで取得し、.create() メソッドを呼び出してクエリーで使用する文字列を渡します。以下に例を示します。

QueryFactory qf = Search.getQueryFactory(remoteCache);
Query q = qf.create("from sample_bank_account.Transaction where amount > 20");

Ickle を使用する場合、フルテキスト演算子と使用されるすべてのフィールドはインデックス化され、分析される必要があります。

Ickle は JP-QL のサブセットですが、クエリー構文に以下の違いがあります。

ファジークエリーを実行するには、単語の後に ~ と、単語からの距離を表す整数を追加します。例を以下に示します。

Query fuzzyQuery = qf.create("from sample_bank_account.Transaction where description : 'cofee'~2");

範囲クエリーを実行するには、以下の例のように境界を角括弧で囲んで定義します。

Query rangeQuery = qf.create("from sample_bank_account.Transaction where amount : [20 to 50]");

単語の組み合わせを検索するには、以下の例のように引用符で囲みます

Query q = qf.create("from sample_bank_account.Transaction where description : 'bus fare'");

近接クエリーを実行し、特定の距離内にある 2 つの単語を見つけるには、それらの言葉の後に ~ とその距離を追加します。たとえば以下の例では、間に 3 つ以下の言葉が存在する canceling および fee を見つけます。

Query proximityQuery = qf.create("from sample_bank_account.Transaction where description : 'canceling fee'~3 ");

単一文字および複数文字のワイルドカード検索を実行できます。

text または test を検索するには、以下のように単一文字のワイルドカード検索を使用できます。

Query wildcardQuery = qf.create("from sample_bank_account.Transaction where description : 'te?t'");

test、tests、または tester を検索するには、以下のように複数文字のワイルドカード検索を使用できます。

Query wildcardQuery = qf.create("from sample_bank_account.Transaction where description : 'test*'");

正規表現クエリーを実行するには、/ の間にパターンを指定します。Ickle は Lucene の正規表現構文を使用するため、以下を使用して moat または boat を検索できます。

Query regExpQuery = qf.create("from sample_library.Book  where title : /[mb]oat/");

単語の後に ^ を追加し、クエリーでの関連度を高めると、単語をブーストすることができます。ブースト係数が高いほど単語の関連度も高くなります。たとえば、beer と wine が含まれる書名を検索し、beer の係数が 3 大きい場合、以下を使用できます。

Query boostedQuery = qf.create("from sample_library.Book where title : beer^3 OR wine");