Index has Changed Operation
-
When deploying an index:
- If the new index definition is different than the current index definition on the server,
the current index will be overwritten and data will be re-indexed according to the new index definition. - If the new index definition is the same as the one on the server,
it will not be overwritten and re-indexing will not occur upon deploying the index.
- If the new index definition is different than the current index definition on the server,
-
Prior to deploying an index:,
- Use
IndexHasChangedOperation
to check if the new index definition differs from the one
on the server to avoid any unwanted changes to the existing indexed data.
- Use
-
In this page:
Check if index has changed
// Some index definition
var indexDefinition = new IndexDefinition
{
Name = "UsersByName",
Maps = { "from user in docs.Users select new { user.Name }"}
};
// Define the has-changed operation, pass the index definition
var indexHasChangedOp = new IndexHasChangedOperation(indexDefinition);
// Execute the operation by passing it to Maintenance.Send
bool indexHasChanged = store.Maintenance.Send(indexHasChangedOp);
// Return values:
// false: The definition of the index passed is the SAME as the one deployed on the server
// true: The definition of the index passed is DIFFERENT than the one deployed on the server
// Or - index does not exist
// Some index definition
var indexDefinition = new IndexDefinition
{
Name = "UsersByName",
Maps = { "from user in docs.Users select new { user.Name }"}
};
// Define the has-changed operation, pass the index definition
var indexHasChangedOp = new IndexHasChangedOperation(indexDefinition);
// Execute the operation by passing it to Maintenance.SendAsync
bool indexHasChanged = await store.Maintenance.SendAsync(indexHasChangedOp);
// Return values:
// false: The definition of the index passed is the SAME as the one deployed on the server
// true: The definition of the index passed is DIFFERENT than the one deployed on the server
// Or - index does not exist
Syntax
public IndexHasChangedOperation(IndexDefinition definition)
Parameters | Type | Description |
---|---|---|
definition | IndexDefinition | The index definition to check |
Return Value | |
---|---|
true |
When the index does not exist on the server or - When the index definition is different than the one deployed on the server |
false |
When the index definition is the same as the one deployed on the server |