nodetool reloadlocalschema
Reloads the local schema from disk.
Synopsis
Section titled “Synopsis”nodetool [connection_options] reloadlocalschemaSee connection options for connection options.
Description
Section titled “Description”nodetool reloadlocalschema re-reads the schema definition from the local system tables. This can help resolve schema disagreements.
Do Not Manually Modify Schema Tables
Direct modifications to schema system tables (system_schema.*) are unsupported and can corrupt the schema. Always use CQL DDL statements (CREATE, ALTER, DROP) to modify schema. The reloadlocalschema command is intended for recovery scenarios, not for applying manual edits.
Examples
Section titled “Examples”Basic Usage
Section titled “Basic Usage”nodetool reloadlocalschemaWhen to Use
Section titled “When to Use”Schema Disagreement
Section titled “Schema Disagreement”# Check for schema disagreementnodetool describecluster | grep -A 5 "Schema versions"
# If disagreement exists, try reloadingnodetool reloadlocalschemaAfter Schema Recovery
Section titled “After Schema Recovery”# After restoring schema from backupnodetool reloadlocalschemaTroubleshooting
Section titled “Troubleshooting”Persistent Schema Issues
Section titled “Persistent Schema Issues”# 1. Check schema versionsnodetool describecluster
# 2. Reload local schemanodetool reloadlocalschema
# 3. If issues persist, consider resetlocalschemanodetool resetlocalschemaRelated Commands
Section titled “Related Commands”| Command | Relationship |
|---|---|
| resetlocalschema | Reset schema from cluster |
| describecluster | View schema versions |