Cassandra 的 JDBC 驱动（如 Magnitude/Simba）不支持通过 DatabaseMetaData.getPrimaryKeys() 返回有效的 PK_NAME，因其元数据实现未映射 CQL 主键结构；推荐改用原生 DataStax Java 驱动或解析系统表获取主键信息。
cassandra 的 jdbc 驱动（如 magnitude/simba）不支持通过 `databasemetadata.getprimarykeys()` 返回有效的 `pk_name`，因其元数据实现未映射 cql 主键结构；推荐改用原生 datastax java 驱动或解析系统表获取主键信息。
在基于 Cassandra 构建的数据访问层中，开发者常期望复用标准 JDBC 元数据 API（例如 DatabaseMetaData.getPrimaryKeys()）来动态识别表的主键列。然而，使用 Magnitude（原 Simba）提供的闭源 Cassandra JDBC 驱动时，调用 pk.getString("PK_NAME") 恒返回 null，即使 COLUMN_NAME 能正确输出分区键或聚簇列名。这并非代码错误，而是驱动对 CQL 模型的元数据抽象存在根本性限制：Cassandra 的“主键”是逻辑复合结构（含 PRIMARY KEY (partition_key, clustering_col1, ...)），而非关系型数据库中单一命名的约束（如 CONSTRAINT pk_users PRIMARY KEY (id)），因此 JDBC 驱动无法映射出符合 JDBC 规范的 PK_NAME 字段。
✅ 推荐替代方案
1. 使用 DataStax Java 驱动（首选）
原生驱动直接暴露 CQL Schema 信息，可精准获取主键定义：
import com.datastax.oss.driver.api.core.CqlSession;
import com.datastax.oss.driver.api.core.metadata.schema.ColumnMetadata;
import com.datastax.oss.driver.api.core.metadata.schema.TableMetadata;
try (CqlSession session = CqlSession.builder().build()) {
TableMetadata table = session.getMetadata()
.getKeyspace("your_keyspace")
.flatMap(ks -> ks.getTable("your_table"))
.orElseThrow(() -> new RuntimeException("Table not found"));
// 获取主键列（按声明顺序：partition keys + clustering columns）
List<ColumnMetadata> primaryKeyColumns = table.getPrimaryKey();
System.out.println("Primary key columns: " +
primaryKeyColumns.stream()
.map(ColumnMetadata::getName)
.collect(Collectors.joining(", ")));
}⚠️ 注意：table.getPrimaryKey() 返回的是完整主键序列（含分区键与聚簇列），若需区分，可结合 table.getPartitionKey() 和 table.getClusteringColumns()。
2. 查询系统表（JDBC 场景下的兜底方案）
若必须沿用 JDBC 驱动，可通过查询 system_schema.columns 获取主键信息：
SELECT column_name, kind
FROM system_schema.columns
WHERE keyspace_name = 'your_keyspace'
AND table_name = 'your_table'
AND kind IN ('partition_key', 'clustering')
ORDER BY position;执行该查询后，kind = 'partition_key' 对应分区键，kind = 'clustering' 对应聚簇列，二者合起来即为完整的 CQL 主键。
? 总结与建议
- 不要依赖 getPrimaryKeys().getString("PK_NAME")：该字段在 Cassandra JDBC 驱动中无意义，属设计局限，非 Bug。
- 优先迁移到 DataStax Java Driver：提供类型安全、异步友好、Schema 感知强的 API，且完全开源、持续维护。
- 避免自行拼装主键逻辑：Cassandra 主键语义复杂（如复合分区键、降序聚簇等），应以驱动/系统表返回的权威结构为准。
- 如因企业合规必须使用 Simba 驱动，请联系 Magnitude 技术支持确认最新版本是否增强元数据支持——但历史版本均未实现 PK_NAME 填充。
