dsetool reload_core

Reloads the search index to recognize changes to schema or configuration. Supports DSE authentication with [-l username -p password].

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]
Syntax conventions
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.

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.

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. Reindexing 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 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 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"

Was this helpful?

Give Feedback

How can we improve the documentation?

© 2024 DataStax | Privacy policy | Terms of use

Apache, Apache Cassandra, Cassandra, Apache Tomcat, Tomcat, Apache Lucene, Apache Solr, Apache Hadoop, Hadoop, Apache Pulsar, Pulsar, Apache Spark, Spark, Apache TinkerPop, TinkerPop, Apache Kafka and Kafka are either registered trademarks or trademarks of the Apache Software Foundation or its subsidiaries in Canada, the United States and/or other countries. Kubernetes is the registered trademark of the Linux Foundation.

General Inquiries: +1 (650) 389-6000, info@datastax.com