修改键空间 #

可修改属性：
├── 复制策略
├── 复制因子
├── 持久化写入设置
└── 表配置（间接影响）

ALTER KEYSPACE keyspace_name
WITH replication = {
    'class': 'replication_strategy',
    ...
}
[AND durable_writes = true|false];

-- 修改复制因子
ALTER KEYSPACE my_keyspace
WITH replication = {
    'class': 'SimpleStrategy',
    'replication_factor': 5
};

-- 修改持久化写入
ALTER KEYSPACE my_keyspace
WITH durable_writes = false;

-- SimpleStrategy增加RF
ALTER KEYSPACE my_keyspace
WITH replication = {
    'class': 'SimpleStrategy',
    'replication_factor': 5
};

-- NetworkTopologyStrategy增加RF
ALTER KEYSPACE production_ks
WITH replication = {
    'class': 'NetworkTopologyStrategy',
    'dc1': 5,
    'dc2': 3
};

-- 增加后需要执行repair
-- nodetool repair my_keyspace

-- SimpleStrategy减少RF
ALTER KEYSPACE my_keyspace
WITH replication = {
    'class': 'SimpleStrategy',
    'replication_factor': 3
};

-- NetworkTopologyStrategy减少RF
ALTER KEYSPACE production_ks
WITH replication = {
    'class': 'NetworkTopologyStrategy',
    'dc1': 3,
    'dc2': 2
};

-- 减少后数据自动清理

# 增加复制因子后执行repair
nodetool repair my_keyspace

# 查看repair进度
nodetool repair -pr my_keyspace

# 并行repair（大集群）
nodetool repair my_keyspace -par

-- 查看当前配置
DESCRIBE KEYSPACE my_keyspace;

-- 切换策略
ALTER KEYSPACE my_keyspace
WITH replication = {
    'class': 'NetworkTopologyStrategy',
    'datacenter1': 3
};

-- 切换后执行repair
-- nodetool repair my_keyspace

-- 添加新数据中心
ALTER KEYSPACE global_ks
WITH replication = {
    'class': 'NetworkTopologyStrategy',
    'dc1': 3,
    'dc2': 3,
    'dc3': 2  -- 新增数据中心
};

-- 移除数据中心
ALTER KEYSPACE global_ks
WITH replication = {
    'class': 'NetworkTopologyStrategy',
    'dc1': 3,
    'dc2': 3
};

-- 调整各数据中心RF
ALTER KEYSPACE global_ks
WITH replication = {
    'class': 'NetworkTopologyStrategy',
    'dc1': 5,  -- 增加
    'dc2': 3,
    'dc3': 1   -- 减少
};

-- 启用（推荐）
ALTER KEYSPACE my_keyspace
WITH durable_writes = true;

-- 禁用（不推荐生产使用）
ALTER KEYSPACE my_keyspace
WITH durable_writes = false;

-- 注意：禁用后节点故障可能丢失数据

-- 原配置（开发）
-- CREATE KEYSPACE app_ks
-- WITH replication = {
--     'class': 'SimpleStrategy',
--     'replication_factor': 1
-- };

-- 修改为测试配置
ALTER KEYSPACE app_ks
WITH replication = {
    'class': 'NetworkTopologyStrategy',
    'test_dc': 2
}
AND durable_writes = true;

-- 执行repair
-- nodetool repair app_ks

-- 原配置（测试）
-- CREATE KEYSPACE app_ks
-- WITH replication = {
--     'class': 'NetworkTopologyStrategy',
--     'test_dc': 2
-- };

-- 修改为生产配置
ALTER KEYSPACE app_ks
WITH replication = {
    'class': 'NetworkTopologyStrategy',
    'prod_dc1': 3,
    'prod_dc2': 3
}
AND durable_writes = true;

-- 执行repair
-- nodetool repair app_ks

-- 原配置（单数据中心）
-- CREATE KEYSPACE app_ks
-- WITH replication = {
--     'class': 'NetworkTopologyStrategy',
--     'dc1': 3
-- };

-- 扩展为多数据中心
ALTER KEYSPACE app_ks
WITH replication = {
    'class': 'NetworkTopologyStrategy',
    'dc1': 3,
    'dc2': 3,
    'dc3': 2
};

-- 执行repair
-- nodetool repair app_ks

-- 查看键空间详情
DESCRIBE KEYSPACE my_keyspace;

-- 输出示例
CREATE KEYSPACE my_keyspace WITH replication = {
    'class': 'NetworkTopologyStrategy',
    'dc1': '3',
    'dc2': '3'
} AND durable_writes = true;

-- 查询键空间配置
SELECT * FROM system_schema.keyspaces
WHERE keyspace_name = 'my_keyspace';

-- 查看复制配置
SELECT keyspace_name, replication
FROM system_schema.keyspaces
WHERE keyspace_name = 'my_keyspace';

注意事项：
├── 需要足够的磁盘空间
├── 执行repair可能耗时
├── 建议在低峰期执行
├── 监控集群负载
└── 分批执行repair

注意事项：
├── 数据会自动清理
├── 确保剩余副本足够
├── 注意可用性影响
└── 监控数据分布

注意事项：
├── 数据会重新分布
├── 必须执行repair
├── 可能影响性能
├── 建议在维护窗口执行
└── 提前备份数据

-- 错误
ALTER KEYSPACE nonexistent_ks ...;
-- Error: Keyspace 'nonexistent_ks' doesn't exist

-- 解决：先创建键空间
CREATE KEYSPACE IF NOT EXISTS nonexistent_ks ...;

-- 错误：复制因子超过节点数
ALTER KEYSPACE my_ks
WITH replication = {
    'class': 'SimpleStrategy',
    'replication_factor': 10  -- 但只有3个节点
};

-- 解决：设置合理的复制因子
ALTER KEYSPACE my_ks
WITH replication = {
    'class': 'SimpleStrategy',
    'replication_factor': 3
};

-- 错误
ALTER KEYSPACE my_ks
WITH replication = {
    'class': 'NetworkTopologyStrategy',
    'wrong_dc': 3
};

-- 解决：使用正确的数据中心名称
-- 先查看：nodetool status
ALTER KEYSPACE my_ks
WITH replication = {
    'class': 'NetworkTopologyStrategy',
    'datacenter1': 3
};

# 查看repair状态
nodetool repair -pr my_keyspace

# 查看流式传输
nodetool netstats

# 查看节点状态
nodetool status

# 查看数据分布
nodetool ring

# 查看表统计
nodetool tablestats my_keyspace

# 查看磁盘使用
nodetool cfstats my_keyspace

修改流程：
├── 1. 备份重要数据
├── 2. 查看当前配置
├── 3. 规划修改内容
├── 4. 在测试环境验证
├── 5. 选择低峰期执行
├── 6. 执行修改
├── 7. 执行repair
├── 8. 验证修改结果
└── 9. 监控集群状态