Backend Index

Backend Indexes are used to store information that makes it possible to locate entries very quickly when processing search operations.

Indexing is performed on a per-attribute level and different types of indexing may be performed for different kinds of attributes, based on how they are expected to be accessed during search operations.

Dependencies

The following objects have Backend Indexes:

Properties

Use the --advanced option to access advanced properties.

Basic Properties

attribute

SynopsisSpecifies the name of the attribute for which the index is to be maintained.
Default ValueNone
Allowed ValuesThe name of an attribute type defined in the LDAP schema.
Multi-valuedNo
RequiredYes
Admin Action RequiredNone
AdvancedNo
Read-OnlyYes

confidentiality-enabled

SynopsisSpecifies whether contents of the index should be confidential.
DescriptionSetting the flag to true will hash keys for equality type indexes using SHA-1 and encrypt the list of entries matching a substring key for substring indexes.
Default Valuefalse
Allowed Valuestrue
false
Multi-valuedNo
RequiredNo
Admin Action RequiredNone
If the index for the attribute must be protected for security purposes and values for that attribute already exist in the database, the index must be rebuilt before it will be accurate. The property cannot be set on a backend for which confidentiality is not enabled.
AdvancedNo
Read-OnlyNo

index-extensible-matching-rule

SynopsisThe extensible matching rule in an extensible index.
DescriptionAn extensible matching rule must be specified using either LOCALE or OID of the matching rule.
Default ValueNo extensible matching rules will be indexed.
Allowed ValuesA Locale or an OID.
Multi-valuedYes
RequiredNo
Admin Action RequiredNone
The index must be rebuilt before it will reflect the new value.
AdvancedNo
Read-OnlyNo

index-type

SynopsisSpecifies the type(s) of indexing that should be performed for the associated attribute.
DescriptionFor equality, presence, and substring index types, the associated attribute type must have a corresponding matching rule.
Default ValueNone
Allowed Values

approximate: This index type is used to improve the efficiency of searches using approximate matching search filters.

equality: This index type is used to improve the efficiency of searches using equality search filters.

extensible: This index type is used to improve the efficiency of searches using extensible matching search filters.

ordering: This index type is used to improve the efficiency of searches using "greater than or equal to" or "less then or equal to" search filters.

presence: This index type is used to improve the efficiency of searches using the presence search filters.

substring: This index type is used to improve the efficiency of searches using substring search filters.

Multi-valuedYes
RequiredYes
Admin Action RequiredNone
If any new index types are added for an attribute, and values for that attribute already exist in the database, the index must be rebuilt before it will be accurate.
AdvancedNo
Read-OnlyNo

Advanced Properties

index-entry-limit

SynopsisSpecifies the maximum number of entries that are allowed to match a given index key before that particular index key is no longer maintained.
DescriptionThis is analogous to the ALL IDs threshold in the Sun Java System Directory Server. If this is specified, its value overrides the JE backend-wide configuration. For no limit, use 0 for the value. Changing the index entry limit significantly can result in serious performance degradation. Please read the documentation before changing this setting.
Default Value4000
Allowed ValuesAn integer. Lower limit: 0. Upper limit: 2147483647.
Multi-valuedNo
RequiredNo
Admin Action RequiredNone
If any index keys have already reached this limit, indexes must be rebuilt before they will be allowed to use the new limit.
AdvancedYes
Read-OnlyNo

substring-length

SynopsisThe length of substrings in a substring index.
Default Value6
Allowed ValuesAn integer. Lower limit: 3.
Multi-valuedNo
RequiredNo
Admin Action RequiredNone
The index must be rebuilt before it will reflect the new value.
AdvancedYes
Read-OnlyNo