dsetool reload_core

Reloads the search index to recognize changes to schema or configuration.

Reloads the search index to recognize changes to schema or configuration. Supports DSE authentication with [-l username -p password].
Note: To reload the core and prevent reindexing, accept the default values reindex=false and deleteAll=false.

See Reloading the search index for details.

Synopsis

dsetool reload_core keyspace_name.table_name 
[coreOptions=yamlFile | coreOptionsInline=key1:value1#key2:value2#...]
[deleteAll=true|false]
[distributed=true|false]
[reindex=true|false]
[schema=path] 
[solrconfig=path]
Table 1. Legend
Syntax conventions Description
UPPERCASE Literal keyword.
Lowercase Not literal.
Italics Variable value. Replace with a valid option or user-defined value.
[ ] Optional. Square brackets ( [ ] ) surround optional command arguments. Do not type the square brackets.
( ) Group. Parentheses ( ( ) ) identify a group to choose from. Do not type the parentheses.
| Or. A vertical bar ( | ) separates alternative elements. Type any one of the elements. Do not type the vertical bar.
... Repeatable. An ellipsis ( ... ) indicates that you can repeat the syntax element as often as required.
'Literal string' Single quotation ( ' ) marks must surround literal strings in CQL statements. Use single quotation marks to preserve upper case.
{ key:value } Map collection. Braces ( { } ) enclose map collections or key value pairs. A colon separates the key and the value.
<datatype1,datatype2> Set, list, map, or tuple. Angle brackets ( < > ) enclose data types in a set, list, map, or tuple. Separate the data types with a comma.
cql_statement; End CQL statement. A semicolon ( ; ) terminates all CQL statements.
[ -- ] Separate the command line options from the command arguments with two hyphens ( -- ). This syntax is useful when arguments might be mistaken for command line options.
' <schema> ... </schema> ' Search CQL only: Single quotation marks ( ' ) surround an entire XML schema declaration.
@xml_entity='xml_entity_type' Search CQL only: Identify the entity and literal value to overwrite the XML element in the schema and solrconfig files.
keyspace_name.table_name
Required. The keyspace and table names of the search index. Keyspace and table names are case-sensitive. Enclose names that contain uppercase in double quotation marks.
schema=path
Path of the UTF-8 encoded search index schema file. Cannot be specified when generateResources=true.
Important: To ensure that non-indexed fields in the table are retrievable by queries, you must include those fields in the schema file. For more information, see Solr single-pass CQL queries.
solrconfig=path
Path of the UTF-8 encoded search index configuration file. Cannot be specified when generateResources=true.
distributed=( true | false )
Whether to distribute and apply the operation to all nodes in the local datacenter.
  • True applies the operation to all nodes in the local datacenter.
  • False applies the operation only to the node it was sent to. False works only when recovery=true.
Warning: Distributing a re-index to an entire datacenter degrades performance severely in that datacenter.
reindex=( true | false )
Whether to reindex the data when search indexes are auto-generated with generateResources=true. Reindex works on a datacenter (DC) level. Reindex only once per search-enabled DC. Repeat the reindex command on other data centers as required.
Valid values:
  • true - Default. Reindexes the data. Accepts reads and keeps the current search index while the new index is building.
  • false - Does not reindex the data. You can check and customize search index resources before indexing.
deleteAll=( true|false )
  • true - deletes the already existing index before reindexing; search results will return either no or partial data while the index is rebuilding.
  • false - does not delete the existing index, causing the reindex to happen in-place; search results will return partially incorrect results while the index is updating. Default.
During reindexing, a series of criteria routes sub-queries to the nodes most capable of handling them. See Shard routing for distributed queries.

Examples

To make the pending search index active:

dsetool reload_core demo.health_data coreOptionsInline="directory_factory_class:solr.EncryptedFSDirectoryFactory"

To upload the changed resource file:

dsetool reload_core demo.health_data coreOptionsInline="directory_factory_class:solr.EncryptedFSDirectoryFactory"