创建键空间 #

Cassandra数据层级：

Cluster（集群）
└── Keyspace（键空间）- 类似数据库
    └── Table（表）- 类似表
        └── Partition（分区）
            └── Row（行）

CREATE KEYSPACE [IF NOT EXISTS] keyspace_name
WITH replication = {
    'class': 'replication_strategy',
    'replication_factor': number
}
[AND durable_writes = true|false];

-- 创建简单键空间
CREATE KEYSPACE my_app
WITH replication = {
    'class': 'SimpleStrategy',
    'replication_factor': 1
};

-- 使用IF NOT EXISTS避免错误
CREATE KEYSPACE IF NOT EXISTS my_app
WITH replication = {
    'class': 'SimpleStrategy',
    'replication_factor': 3
};

-- RF=1（单副本）
CREATE KEYSPACE dev_keyspace
WITH replication = {
    'class': 'SimpleStrategy',
    'replication_factor': 1
};

-- RF=2（双副本）
CREATE KEYSPACE test_keyspace
WITH replication = {
    'class': 'SimpleStrategy',
    'replication_factor': 2
};

-- RF=3（三副本）
CREATE KEYSPACE prod_keyspace
WITH replication = {
    'class': 'SimpleStrategy',
    'replication_factor': 3
};

-- 单数据中心
CREATE KEYSPACE my_app
WITH replication = {
    'class': 'NetworkTopologyStrategy',
    'datacenter1': 3
};

-- 指定数据中心名称
CREATE KEYSPACE my_app_prod
WITH replication = {
    'class': 'NetworkTopologyStrategy',
    'DC1': 3
};

-- 双数据中心
CREATE KEYSPACE global_app
WITH replication = {
    'class': 'NetworkTopologyStrategy',
    'DC1': 3,
    'DC2': 3
};

-- 多数据中心不同复制因子
CREATE KEYSPACE multi_dc_app
WITH replication = {
    'class': 'NetworkTopologyStrategy',
    'beijing': 3,
    'shanghai': 2,
    'guangzhou': 2
};

# 使用nodetool查看数据中心名称
nodetool status

# 输出示例
Datacenter: datacenter1
=======================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address    Load       Tokens  Owns    Host ID         Rack
UN  127.0.0.1  100 KB     16      100%    xxx-xxx-xxx     rack1

-- 开发环境配置
CREATE KEYSPACE dev_app
WITH replication = {
    'class': 'SimpleStrategy',
    'replication_factor': 1
}
AND durable_writes = true;

-- 测试环境配置
CREATE KEYSPACE test_app
WITH replication = {
    'class': 'NetworkTopologyStrategy',
    'datacenter1': 2
}
AND durable_writes = true;

-- 生产环境配置
CREATE KEYSPACE prod_app
WITH replication = {
    'class': 'NetworkTopologyStrategy',
    'DC1': 3,
    'DC2': 3
}
AND durable_writes = true;

-- 分析环境（禁用持久写入以提高性能）
CREATE KEYSPACE analytics_app
WITH replication = {
    'class': 'NetworkTopologyStrategy',
    'analytics_dc': 2
}
AND durable_writes = false;

-- 列出所有键空间
DESCRIBE KEYSPACES;

-- 查看特定键空间
DESCRIBE KEYSPACE my_app;

-- 查看键空间详细信息
SELECT * FROM system_schema.keyspaces
WHERE keyspace_name = 'my_app';

-- 切换到键空间
USE my_app;

-- 在键空间中创建表
CREATE TABLE users (
    user_id UUID PRIMARY KEY,
    name TEXT,
    email TEXT
);

-- 查看复制策略
SELECT keyspace_name, replication
FROM system_schema.keyspaces
WHERE keyspace_name = 'my_app';

-- 输出示例
 keyspace_name | replication
---------------+--------------------------------------------------------------------------------
        my_app | {'class': 'org.apache.cassandra.locator.NetworkTopologyStrategy', 'DC1': '3', 'DC2': '3'}

键空间命名规则：

1. 字符限制
   ✓ 字母（a-z, A-Z）
   ✓ 数字（0-9）
   ✓ 下划线（_）
   ✗ 连字符（-）
   ✗ 空格

2. 长度限制
   ✓ 建议：2-32字符
   ✗ 超过48字符

3. 大小写
   ✓ 推荐：全小写
   ✗ 混合大小写（需要引号）

-- 推荐命名
CREATE KEYSPACE user_service ...
CREATE KEYSPACE order_management ...
CREATE KEYSPACE product_catalog ...

-- 不推荐命名
CREATE KEYSPACE "UserService" ...    -- 大小写混合
CREATE KEYSPACE user-service ...     -- 包含连字符
CREATE KEYSPACE "user service" ...   -- 包含空格

复制策略选择：

开发环境
├── SimpleStrategy
└── RF=1

测试环境
├── NetworkTopologyStrategy
└── RF=2

生产环境
├── NetworkTopologyStrategy
└── RF=3（每个数据中心）

多数据中心
├── NetworkTopologyStrategy
└── 每DC=3

创建键空间注意事项：

1. 复制策略不可更改
   └── 创建后无法修改复制策略类型

2. 复制因子可调整
   └── ALTER KEYSPACE可以修改RF

3. 数据中心名称必须正确
   └── 使用nodetool status确认

4. 资源规划
   └── RF越高，存储和性能开销越大

-- 问题：键空间已存在
CREATE KEYSPACE my_app ...
-- 错误：AlreadyExists: Keyspace 'my_app' already exists

-- 解决：使用IF NOT EXISTS
CREATE KEYSPACE IF NOT EXISTS my_app ...

-- 问题：数据中心名称不匹配
CREATE KEYSPACE my_app
WITH replication = {
    'class': 'NetworkTopologyStrategy',
    'wrong_dc_name': 3
};
-- 可能成功但副本数为0

-- 解决：先确认数据中心名称
nodetool status

-- 问题：RF > 节点数
CREATE KEYSPACE my_app
WITH replication = {
    'class': 'SimpleStrategy',
    'replication_factor': 5
};
-- 集群只有3个节点

-- 解决：RF <= 节点数
-- 或者增加节点