client/v2.6.2
milvus-io/milvusclient/v2.6.2Dec 29, 2025by congqixia
AI Summary
This release adds QueryIterator support for efficiently iterating over large result sets using PK-based pagination and introduces Struct Array field type support in the Go SDK.
Key Highlights
- Added QueryIterator for efficient large result set iteration.
- Added support for Struct Array field type in Go SDK.
- Configurable options include batch size, limit, filter, and output fields.
- Supports Int64 and VarChar primary key types for automatic pagination.
New Features
- QueryIterator support
- Struct Array field type support
Full Release Notes
# Release Notes - Milvus Go SDK v2.6.2
## Summary
This release introduces QueryIterator support for efficient large result set iteration and adds Struct Array field type support in the Go SDK.
## New Features
### QueryIterator Support
Added QueryIterator for efficiently iterating over large query result sets using PK-based pagination (#46633).
- Support for Int64 and VarChar primary key types for automatic pagination
- Configurable options via QueryIteratorOption:
- WithBatchSize(int) - Set batch size for each iteration (default: 1000)
- WithIteratorLimit(int64) - Set overall limit of entries to iterate
- WithFilter(string) - Set filter expression
- WithOutputFields(...string) - Specify output fields
- WithPartitions(...string) - Specify partition names
- WithConsistencyLevel(ConsistencyLevel) - Set consistency level
Usage Example:
```
opt := milvusclient.NewQueryIteratorOption("collection_name").
WithBatchSize(500).
WithFilter("age > 18").
WithOutputFields("id", "name", "vector")
iter, err := client.QueryIterator(ctx, opt)
for {
rs, err := iter.Next(ctx)
if errors.Is(err, io.EOF) {
break
}
// process rs...
}
```
## Enhancements
### Struct Array Field Type Support (#45291)
Added support for Struct Array field type in Go SDK:
- New columnStructArray type implementing the Column interface
- Support for parsing StructArrayField from protobuf responses
- Schema construction support for struct array fields via entity.FieldTypeArray
Test Infrastructure Improvements (#45113)
- Refactored go_client test wrapper to use struct embedding pattern
- Improved test structure and organization
## Related PRs
- #45113 - Refactor go_client test wrapper
- #45291 - Support struct array field type
- #46633 - Add QueryIterator support