インデックスの管理

• 存在インデックス (pres) は、特定の属性を含むエントリーのリストです。たとえば、attribute=mail のようにクライアントが頻繁に検索を行う場合はこのタイプを使用します。
• 等価インデックス (eq) により、特定の属性値を含むエントリーの検索が改善されます。たとえば、cn 属性に等価インデックスを設定すると、cn=first_name last_name の検索を高速に行うことができます。
• 近似インデックス (approx) は、効率的な近似検索や音符のような検索を可能にします。たとえば、cn~=first_name last_name、cn~=first_name、または cn~=first_nam (スペルに注意) は、cn=first_name X last_name というエントリーが返されます。Directory Server の metaphone 表音アルゴリズムは US-ASCII 文字のみをサポートします。したがって、近似インデックスは、英語の値でのみ使用してください。
• 部分文字列インデックス (sub) は、維持するためのコストがかかるインデックスですが、エントリー内の部分文字列に対して効率的な検索が可能になります。部分文字列のインデックスは、各エントリーの最小 3 文字に制限されます。たとえば、telephoneNumber=*555* と検索すると、telephoneNumber 属性に 555 を含む値を持つディレクトリー内のすべてのエントリーが返されます。
• 国際インデックスは、国際ディレクトリー内の情報の検索を迅速化します。国際インデックスの作成プロセスは、通常のインデックスを作成するプロセスと似ています。ただし、オブジェクト識別子 (OID) をインデックス化する属性に関連付けることで一致するルールを適用する点が異なります。

• 近似インデックスは、通常、数字を含む属性 (電話番号など) には効率的ではありません。
• 部分文字列のインデックスはバイナリー属性では機能しません。
• イメージなど、大きな値を含む属性の等価インデックスは回避してください。
• 検索で一般的に使用されない属性のインデックスを維持すると、検索パフォーマンスを向上させることなくオーバーヘッドが増加します。
• インデックス化されていない属性は、検索要求で依然として使用できますが、検索のタイプによっては検索パフォーマンスが大幅に低下する可能性があります。

手順

• たとえば、インデックスタイプが eq と sub のデフォルトインデックスに roomNumber 属性を追加するには、次のように入力します。

  # ldapadd -D "cn=Directory Manager" -W -H ldap://server.example.com -x
  
  dn: cn=roomNumber,cn=default indexes,cn=config,cn=ldbm database,cn=plugins,cn=config
  objectClass: nsIndex
  objectClass: top
  cn: roomNumber
  nsSystemIndex: false
  nsIndexType: eq
  nsIndexType: sub

  Copy to Clipboard Toggle word wrap

  以下は、LDIF ステートメントの説明です。

  • objectClass: nsIndex: このエントリーがインデックスエントリーであることを定義します。
  • objectClass: top: このオブジェクトクラスは、インデックスエントリーで追加的に必要となります。
  • cn: インデックスに属性の名前を設定します。
  • nsSystemIndex: インデックスが Directory Server の運用に必須であるかどうかを示します。
  • nsIndexType: この多値属性は、インデックスタイプを指定します。

• たとえば、roomNumber 属性のデフォルトのインデックス属性に pres インデックスタイプを追加するには、次のように入力します。

  # ldapmodify -D "cn=Directory Manager" -W -H ldap://server.example.com -x
  
  dn: cn=roomNumber,cn=default indexes,cn=config,cn=ldbm database,cn=plugins,cn=config
  changetype: modify
  add: nsIndexType
  nsIndexType: pres

  Copy to Clipboard Toggle word wrap

• たとえば、roomNumber 属性のデフォルトのインデックス属性から pres インデックスタイプを削除するには、次のように入力します。

  # ldapmodify -D "cn=Directory Manager" -W -H ldap://server.example.com -x
  
  dn: cn=roomNumber,cn=default indexes,cn=config,cn=ldbm database,cn=plugins,cn=config
  changetype: modify
  delete: nsIndexType
  nsIndexType: pres

  Copy to Clipboard Toggle word wrap

• たとえば、デフォルトのインデックスから roomNumber 属性を削除するには、次のように入力します。

  # ldapdelete -D "cn=Directory Manager" -W -H ldap://server.example.com -x cn=roomNumber,cn=default indexes,cn=config,cn=ldbm database,cn=plugins,cn=config

  Copy to Clipboard Toggle word wrap

検証

• デフォルトのインデックス属性をリスト表示して、変更を確認します。

  # ldapsearch -H ldap://server.example.com:389 -D "cn=Directory Manager" -W -b "cn=default indexes,cn=config,cn=ldbm database,cn=plugins,cn=config" -x -s one -o ldif-wrap=no

  Copy to Clipboard Toggle word wrap

• 存在インデックス (pres) は、特定の属性を含むエントリーのリストです。たとえば、attribute=mail のようにクライアントが頻繁に検索を行う場合はこのタイプを使用します。
• 等価インデックス (eq) により、特定の属性値を含むエントリーの検索が改善されます。たとえば、cn 属性に等価インデックスを設定すると、cn=first_name last_name の検索を高速に行うことができます。
• 近似インデックス (approx) は、効率的な近似検索や音符のような検索を可能にします。たとえば、cn~=first_name last_name、cn~=first_name、または cn~=first_nam (スペルに注意) は、cn=first_name X last_name というエントリーが返されます。Directory Server の metaphone 表音アルゴリズムは US-ASCII 文字のみをサポートします。したがって、近似インデックスは、英語の値でのみ使用してください。
• 部分文字列インデックス (sub) は、維持するためのコストがかかるインデックスですが、エントリー内の部分文字列に対して効率的な検索が可能になります。部分文字列のインデックスは、各エントリーの最小 3 文字に制限されます。たとえば、telephoneNumber=*555* と検索すると、telephoneNumber 属性に 555 を含む値を持つディレクトリー内のすべてのエントリーが返されます。
• 国際インデックスは、国際ディレクトリー内の情報の検索を迅速化します。国際インデックスの作成プロセスは、通常のインデックスを作成するプロセスと似ています。ただし、オブジェクト識別子 (OID) をインデックス化する属性に関連付けることで一致するルールを適用する点が異なります。

• 近似インデックスは、通常、数字を含む属性 (電話番号など) には効率的ではありません。
• 部分文字列のインデックスはバイナリー属性では機能しません。
• イメージなど、大きな値を含む属性の等価インデックスは回避してください。
• 検索で一般的に使用されない属性のインデックスを維持すると、検索パフォーマンスを向上させることなくオーバーヘッドが増加します。
• インデックス化されていない属性は、検索要求で依然として使用できますが、検索のタイプによっては検索パフォーマンスが大幅に低下する可能性があります。

手順

• たとえば、userRoot データベースのインデックスに roomNumber 属性を追加するには、インデックスタイプが eq と sub の場合、次のように入力します。

  # dsconf -D "cn=Directory Manager" ldap://server.example.com backend index add --attr roomNumber --index-type eq --index-type sub --reindex userRoot

  Copy to Clipboard Toggle word wrap

  --reindex オプションを付けると、Directory Server が自動的にデータベースのインデックスを再作成します。

• たとえば、userRoot データベースの roomNumber 属性のインデックス設定に pres インデックスタイプを追加するには、次のように入力します。

  # dsconf -D "cn=Directory Manager" ldap://server.example.com backend index set --attr roomNumber --add-type pres userRoot

  Copy to Clipboard Toggle word wrap

• たとえば、userRoot データベースの roomNumber 属性のインデックス設定から pres インデックスタイプを削除するには、次のように入力します。

  # dsconf -D "cn=Directory Manager" ldap://server.example.com backend index set --attr roomNumber --del-type pres userRoot

  Copy to Clipboard Toggle word wrap

• たとえば、userRoot データベースのインデックスから roomNumber 属性を削除するには、次のように入力します。

  # dsconf -D "cn=Directory Manager" ldap://server.example.com backend index delete --attr roomNumber userRoot

  Copy to Clipboard Toggle word wrap

検証

• userRoot データベースのインデックス設定をリスト表示します。

  # dsconf -D "cn=Directory Manager" ldap://server.example.com backend index list userRoot

  Copy to Clipboard Toggle word wrap

前提条件

• インデックスエントリーを作成しているか、既存の userRoot データベースに追加のインデックスタイプを追加している。

検証

• userRoot データベースのインデックス設定をリスト表示します。

  # dsconf -D "cn=Directory Manager" ldap://server.example.com backend index list userRoot

  Copy to Clipboard Toggle word wrap

前提条件

• Web コンソールでインスタンスにログインしている。

手順

• Database → Suffixes → suffix_name → Indexes → Database Indexes に移動します。

  • インデックスに属性を追加するには、以下を行います。

    • Add Index をクリックします。
    • Select An Attribute フィールドに属性名を入力します。
    • インデックスタイプを選択します。
    • Index attribute after creation を選択します。
    • Create Index をクリックします。

  • 属性のインデックス設定を更新するには、以下を行います。

    • 属性の横にあるオーバーフローメニューをクリックし、Edit Index を選択します。
    • インデックスの設定を必要に応じて変更してください。
    • Index attribute after creation を選択します。
    • Save Index をクリックします。

  • インデックスから属性を削除するには、以下を行います。

    • 属性の横にあるオーバーフローメニューをクリックし、Delete Index を選択します。
    • Yes, I am sure を選択して、Delete をクリックします。
    • Suffix Tasks メニューで Reindex Suffix を選択します。

検証

• Database → Suffixes → suffix_name → Indexes → Database Indexes に移動し、インデックスの設定に変更が反映されていることを確認します。

• before は、対象のエントリーの前に返されるエントリーの数を設定します。
• after は、対象のエントリーの後に返されるエントリーの数を設定します。
• index、count、および value は、ターゲットエントリーの決定に役立ちます。value を設定すると、ターゲットエントリーは、その値で始まる最初の並べ替え属性を持つ最初のエントリーになります。それ以外の場合は、count を 0 に設定し、ターゲットエントリーは index 値 (1 から開始) によって決定されます。count 値が 0 より大きい場合、ターゲットエントリーは index * number of entries / count によって決定されます。

手順

• oid=2.16.840.1.113730.3.4.9,cn=features,cn=config の ACI を更新します。

  # ldapmodify -D "cn=Directory Manager" -W -H ldap://server.example.com -x
  
  dn: oid=2.16.840.1.113730.3.4.9,cn=features,cn=config
  changetype: modify
  replace: aci
  aci: (targetattr != "aci")(version 3.0; acl "VLV Request Control"; allow( read, search, compare, proxy ) userdn = "ldap:///anyone";)

  Copy to Clipboard Toggle word wrap

検証

• バインドユーザーを指定せずに、VLV コントロールでクエリーを実行します。

  # ldapsearch -H ldap://server.example.com -b "ou=People,dc=example,dc=com" -s one -x -E 'sss=cn' -E 'vlv=1/2/70/0' uid

  Copy to Clipboard Toggle word wrap

  このコマンドでは、サーバーが匿名バインドを許可する必要があります。

  コマンドが成功してもエントリーが返されない場合は、バインドユーザーを使用してクエリーを再度実行し、認証の使用時にクエリーが機能することを確認します。

前提条件

• クライアントアプリケーションは VLV コントロールを使用している。
• クライアントアプリケーションでは、大規模な検索結果の連続したサブセットに対してクエリーを実行する必要がある。
• ディレクトリーには多数のエントリーが含まれている。

前提条件

• Web コンソールでインスタンスにログインしている。
• クライアントアプリケーションは VLV コントロールを使用している。
• クライアントアプリケーションでは、大規模な検索結果の連続したサブセットに対してクエリーを実行する必要がある。
• ディレクトリーには多数のエントリーが含まれている。