Global Configuration Record (GCR)

Definition

The Global Configuration Record is created automatically in the Endeca data domain, and can be modified if needed. This information persists if you restart that data domain.

During record updates, the Dgraph validation process validates the configuration of the Global Configuration Record, and returns errors if its requirements are not met. The requirements are as follows:

The mdex-config_Key attribute must be unique and single-assign. The value must be global.
The Global Configuration Record must contain valid allowable values for all of its attributes. None of its attributes can be omitted.
The Global Configuration Record cannot have any arbitrary, user-defined attributes.

The Global Configuration Record controls the following areas of the Endeca data domain configuration:

Area of global configuration	What you can do...
Wildcard search enablement	Specify whether wildcard search should be enabled or disabled for value search in the Endeca data domain. By default, it is disabled.
Search characters	List which characters you want to identify as search characters for queries.
Merge policy	Optionally, change the policy that the Endeca data domain uses in the background to merge its generations of data files. The default policy – `balanced` – is recommended, and is optimized for best performance.
Spelling correction settings	Control which words are eligible for the spelling dictionary by specifying the following parameters: Minimum word occurrence Minimum word length Maximum word length Note: If you change the spelling settings in the Global Configuration Record, you must run the Endeca Server `endeca-cmd` `update-spelling-dictionaries` command in order for them to take effect.

Modifying the settings in the Global Configuration Record

To change the Global Configuration Record settings, use the Configuration Web Service's putGlobalConfigRecord operation or one of the data ingest interfaces (such as the Data Ingest Web Service).

Required attributes of the GCR

The Global Configuration Record has required attributes, but it cannot have arbitrary, user-defined attributes. The required attributes are:

Attribute	Type	Description
`mdex-config_Key`	`String`	The only value for this attribute is `global`. This attribute is unique and single-assign. It cannot be modified.
`mdex-config_EnableValueSearchWildcard`	`Boolean`	If set to `true`, then wildcard search is enabled for value search. If set to `false`, then wildcard search is disabled. The default value is `false.` While you can change these values without restrictions, changing them has a performance cost.
`mdex-config_MergePolicy`	`String`	The allowed values are `balanced` or `aggressive`. The default is `balanced`. The value for this attribute can be modified if needed.
`mdex-config_SearchChars`	`String`	The characters to use as search characters in the Oracle Endeca Server. The allowed values are strings that are listed sequentially and are not separated by commas or spaces. Each string is a search character. While you can values for this attribute without restrictions, changing them has a performance cost.
`mdex-config_SystemRecordVersion`	`String`	The version of the system records in the Oracle Endeca Server. This attribute is used by the Oracle Endeca Server and should not be modified.
`mdex-config_SpellingRecordMinWordOccur`	`Int`	The minimum number of times a word must occur in a standard attribute value (record assignment on a standard attribute, in a key value pair) for it to affect the configuration for spelling correction. The default value is 4. You can modify various spelling settings. The values for spelling must not be negative.
`mdex-config_SpellingRecordMinWordLength`	`Int`	The minimum number of characters that a word can contain in a standard attribute value for it to affect the configuration for spelling correction. The default value is 3. You can modify various spelling settings. The values for spelling must not be negative.
`mdex-config_SpellingRecordMaxWordLength`	`Int`	The maximum number of characters that a word can contain in a standard attribute value for it to affect the spelling correction. The default value is 16. You can modify various spelling settings. The values for spelling must not be negative.
`mdex-config_SpellingDValMinWordOccur`	`Int`	The minimum number of times a word must occur in a managed attribute value for it to affect the spelling correction. The default value is 1. You can modify various spelling settings. The values for spelling must not be negative.
`mdex-config_SpellingDValMinWordLength`	`Int`	The minimum number of characters that a word must contain in a managed attribute value for it to affect the spelling correction. The default value is 3. You can modify various spelling settings. The values for spelling must not be negative.
`mdex-config_SpellingDValMaxWordLength`	`Int`	The maximum number of characters that a word may contain in a managed attribute value for it to affect the spelling correction. The default value is 16. You can modify various spelling settings. The values for spelling must not be negative.