4.2.3 contains
(1) 機能
全文検索条件式に一致する文書を検索します。
(2) 書式
contains(列指定,全文検索条件式)
(3) 入力
列指定
全文検索条件式(varchar)(最大32,000バイト)
(4) 戻り値
常にTRUE
(5) 詳細
-
列指定には,全文検索をするSGMLTEXT型またはFREEWORD型の列名を指定します。
-
全文検索条件式には,検索する条件として検索対象の文書構造名,検索タームなどを指定した条件式(varchar)を指定します。
-
contains関数はインデクスと協調して動作する検索述語であり,contains関数使用時にインデクス型プラグイン(SGMLプラグインに対してn-gramインデクスプラグイン,FREEWORDプラグインに対してIXFREEWORDプラグイン)が使用できない状態の場合には,エラーとなります。インデクス型プラグイン専用関数の実行方法に関する規則については,マニュアル「HiRDB UAP開発ガイド」を参照してください。
(6) SQL文の例
- 表「reports」のSGMLTEXT型の列「doc」の「概要」部分に文字列「COMPUTER」を含む文書の件数を調べる(文書の最上位構造は「文章」)。
SELECT COUNT(*) FROM reports WHERE contains(doc, '文章[概要{"COMPUTER"}]' ) IS TRUE
- 表「reports」のFREEWORD型の列「fword」に文字列「COMPUTER」を含む文書の件数を調べる。
SELECT COUNT(*) FROM reports WHERE contains(fword, '{"COMPUTER"}' ) IS TRUE
(7) 注意事項
全文検索条件式には,複数の条件を"AND"および"OR"で指定できます。