About OSDN
Find Software
Develop Software
Show incremental difference of selected versions of README.category（Tag） treefile info
--- /tmp/DOCMAN2ImDy0J 2024-03-23 00:26:30.152354562 +0900
+++ /tmp/DOCMAN2IoWlYp 2024-03-23 00:26:30.152354562 +0900
@@ -1,10 +1,10 @@
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ja" lang="ja">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" />
-<title>Ludia 1.0.0 README</title>
+<title>Ludia 1.1.0 README</title>
<style type="text/css">
/*
@@ -290,48 +290,52 @@
</style>
</head>
<body>
-<div class="document" id="ludia-1-0-0-readme">
-<h1 class="title">Ludia 1.0.0 README</h1>
+<div class="document" id="ludia-1-1-0-readme">
+<h1 class="title">Ludia 1.1.0 README</h1>
<div class="contents topic">
<p class="topic-title first"><a id="id1" name="id1">目次</a></p>
<ul class="simple">
-<li><a class="reference" href="#ludia" id="id23" name="id23">Ludiaについて</a><ul>
-<li><a class="reference" href="#id2" id="id24" name="id24">概要</a></li>
-<li><a class="reference" href="#id3" id="id25" name="id25">ライセンス</a></li>
-<li><a class="reference" href="#id4" id="id26" name="id26">制限事項</a></li>
-<li><a class="reference" href="#id5" id="id27" name="id27">動作環境</a></li>
-<li><a class="reference" href="#id6" id="id28" name="id28">連絡先</a></li>
+<li><a class="reference" href="#ludia" id="id27" name="id27">Ludiaについて</a><ul>
+<li><a class="reference" href="#id2" id="id28" name="id28">概要</a></li>
+<li><a class="reference" href="#id3" id="id29" name="id29">ライセンス</a></li>
+<li><a class="reference" href="#id4" id="id30" name="id30">制限事項</a></li>
+<li><a class="reference" href="#id5" id="id31" name="id31">動作環境</a></li>
+<li><a class="reference" href="#id6" id="id32" name="id32">連絡先</a></li>
</ul>
</li>
-<li><a class="reference" href="#id7" id="id29" name="id29">インストール</a></li>
-<li><a class="reference" href="#id8" id="id30" name="id30">使い方</a><ul>
-<li><a class="reference" href="#id9" id="id31" name="id31">インデックスアクセスメソッドの登録</a></li>
-<li><a class="reference" href="#id10" id="id32" name="id32">設定ファイルの編集</a></li>
-<li><a class="reference" href="#id11" id="id33" name="id33">インデックスの作成</a></li>
-<li><a class="reference" href="#id12" id="id34" name="id34">検索の実行</a></li>
-<li><a class="reference" href="#id13" id="id35" name="id35">インデックスの削除</a></li>
+<li><a class="reference" href="#id7" id="id33" name="id33">インストール</a></li>
+<li><a class="reference" href="#id8" id="id34" name="id34">バージョンアップ</a></li>
+<li><a class="reference" href="#id9" id="id35" name="id35">使い方</a><ul>
+<li><a class="reference" href="#id10" id="id36" name="id36">インデックスアクセスメソッドの登録</a></li>
+<li><a class="reference" href="#id11" id="id37" name="id37">設定ファイルの編集</a></li>
+<li><a class="reference" href="#id12" id="id38" name="id38">インデックスの作成</a></li>
+<li><a class="reference" href="#id13" id="id39" name="id39">検索の実行</a></li>
+<li><a class="reference" href="#id14" id="id40" name="id40">インデックスの削除</a></li>
</ul>
</li>
-<li><a class="reference" href="#id14" id="id36" name="id36">実行時の設定</a><ul>
-<li><a class="reference" href="#id15" id="id37" name="id37">シーケンシャルスキャンの抑制</a></li>
-<li><a class="reference" href="#id16" id="id38" name="id38">検索ヒット数の上限の設定</a></li>
-<li><a class="reference" href="#id17" id="id39" name="id39">Sennaインデックス作成時のオプション</a></li>
+<li><a class="reference" href="#id15" id="id41" name="id41">実行時の設定</a><ul>
+<li><a class="reference" href="#id16" id="id42" name="id42">シーケンシャルスキャンの抑制</a></li>
+<li><a class="reference" href="#id17" id="id43" name="id43">検索ヒット数の上限の設定</a></li>
+<li><a class="reference" href="#id18" id="id44" name="id44">Sennaインデックス作成時のオプション</a></li>
+<li><a class="reference" href="#id19" id="id45" name="id45">インデックスの同時オープン数の上限</a></li>
+<li><a class="reference" href="#id20" id="id46" name="id46">インデックスの初期サイズ</a></li>
+<li><a class="reference" href="#id21" id="id47" name="id47">設定内容の表示</a></li>
</ul>
</li>
-<li><a class="reference" href="#id18" id="id40" name="id40">使い方(応用編)</a><ul>
-<li><a class="reference" href="#id19" id="id41" name="id41">ヒット件数を高速に取得する</a></li>
-<li><a class="reference" href="#id20" id="id42" name="id42">テキストフィルタを利用する</a></li>
-<li><a class="reference" href="#snippet" id="id43" name="id43">Snippetを作成する</a></li>
-<li><a class="reference" href="#id21" id="id44" name="id44">インデックス情報を取得する</a></li>
-<li><a class="reference" href="#id22" id="id45" name="id45">バージョンを表示する</a></li>
+<li><a class="reference" href="#id22" id="id48" name="id48">使い方(応用編)</a><ul>
+<li><a class="reference" href="#id23" id="id49" name="id49">ヒット件数を高速に取得する</a></li>
+<li><a class="reference" href="#id24" id="id50" name="id50">テキストフィルタを利用する</a></li>
+<li><a class="reference" href="#snippet" id="id51" name="id51">Snippetを作成する</a></li>
+<li><a class="reference" href="#id25" id="id52" name="id52">インデックス情報を取得する</a></li>
+<li><a class="reference" href="#id26" id="id53" name="id53">バージョンを表示する</a></li>
</ul>
</li>
</ul>
</div>
<div class="section">
-<h1><a class="toc-backref" href="#id23" id="ludia" name="ludia">Ludiaについて</a></h1>
+<h1><a class="toc-backref" href="#id27" id="ludia" name="ludia">Ludiaについて</a></h1>
<div class="section">
-<h2><a class="toc-backref" href="#id24" id="id2" name="id2">概要</a></h2>
+<h2><a class="toc-backref" href="#id28" id="id2" name="id2">概要</a></h2>
<p>LudiaはPostgreSQLに高速な全文検索機能を提供します。
全文検索エンジンSennaを利用し、データベース内のテキスト情報を高速検索します。
Ludiaは以下のような特徴をもっています。</p>
@@ -349,7 +353,7 @@
</dl>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id25" id="id3" name="id3">ライセンス</a></h2>
+<h2><a class="toc-backref" href="#id29" id="id3" name="id3">ライセンス</a></h2>
<p>LudiaはOSS（オープンソースソフトウェア）です。
あなたは、Free Software Foundationが公表した
GNU Lesser General Public Licenseのバージョン2.1が定める条項に従って、
@@ -360,23 +364,22 @@
詳細は GNU LESSER GENERAL PUBLIC LICENSE Version 2.1 をお読みください。</p>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id26" id="id4" name="id4">制限事項</a></h2>
+<h2><a class="toc-backref" href="#id30" id="id4" name="id4">制限事項</a></h2>
<ul class="simple">
<li>複数列インデックスとしては使用できません。</li>
<li>一意性インデックスの機能は提供しません。</li>
-<li>VACUUMには対応していません。
-VACUUM FULL後にテーブルを更新すると、
-インデックスとテーブルの内容の整合性が取れなくなる場合があります。
-VACUUM FULLを行った場合には、インデックスを再構築してください。</li>
<li>DROP、REINDEXを実行すると、Sennaのインデックスファイルが残ります。
-( <a class="reference" href="#id13">インデックスの削除</a> の節に削除方法があります。)</li>
+( <a class="reference" href="#id14">インデックスの削除</a> の節に削除方法があります。)</li>
<li>(Ludiaのインデックスによる)CLUSTERには対応していません。</li>
<li>シーケンシャルスキャンを行う場合は一部制限があります。
-( <a class="reference" href="#id15">シーケンシャルスキャンの抑制</a> の節に詳細説明があります。)</li>
+( <a class="reference" href="#id16">シーケンシャルスキャンの抑制</a> の節に詳細説明があります。)</li>
+<li>テキストフィルタとしてTextPorterを使用する場合、
+別途購入する必要があります。
+( TextPorter Ver.4 Copyright(c) 1999-2007 Antenna House, Inc. )</li>
</ul>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id27" id="id5" name="id5">動作環境</a></h2>
+<h2><a class="toc-backref" href="#id31" id="id5" name="id5">動作環境</a></h2>
<p>以下の環境で動作確認をしています。</p>
<table class="docutils field-list" frame="void" rules="none">
<col class="field-name" />
@@ -384,57 +387,89 @@
<tbody valign="top">
<tr class="field"><th class="field-name">OS:</th><td class="field-body">RedHat Enterprise Linux AS[ES] 4</td>
</tr>
-<tr class="field"><th class="field-name">DBMS:</th><td class="field-body">PostgreSQL 8.2.3 (8.1.8)</td>
+<tr class="field"><th class="field-name">DBMS:</th><td class="field-body">PostgreSQL 8.2.4 (8.1.9)</td>
</tr>
-<tr class="field"><th class="field-name">Senna:</th><td class="field-body">1.0.1</td>
+<tr class="field"><th class="field-name">Senna:</th><td class="field-body">1.0.5 (1.0.4以前のバージョンには対応していません)</td>
</tr>
-<tr class="field"><th class="field-name">MeCab:</th><td class="field-body">0.93</td>
+<tr class="field"><th class="field-name">MeCab:</th><td class="field-body">0.95</td>
</tr>
</tbody>
</table>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id28" id="id6" name="id6">連絡先</a></h2>
+<h2><a class="toc-backref" href="#id32" id="id6" name="id6">連絡先</a></h2>
<p>バグ報告や技術的な質問については、
<a class="reference" href="http://lists.sourceforge.jp/mailman/listinfo/ludia-users">Ludia-usersメーリングリスト</a> でお問い合わせください。</p>
</div>
</div>
<div class="section">
-<h1><a class="toc-backref" href="#id29" id="id7" name="id7">インストール</a></h1>
+<h1><a class="toc-backref" href="#id33" id="id7" name="id7">インストール</a></h1>
<p>インストール方法については、
このファイルと同じディレクトリにあるINSTALLを参照してください。</p>
</div>
<div class="section">
-<h1><a class="toc-backref" href="#id30" id="id8" name="id8">使い方</a></h1>
+<h1><a class="toc-backref" href="#id34" id="id8" name="id8">バージョンアップ</a></h1>
+<p>MeCab, MeCab辞書, Sennaのバージョンに変更がない場合は、
+既存のインデックスをそのまま利用できます。
+Ludiaを上書きでインストールした後に、
+<a class="reference" href="#id10">インデックスアクセスメソッドの登録</a> と <a class="reference" href="#id11">設定ファイルの編集</a> を行い、
+pg_ctl restartコマンドでデータベースサーバを再起動してください。</p>
+<p>インデックスを再構築するする必要があるのは、以下のような場合です。</p>
+<ul class="simple">
+<li>MeCab, MeCab辞書のバージョンアップで分かち書きが変化した場合</li>
+<li>Sennaのバージョンアップでインデックスの互換性がない変更があった場合</li>
+</ul>
+<p>この場合には、 <strong>利用中のバージョンの</strong> アンインストールスクリプトを実行し、
+環境をクリーンアップしてください。
+(スクリプトを実行することで、LudiaのインデックスはすべてDROPされます。):</p>
+<pre class="literal-block">
+$ psql -f /usr/local/pgsql/share/uninstall_pgsenna2.sql test
+</pre>
+<p>その後、通常の手順でインストールを行い、データベースサーバを再起動してください。</p>
+</div>
+<div class="section">
+<h1><a class="toc-backref" href="#id35" id="id9" name="id9">使い方</a></h1>
<div class="section">
-<h2><a class="toc-backref" href="#id31" id="id9" name="id9">インデックスアクセスメソッドの登録</a></h2>
+<h2><a class="toc-backref" href="#id36" id="id10" name="id10">インデックスアクセスメソッドの登録</a></h2>
<p>Ludiaを使用するデータベースに対してインデックスアクセスメソッドを登録します。
ソースアーカイブに含まれている pgsenna2.sql をpsqlから実行してください。
(pgsenna2.sqlはPostgreSQLのshareディレクトリにインストールされます。):</p>
<pre class="literal-block">
$ psql -f /usr/local/pgsql/share/pgsenna2.sql testdb
</pre>
+<p>バージョンアップで既存の環境にインストールする場合には、
+以下のようなエラーが表示されますが、無視して問題ありません。:</p>
+<pre class="literal-block">
+ERROR: duplicate key violates unique constraint "pg_am_name_index"
+ERROR: duplicate key violates unique constraint "pg_am_name_index"
+ERROR: duplicate key violates unique constraint "pg_am_name_index"
+ERROR: operator @@ already exists
+ERROR: operator class "text_ops" for access method "fulltext" already exists
+ERROR: operator class "text_ops" for access method "fulltextb" already exists
+ERROR: operator class "text_ops" for access method "fulltextu" already exists
+</pre>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id32" id="id10" name="id10">設定ファイルの編集</a></h2>
+<h2><a class="toc-backref" href="#id37" id="id11" name="id11">設定ファイルの編集</a></h2>
<p>Ludiaを使用するデータベースクラスタのpostgresql.confファイルに、
以下の設定内容を追加してください。
設定を反映するためにはPostgreSQLを再起動する必要があります。
postgresql.confの設定が反映されていないと、
実行時にエラーになってしまうので注意してください。
-設定内容についての詳細は、 <a class="reference" href="#id14">実行時の設定</a> の節を参照してください。:</p>
+設定内容についての詳細は、 <a class="reference" href="#id15">実行時の設定</a> の節を参照してください。:</p>
<pre class="literal-block">
custom_variable_classes = 'ludia'
ludia.max_n_sort_result = 10000
ludia.enable_seqscan = on
ludia.sen_index_flags = 31
ludia.max_n_index_cache = 16
+ludia.initial_n_segments = 512
</pre>
<p>もしすでにcustom_variable_classesが設定されている場合は、
そこにludiaというクラス名を追加してください。</p>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id33" id="id11" name="id11">インデックスの作成</a></h2>
+<h2><a class="toc-backref" href="#id38" id="id12" name="id12">インデックスの作成</a></h2>
<p>ここでは、例として以下のようなテーブルを利用します。:</p>
<pre class="literal-block">
CREATE TABLE table1 (col1 text, col2 varchar(128));
@@ -457,10 +492,11 @@
<li>fulltextu : ユーザ定義</li>
</ul>
<p>の3種類があり、どれを指定するかによってSennaインデックスのフラグが変わります。
-ユーザ定義(fulltextu)の詳細は <a class="reference" href="#id17">Sennaインデックス作成時のオプション</a> の節を参照してください。</p>
+ユーザ定義(fulltextu)についての詳細は
+<a class="reference" href="#id18">Sennaインデックス作成時のオプション</a> の節を参照してください。</p>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id34" id="id12" name="id12">検索の実行</a></h2>
+<h2><a class="toc-backref" href="#id39" id="id13" name="id13">検索の実行</a></h2>
<p>Ludiaのインデックスを用いた検索を行う場合には @@ 演算子を使用します。
@@ 演算子の右辺には <a class="reference" href="http://qwik.jp/senna/query.html">Sennaの検索クエリ</a> を指定してください。</p>
<pre class="literal-block">
@@ -485,7 +521,7 @@
</pre>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id35" id="id13" name="id13">インデックスの削除</a></h2>
+<h2><a class="toc-backref" href="#id40" id="id14" name="id14">インデックスの削除</a></h2>
<p>PostgreSQLのインデックスリレーションファイルと、
Ludiaのインデックスファイルは以下の5つから構成されます。
(テーブル空間を使用している場合は、テーブル空間定義時に指定した場所に置かれます。)</p>
@@ -513,8 +549,8 @@
</pre>
<p>あるいは、pgs2destroy関数を利用すると、
データベース中の不要になったSennaインデックスファイルを一括して削除できます。
-pgs2destroy関数は、2贈ｫ5が存在するが1のファイルが存在しない、という場合に、
-2贈ｫ5のファイルを削除します。:</p>
+pgs2destroy関数は、2〜5が存在するが1のファイルが存在しない、という場合に、
+2〜5のファイルを削除します。:</p>
<pre class="literal-block">
# DROP TABLE table1;
DROP TABLE
@@ -526,13 +562,13 @@
(1 row)
</pre>
<p>関数の返り値は、削除したインデックス数です。
-(上記の2贈ｫ5のファイルで1セットです。)</p>
+(上記の2〜5のファイルで1セットです。)</p>
</div>
</div>
<div class="section">
-<h1><a class="toc-backref" href="#id36" id="id14" name="id14">実行時の設定</a></h1>
+<h1><a class="toc-backref" href="#id41" id="id15" name="id15">実行時の設定</a></h1>
<div class="section">
-<h2><a class="toc-backref" href="#id37" id="id15" name="id15">シーケンシャルスキャンの抑制</a></h2>
+<h2><a class="toc-backref" href="#id42" id="id16" name="id16">シーケンシャルスキャンの抑制</a></h2>
<p>@@演算子を用いた全文検索条件を指定しても、シーケンシャルスキャンが実行された場合には、
インデックススキャンの場合と同様の検索を行うことができません。
具体的には、スコアの取得、高速ヒット関数、近傍検索 <cite>*N</cite> 、類似検索 <cite>*S</cite> ができません。
@@ -570,8 +606,8 @@
ももから生まれた桃太郎
(2 rows)
</pre>
-<p>また、インデックスを張っていないカラムに対して@@演算子を用いた検索を行うことにより、
-Senna演算子を利用したシーケンシャルスキャンが可能となります。:</p>
+<p>インデックスを張っていないカラムに対して@@演算子指定した場合も、
+Senna演算子を利用したシーケンシャルスキャンとなります。:</p>
<pre class="literal-block">
# SELECT col1 FROM table1 WHERE col1 @@ 'もも + 桃太郎';
col1
@@ -581,10 +617,12 @@
</pre>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id38" id="id16" name="id16">検索ヒット数の上限の設定</a></h2>
-<p>Ludiaのデフォルトの設定では、
-検索でヒットした行をスコアが高い順に
-postgresql.confのludia.max_n_sort_resultで設定された行数まで返却します。:</p>
+<h2><a class="toc-backref" href="#id43" id="id17" name="id17">検索ヒット数の上限の設定</a></h2>
+<p>postgresql.confのludia.max_n_sort_resultを設定していると、
+検索でヒットした行のうち、スコア上位のものから
+max_n_sort_result件だけが返却されます。
+ただし、結果セットは必ずしもスコア順にソートされているわけではありません。
+ソートが必要な場合にはORDER BYを利用してください。:</p>
<pre class="literal-block">
# SHOW ludia.max_n_sort_result;
ludia.max_n_sort_result
@@ -611,12 +649,16 @@
すもももももももものうち | 10
(1 row)
</pre>
+<p>また、特殊な設定として、
+ludia.max_n_sort_resultを-1に設定すると上限の解除となります。
+(現状では、-1に設定すると
+pgs2getscore関数によるスコアの取得が利用できなくなります。)</p>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id39" id="id17" name="id17">Sennaインデックス作成時のオプション</a></h2>
+<h2><a class="toc-backref" href="#id44" id="id18" name="id18">Sennaインデックス作成時のオプション</a></h2>
<p>アクセスメソッドとしてfulltextuを選択すると、
インデックス作成時にSennaインデックスのフラグを指定することができます。
-利用できるフラグは(Senna 1.0.1では)以下のような定義と意味をもっています。
+利用できるフラグは(Senna 1.0.5では)以下のような定義と意味をもっています。
(詳しくは <a class="reference" href="http://qwik.jp/senna/APIJ.html">SennaのAPIドキュメント</a> を参照してください。)</p>
<pre class="literal-block">
#define SEN_INDEX_NORMALIZE 0x0001
@@ -628,18 +670,19 @@
</pre>
<dl class="docutils">
<dt>SEN_INDEX_NORMALIZE</dt>
-<dd>英文字の大文字/小文字、全角文字/半角文字を正規化してインデックスに登録する</dd>
+<dd>英文字、数字、カタカナ、記号などは全角文字/半角文字の正規化を行い、
+英文字に関しては大文字/小文字を正規化した後、インデックスに登録する。</dd>
<dt>SEN_INDEX_SPLIT_ALPHA</dt>
-<dd>N-gramインデックスで正規化を指定した際、英文字列もN文字の要素に分割する
-(それ以外の場合は連続した英文字列を１単語とする)</dd>
+<dd>N-gramインデックスで正規化を指定した際、英文字列もN文字の要素に分割する。
+(それ以外の場合は連続した英文字列を１単語とする。)</dd>
<dt>SEN_INDEX_SPLIT_DIGIT</dt>
-<dd>N-gramインデックスで正規化を指定した際、数字文字列もN文字の要素に分割する
-(それ以外の場合は連続した数字文字列を１単語とする)</dd>
+<dd>N-gramインデックスで正規化を指定した際、数字文字列もN文字の要素に分割する。
+(それ以外の場合は連続した数字文字列を１単語とする。)</dd>
<dt>SEN_INDEX_SPLIT_SYMBOL</dt>
-<dd>N-gramインデックスで正規化を指定した際、記号文字列もN文字の要素に分割する
-(それ以外の場合は、連続した記号文字列を１単語とする)</dd>
+<dd>N-gramインデックスで正規化を指定した際、記号文字列もN文字の要素に分割する。
+(それ以外の場合は、連続した記号文字列を１単語とする。)</dd>
<dt>SEN_INDEX_NGRAM</dt>
-<dd>(形態素解析ではなく)n-gramを用いる</dd>
+<dd>(形態素解析ではなく)n-gramを用いる。</dd>
<dt>SEN_INDEX_DELIMITED</dt>
<dd>(形態素解析ではなく)空白区切りで単語を区切る。</dd>
</dl>
@@ -652,11 +695,49 @@
</pre>
<p>となります。</p>
</div>
+<div class="section">
+<h2><a class="toc-backref" href="#id45" id="id19" name="id19">インデックスの同時オープン数の上限</a></h2>
+<p>Ludiaはインデックスを1つオープンするごとにメモリを確保します。
+基本的には1度オープンしたインデックスは、
+バックエンドプロセスが終了するまでクローズしません。
+ただし、
+postgresql.confのludia.max_n_index_cacheで設定された値より多くの
+インデックスを開こうとすると、
+もっとも最近利用されていないインデックスをクローズします。
+現在オープンされているインデックスは
+pgs2indexcache関数で確認することができます。:</p>
+<pre class="literal-block">
+SELECT name FROM pgs2indexcache();
+</pre>
</div>
<div class="section">
-<h1><a class="toc-backref" href="#id40" id="id18" name="id18">使い方(応用編)</a></h1>
+<h2><a class="toc-backref" href="#id46" id="id20" name="id20">インデックスの初期サイズ</a></h2>
+<p>postgresql.confの ludia.initial_n_segments * 256 [Kbyte] が
+インデックスの初期サイズとなります。
+レコード数が数百万程度に収まる場合には、
+ludia.initial_n_segmentsのデフォルト値(512)で十分であり、
+変更する必要はありません。</p>
+</div>
<div class="section">
-<h2><a class="toc-backref" href="#id41" id="id19" name="id19">ヒット件数を高速に取得する</a></h2>
+<h2><a class="toc-backref" href="#id47" id="id21" name="id21">設定内容の表示</a></h2>
+<p>pgs2getoption関数を用いると、現在の設定を確認することができます。:</p>
+<pre class="literal-block">
+# \x
+Expanded display is on.
+# SELECT * FROM pgs2getoption();
+-[ RECORD 1 ]------+----
+max_n_sort_result | 10000
+enable_seqscan | on
+sen_index_flags | 31
+max_n_index_cache | 16
+initial_n_segments | 512
+</pre>
+</div>
+</div>
+<div class="section">
+<h1><a class="toc-backref" href="#id48" id="id22" name="id22">使い方(応用編)</a></h1>
+<div class="section">
+<h2><a class="toc-backref" href="#id49" id="id23" name="id23">ヒット件数を高速に取得する</a></h2>
<p>pgs2getnhits関数を用いると、
セッション内で最後に行われたSennaの検索ヒット件数を取得することができます。:</p>
<pre class="literal-block">
@@ -701,7 +782,7 @@
</ul>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id42" id="id20" name="id20">テキストフィルタを利用する</a></h2>
+<h2><a class="toc-backref" href="#id50" id="id24" name="id24">テキストフィルタを利用する</a></h2>
<p>Ludiaのユーティリティ関数を利用することで、PDFファイルに対してインデックスを作成することができます。
ここでは <a class="reference" href="http://www.foolabs.com/xpdf/">Xpdf</a> というツールに含まれている、pdftotextというコマンドを利用します。
まずはXpdfと日本語サポートパッケージをインストールしてください。</p>
@@ -793,7 +874,7 @@
この関数はエラーを返すことに注意してください。</p>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id43" id="snippet" name="snippet">Snippetを作成する</a></h2>
+<h2><a class="toc-backref" href="#id51" id="snippet" name="snippet">Snippetを作成する</a></h2>
<p>pgs2snippet1関数を用いると、Snippet (KWIC)を作成することができます。:</p>
<pre class="literal-block">
# SELECT pgs2snippet1(1, 32, 1, '<em>', '</em>', 0, '筋肉痛',
@@ -835,7 +916,7 @@
</pre>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id44" id="id21" name="id21">インデックス情報を取得する</a></h2>
+<h2><a class="toc-backref" href="#id52" id="id25" name="id25">インデックス情報を取得する</a></h2>
<p>psg2indexinfo関数を用いると、Ludiaのインデックスの情報を取得することができます。:</p>
<pre class="literal-block">
# \x
@@ -855,7 +936,7 @@
inv_seg_size | 125997056
inv_chunk_size | 13516
</pre>
-<p>それぞれのカラムの意味は以下の通りとなります。</p>
+<p>ここで表示されるデータは以下のような意味をもっています。</p>
<blockquote>
<dl class="docutils">
<dt>filename :</dt>
@@ -868,11 +949,10 @@
<dt>flags :</dt>
<dd>インデックス作成時のludia.sen_index_flagsの値。</dd>
<dt>initial_n_segments :</dt>
-<dd>senna.confに記されたINITIAL_N_SEGMENTSの値。
-デフォルト値は512。</dd>
+<dd>インデックス作成時のludia.initial_n_segmentsの値。</dd>
<dt>encoding :</dt>
<dd>インデックスのエンコード。
-EUC-JPでは2、UTF-8では3、SJISでは4、それ以外は0。</dd>
+EUC-JPは2、UTF-8は3、SJISは4、それ以外は0。</dd>
<dt>nrecords_keys :</dt>
<dd>インデックスに含まれるレコード数。</dd>
<dt>file_size_keys :</dt>
@@ -889,13 +969,21 @@
</blockquote>
</div>
<div class="section">
-<h2><a class="toc-backref" href="#id45" id="id22" name="id22">バージョンを表示する</a></h2>
-<p>pgs2version関数を用いると、Ludiaのバージョンを見ることができます。:</p>
+<h2><a class="toc-backref" href="#id53" id="id26" name="id26">バージョンを表示する</a></h2>
+<p>pgs2version関数でLudiaのバージョンを確認することができます。:</p>
<pre class="literal-block">
# SELECT pgs2version();
pgs2version
-------------
- ludia 1.0.0
+ ludia 1.1.0
+(1 row)
+</pre>
+<p>pgs2seninfo関数でSennaのバージョンを確認することができます。:</p>
+<pre class="literal-block">
+# SELECT version, configure_option FROM pgs2seninfo();
+ version | configure_option
+---------+------------------
+ 1.0.5 | --disable-nfkc
(1 row)
</pre>
</div>
|
