hyperledger fabric 0.6 的表格查询要求按建模顺序提供完整或前缀式复合键，无法直接按非首键字段（如 status）单独查询；升级至 v1.0+ 后可通过复合键子集查询或切换至 couchdb 支持 json 全字段索引查询。
hyperledger fabric 0.6 的表格查询要求按建模顺序提供完整或前缀式复合键，无法直接按非首键字段（如 status）单独查询；升级至 v1.0+ 后可通过复合键子集查询或切换至 couchdb 支持 json 全字段索引查询。
在 Hyperledger Fabric v0.6 中，shim.CreateTable 所定义的“主键”并非传统关系型数据库中的独立索引字段，而是以有序拼接方式构成的复合键（Composite Key）。你定义的 RefNum 和 Status 均标记为 Key: true，意味着它们共同组成一个隐式排序键 —— 内部实际存储格式类似 "RefNum\x00Status"（\x00 为分隔符）。Fabric 查询时使用的是 Leveldb 的范围扫描（range query）机制，因此仅支持前缀匹配：
- ✅ 查询
RefNum="R123"→ 匹配所有以"R123\x00"开头的键（即该 RefNum 下所有 Status） - ✅ 查询
RefNum="R123", Status="SUCCESS"→ 精确匹配完整复合键 - ❌ 查询
Status="SUCCESS"→ 无法命中，因"SUCCESS"并非任何复合键的前缀（真实键以RefNum开头）
解决方案对比
| 方案 | 适用版本 | 实现要点 | 示例说明 |
|---|---|---|---|
| 多索引建模（v0.6/v1.0 兼容） | v0.6+ | 为每种常用查询维度单独建表（如 ReconByStatus），写入时同步维护多个索引表 |
插入一条记录时，同时向 Recon（主表）和 ReconByStatus（索引表）写入，后者以 Status 为唯一键 |
| 复合键子集查询（v1.0+ 推荐） | v1.0+ | 使用 stub.GetQueryResult() + JSON 查询语法（需启用 CouchDB） |
{"selector":{"Status":"SUCCESS"}} 可直接执行，无需预建索引 |
| CouchDB JSON 查询（v1.0+ 最佳实践） | v1.0+（State Database = CouchDB） | 将数据存为 JSON 文档，利用原生 Mango 查询能力 | 避免 CreateTable，改用 stub.PutState(key, []byte(jsonStr))
|
✅ 推荐实践：升级至 Fabric v2.x + CouchDB（现代方案）
// 写入示例（JSON 格式，key 可为任意唯一ID）
reconData := map[string]interface{}{
"docType": "recon",
"refNum": "R123",
"amount": "100.50",
"status": "SUCCESS",
"timestamp": time.Now().UTC().Format(time.RFC3339),
}
jsonData, _ := json.Marshal(reconData)
stub.PutState("recon-R123-20240501", jsonData) // key 仅作唯一标识
// 查询示例：任意字段组合（CouchDB Mango Query）
queryStr := `{
"selector": {
"docType": "recon",
"status": "SUCCESS"
},
"fields": ["refNum", "amount", "timestamp"]
}`
results, err := stub.GetQueryResult(queryStr)
if err != nil {
return nil, fmt.Errorf("query failed: %v", err)
}⚠️ 注意事项：
Myosin Hivemind Knowledge Retrieval下载搜索 Hivemind 精选的 Web3 营销知识库（RAG），获取从业者洞察、框架、实操指南和案例研究。当：(1) an... 时使用此技能。
- Fabric v0.6 已停止维护，强烈建议升级至 v2.5+ 并启用 CouchDB；
- 若必须维持 v0.6，唯一可行方式是冗余建模索引表（如
ReconByStatus表，结构为Status（Key）+RefNum（Value）），并在Invoke中同步更新；GetRows()在 v1.0+ 中已被弃用，应统一迁移到GetQueryResult()（CouchDB）或GetStateByPartialCompositeKey()（Leveldb 复合键前缀查询）。
通过合理选择数据模型与底层数据库，可彻底解决“部分键查询受限”问题，兼顾灵活性与性能。
