Interstage Application Server Smart Repositoryユーザーズガイド

1.6 エントリの検索

　エントリの検索操作は、以下のように行います。

1. 検索範囲を指定して情報を絞り込みます。
2. 検索範囲内の各エントリの属性値に対して、フィルタ条件を指定して一致したものだけを取り出します。

　検索範囲、およびフィルタについて以下に示します。

検索範囲

　検索する指定範囲には、以下の3種類があります。

検索範囲	内容
ベースオブジェクト検索	指定したエントリそのものを検索します。
ワンレベル検索	指定したエントリの1階層下を検索します。
サブツリー検索	指定したエントリとその階層配下すべてを検索します。

検索フィルタ

　検索フィルタには、以下の5つを指定することができます。

フィルタ	内容
同値 (equal)	指定した値と同じ属性値がある場合に、取り出します。
部分文字列 (substring)	指定した部分文字列を含む属性値がある場合に、取り出します。 部分文字列には、前方一致、後方一致、任意一致、およびこれらを組み合わせて指定することができます。
より大きい (greater)	指定した値より大きい値の属性値がある場合に、取り出します。
より小さい (less)	指定した値より小さい値の属性値がある場合に、取り出します。
存在 (present)	属性値がある場合に、取り出します。

　また、上記の各検索フィルタを組み合わせることで、より詳細に指定することができます。以下に組み合わせに使用する論理演算を示します。

論理演算	内容
論理積 (AND)	複数の検索フィルタを論理積（AND）条件で結びます。 すべての条件が真の場合に、有効となります。
論理和 (OR)	複数の検索フィルタを論理和（OR）条件で結びます。 いずれかの条件が真の場合に、有効となります。

検索フィルタの文法

　Smart Repositoryのクライアントで使用できる検索フィルタ(RFC1558準拠)とその使用例を示します。

　検索フィルタの文法は、以下のRFC文書に記述されています。

• RFC1960 ： “A String Representation of LDAP Search Filters”
• RFC2254 ： “The String Representation of LDAP Search Filters”

• 同値（=）
  　cnがUser001であるエントリを検索します。

  cn=User001

  　

• より大きい（>=）、より小さい（<=）
  　dnQualifierが0より大きいエントリを検索します。

  dnQualifier>=0

  　

• 存在（=*）
  　cnを含む全エントリを検索します。

  cn=*

  　

• 部分文字列（文字列*）
  　cnがFujitsuで始まるエントリだけを検索します。

  cn=Fujitsu*

  　

• 論理積（&）
  　cnがUser001で、かつsnがFujitsuであるエントリを検索します。

  (&(cn=User001)(sn=Fujitsu))

  　

• 論理和（|）
  　givenNameがUser001、またはUser002であるエントリを検索します。

  (|(givenName=User001)(givenName=User002))

• 検索フィルタを指定する場合は、検索フィルタを“"”（ダブルクォーテーション）で囲んで指定してください。
• 論理和を指定して、検索条件を指定できるのは、2つまでです。
  以下のような指定は不正な検索フィルタとなります。

  (|(givenName=User001)(givenName=User002)(mail=*))

特殊文字の指定方法

　検索フィルタの値に、検索する値として以下の特殊文字を指定する場合、その特殊文字を“\”(エンマーク)でエスケープした後に16進数として指定する必要があります。
　16進数での指定が必要な特殊文字の一覧を以下に示します。

特殊文字	16進数	指定方法
*	0x2a	\2a
(	0x28	\28
)	0x29	\29
\	0x5c	\5c

　検索フィルタの値に“富士通(株)”を指定する場合、以下のように指定します。

(o=富士通\28株\29)

検索可能最大エントリ数、検索タイムアウト時間指定時の動作について

　検索可能最大エントリ数、および検索タイムアウト時間は、Smart Repositoryサーバ側と、クライアント側とでそれぞれ指定できます。
　Smart Repositoryサーバ側の指定とクライアント側の指定との関係を下表に示します。

クライアントから アクセスするDN (バインドするDN)	クライアント 指定値	サーバ指定値と クライアント指定値との関係	有効となる指定
管理者用DN	あり	サーバ＞クライアント	クライアント指定値
	あり	サーバ≦クライアント	クライアント指定値
	制限しない	-	クライアント指定値
その他	あり	サーバ＞クライアント	クライアント指定値
	あり	サーバ≦クライアント	サーバ指定値
	制限しない	-	サーバ指定値

　検索可能最大エントリ数と検索タイムアウト時間のクライアント側での指定方法は、以下を参照してください。

• C言語の場合

  　“リファレンスマニュアル(API編)”の“Smart Repositoryインタフェース”-“セションハンドルオプションの設定/参照インタフェース”のLDAP_OPT_SIZELIMIT、LDAP_OPT_TIMELIMIT

  　“リファレンスマニュアル(API編)”の“Smart Repositoryインタフェース”-“エントリの検索インタフェース”

• JNDIの場合

  　“Smart Repositoryサーバへのアクセス”の“エントリの検索”