Pause Index Operation
-
Use
StopIndexOperation
to pause a single index in the database. -
To pause indexing for ALL indexes in the database use StopIndexingOperation.
-
In this page:
Overview
Which node is the index paused for?
-
When pausing the index from the client:
The index will be paused for the preferred node only, Not for all database-group nodes. -
When pausing the index from the Studio indexes list view:
The index will be paused for the local node the browser is opened on, even if it is Not the preferred node.
What happens when an index is paused for a node?
-
A paused index performs no indexing for the node it is paused for.
New data is indexed by the index on database-group nodes that the index is not paused for. -
A paused index can be queried, but results may be stale when querying the node that the index is paused for.
Resuming the index:
-
Learn how to resume an index by a client here: Resume index
-
Learn to resume an index from Studio here: Indexes list view
-
Pausing the index is Not a persistent operation.
This means the paused index will resume upon either of the following:- The server is restarted.
- The database is re-loaded (by disabling and then enabling it).
Toggling the database state can be done using the Studio database list view,
or using ToggleDatabasesStateOperation by the client.
-
Resetting a paused index will resume the normal operation of the index
on the local node where the reset action was performed. -
Modifying the index definition will resume the normal operation of the index
on all the nodes for which it is paused.
Pause index example
// Define the pause index operation, pass the index name
const pauseIndexOp = new StopIndexOperation("Orders/Totals");
// Execute the operation by passing it to maintenance.send
await store.maintenance.send(pauseIndexOp);
// At this point:
// Index 'Orders/Totals' is paused on the preferred node
// Can verify the index status on the preferred node by sending GetIndexingStatusOperation
const indexingStatus = await store.maintenance.send(new GetIndexingStatusOperation());
const index = indexingStatus.indexes.find(x => x.name === "Orders/Totals")
assert.strictEqual(index.status, "Paused");
Syntax
// class name has "Stop", but this is ok, this is the "Pause" operation
const pauseIndexOp = new StopIndexOperation(indexName);
Parameters | Type | Description |
---|---|---|
indexName | string | Name of an index to pause |