Skip to content
Maintained by AxonOps — production-grade documentation from engineers who operate distributed databases at scale

nodetool reloadlocalschema

Reloads the local schema from disk.

Synopsis

nodetool [connection_options] reloadlocalschema

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

Basic Usage

nodetool reloadlocalschema

When to Use

Schema Disagreement

# Check for schema disagreement
nodetool describecluster | grep -A 5 "Schema versions"

# If disagreement exists, try reloading
nodetool reloadlocalschema

After Schema Recovery

# After restoring schema from backup
nodetool reloadlocalschema

Troubleshooting

Persistent Schema Issues

# 1. Check schema versions
nodetool describecluster

# 2. Reload local schema
nodetool reloadlocalschema

# 3. If issues persist, consider resetlocalschema
nodetool resetlocalschema
Command Relationship
resetlocalschema Reset schema from cluster
describecluster View schema versions