nodetool resetlocalschema
Resets the local schema by fetching it from another node.
Synopsis
Section titled “Synopsis”nodetool [connection_options] resetlocalschemaSee connection options for connection options.
Description
Section titled “Description”nodetool resetlocalschema discards the local schema and fetches a fresh copy from another node in the cluster. This is useful for resolving schema disagreements when a node has incorrect or corrupted schema.
Destructive Operation
This discards the local schema entirely. Ensure other nodes have the correct schema before running.
Examples
Section titled “Examples”Basic Usage
Section titled “Basic Usage”nodetool resetlocalschemaWhen to Use
Section titled “When to Use”Persistent Schema Disagreement
Section titled “Persistent Schema Disagreement”# Check schema versionsnodetool describecluster | grep -A 5 "Schema versions"
# If this node has unique/wrong schemanodetool resetlocalschemaAfter Failed Schema Migration
Section titled “After Failed Schema Migration”# If schema migration left node in bad statenodetool resetlocalschemaProcess Flow
Section titled “Process Flow”1. Local schema tables are truncated2. Schema is fetched from another node3. Local schema is rebuilt4. Node should match cluster schemaBest Practices
Section titled “Best Practices”Guidelines
- Verify cluster schema - Ensure other nodes are correct
- Last resort - Try reloadlocalschema first
- Monitor after - Verify schema agreement
Related Commands
Section titled “Related Commands”| Command | Relationship |
|---|---|
| reloadlocalschema | Reload local schema |
| describecluster | View schema versions |