Files
wehub-resource-sync 498b235461
Build and test / Build and test AMD64 Ubuntu 22.04 (push) Failing after 0s
Publish Builder / amazonlinux2023 (push) Failing after 1s
Build and test / UT for Go (push) Has been skipped
Publish KRTE Images / KRTE (push) Failing after 1s
Build and test / Integration Test (push) Has been skipped
Build and test / Upload Code Coverage (push) Has been skipped
Publish Builder / rockylinux9 (push) Failing after 1s
Publish Builder / ubuntu22.04 (push) Failing after 0s
Publish Builder / ubuntu24.04 (push) Failing after 0s
Publish Gpu Builder / publish-gpu-builder (push) Failing after 1s
Publish Test Images / PyTest (push) Failing after 0s
Build and test / UT for Cpp (push) Has been cancelled
chore: import upstream snapshot with attribution
2026-07-13 12:31:17 +08:00

547 lines
15 KiB
Go

// Licensed to the LF AI & Data foundation under one
// or more contributor license agreements. See the NOTICE file
// distributed with this work for additional information
// regarding copyright ownership. The ASF licenses this file
// to you under the Apache License, Version 2.0 (the
// "License"); you may not use this file except in compliance
// with the License. You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package compactor
import (
"context"
"fmt"
"math"
"github.com/apache/arrow/go/v17/arrow/array"
"github.com/cockroachdb/errors"
"github.com/samber/lo"
"go.uber.org/atomic"
"github.com/milvus-io/milvus-proto/go-api/v3/schemapb"
"github.com/milvus-io/milvus/internal/allocator"
"github.com/milvus-io/milvus/internal/compaction"
"github.com/milvus-io/milvus/internal/flushcommon/io"
"github.com/milvus-io/milvus/internal/flushcommon/writebuffer"
"github.com/milvus-io/milvus/internal/storage"
"github.com/milvus-io/milvus/pkg/v3/common"
"github.com/milvus-io/milvus/pkg/v3/mlog"
"github.com/milvus-io/milvus/pkg/v3/proto/datapb"
"github.com/milvus-io/milvus/pkg/v3/proto/etcdpb"
"github.com/milvus-io/milvus/pkg/v3/util/merr"
"github.com/milvus-io/milvus/pkg/v3/util/paramtable"
"github.com/milvus-io/milvus/pkg/v3/util/typeutil"
)
// Not concurrent safe.
type MultiSegmentWriter struct {
ctx context.Context
binlogIO io.BinlogIO
allocator *compactionAlloactor
writer *storage.BinlogValueWriter
currentSegmentID typeutil.UniqueID
maxRows int64
segmentSize int64
// segmentSize in Bytes
// segmentSize might be changed dynamicly. To make sure a compaction plan is static,
// The target segmentSize is defined when creating the compaction plan.
schema *schemapb.CollectionSchema
partitionID int64
collectionID int64
channel string
batchSize int
binLogMaxSize uint64
res []*datapb.CompactionSegment
storageVersion int64
params compaction.Params
rwOption []storage.RwOption
}
type compactionAlloactor struct {
segmentAlloc allocator.Interface
logIDAlloc allocator.Interface
segmentIDBudgetExhausted bool
}
var errCompactionSegmentIDsExhausted = errors.New("pre-allocated compaction segment IDs exhausted")
func NewCompactionAllocator(segmentAlloc, logIDAlloc allocator.Interface) *compactionAlloactor {
return &compactionAlloactor{
segmentAlloc: segmentAlloc,
logIDAlloc: logIDAlloc,
}
}
func (alloc *compactionAlloactor) allocSegmentID() (typeutil.UniqueID, error) {
if alloc.isSegmentIDBudgetExhausted() {
return 0, errCompactionSegmentIDsExhausted
}
return alloc.segmentAlloc.AllocOne()
}
func (alloc *compactionAlloactor) isSegmentIDBudgetExhausted() bool {
return alloc.segmentIDBudgetExhausted
}
func (alloc *compactionAlloactor) markSegmentIDBudgetExhausted() {
alloc.segmentIDBudgetExhausted = true
}
func NewMultiSegmentWriter(ctx context.Context, binlogIO io.BinlogIO, allocator *compactionAlloactor, segmentSize int64,
schema *schemapb.CollectionSchema, params compaction.Params,
maxRows int64, partitionID, collectionID int64, channel string, batchSize int, rwOption ...storage.RwOption,
) (*MultiSegmentWriter, error) {
rwOpts := rwOption
if len(rwOption) == 0 {
rwOpts = make([]storage.RwOption, 0)
}
return &MultiSegmentWriter{
ctx: ctx,
binlogIO: binlogIO,
allocator: allocator,
maxRows: maxRows, // For bloomfilter only
segmentSize: segmentSize,
schema: schema,
partitionID: partitionID,
collectionID: collectionID,
channel: channel,
batchSize: batchSize,
binLogMaxSize: params.BinLogMaxSize,
res: make([]*datapb.CompactionSegment, 0),
storageVersion: params.StorageVersion,
params: params,
rwOption: rwOpts,
}, nil
}
func (w *MultiSegmentWriter) closeWriter() error {
if w.writer != nil {
writer := w.writer
w.writer = nil
if err := writer.Close(); err != nil {
return err
}
fieldBinlogs, statsLog, bm25Logs, manifest, expirQuantiles := writer.GetLogs()
rowNum := writer.GetRowNum()
writtenUncompressed := writer.GetWrittenUncompressed()
result := &datapb.CompactionSegment{
SegmentID: w.currentSegmentID,
InsertLogs: storage.SortFieldBinlogs(fieldBinlogs),
Field2StatslogPaths: []*datapb.FieldBinlog{statsLog},
NumOfRows: rowNum,
Channel: w.channel,
Bm25Logs: lo.Values(bm25Logs),
StorageVersion: w.storageVersion,
Manifest: manifest,
ExpirQuantiles: expirQuantiles,
}
w.res = append(w.res, result)
mlog.Info(w.ctx, "created new segment",
mlog.FieldSegmentID(w.currentSegmentID),
mlog.String("channel", w.channel),
mlog.Int64("totalRows", rowNum),
mlog.Uint64("totalSize", writtenUncompressed),
mlog.Int64("expected segment size", w.segmentSize),
mlog.Int64("storageVersion", w.storageVersion))
}
return nil
}
func (w *MultiSegmentWriter) rotateWriter() error {
newSegmentID, err := w.allocator.allocSegmentID()
if err != nil {
if allocator.IsIDExhausted(err) {
return errors.Mark(err, errCompactionSegmentIDsExhausted)
}
return err
}
if err := w.closeWriter(); err != nil {
return err
}
chunkSize := w.binLogMaxSize
w.rwOption = append(w.rwOption,
storage.WithUploader(func(ctx context.Context, kvs map[string][]byte) error {
return w.binlogIO.Upload(ctx, kvs)
}),
storage.WithVersion(w.storageVersion),
)
rw, err := storage.NewBinlogRecordWriter(w.ctx, w.collectionID, w.partitionID, newSegmentID,
w.schema, w.allocator.logIDAlloc, chunkSize, w.maxRows, w.rwOption...,
)
if err != nil {
return err
}
w.currentSegmentID = newSegmentID
w.writer = storage.NewBinlogValueWriter(rw, w.batchSize)
return nil
}
func (w *MultiSegmentWriter) rotateWriterOrGrowCurrent() error {
if w.writer == nil {
return w.rotateWriter()
}
if w.allocator.isSegmentIDBudgetExhausted() {
return nil
}
if w.writer.GetWrittenUncompressed() < uint64(w.segmentSize) {
return nil
}
if err := w.rotateWriter(); err != nil {
if !errors.Is(err, errCompactionSegmentIDsExhausted) {
return err
}
w.allocator.markSegmentIDBudgetExhausted()
writtenUncompressed := w.writer.GetWrittenUncompressed()
mlog.Warn(w.ctx, "pre-allocated compaction segment IDs exhausted, continue writing current segment",
mlog.Int64("collectionID", w.collectionID),
mlog.Int64("partitionID", w.partitionID),
mlog.String("channel", w.channel),
mlog.Int64("segmentID", w.currentSegmentID),
mlog.Uint64("currentSize", writtenUncompressed),
mlog.Int64("expectedSegmentSize", w.segmentSize),
mlog.Err(err))
}
return nil
}
func (w *MultiSegmentWriter) GetWrittenUncompressed() uint64 {
if w.writer == nil {
return 0
}
return w.writer.GetWrittenUncompressed()
}
func (w *MultiSegmentWriter) GetBufferUncompressed() uint64 {
if w.writer == nil {
return 0
}
return w.writer.GetBufferUncompressed()
}
func (w *MultiSegmentWriter) GetCompactionSegments() []*datapb.CompactionSegment {
return w.res
}
func (w *MultiSegmentWriter) Write(r storage.Record) error {
if err := w.rotateWriterOrGrowCurrent(); err != nil {
return err
}
return w.writer.Write(r)
}
func (w *MultiSegmentWriter) WriteValue(v *storage.Value) error {
if err := w.rotateWriterOrGrowCurrent(); err != nil {
return err
}
return w.writer.WriteValue(v)
}
// Flush calls storage.SerializeWriter.Flush(), it is used for serialize the value buffer to record and write to binlog.
// Note: the record is not written to binlog immediately, it will be written when the buffer is full or the writer is closed.
// Call this function before record iteration to avoid the underlying record be released.
func (w *MultiSegmentWriter) Flush() error {
if w.writer == nil {
return nil
}
return w.writer.Flush()
}
func (w *MultiSegmentWriter) FlushChunk() error {
if w.writer == nil {
return nil
}
if err := w.writer.Flush(); err != nil {
return err
}
return w.writer.FlushChunk()
}
func (w *MultiSegmentWriter) Close() error {
if w.writer != nil {
return w.closeWriter()
}
return nil
}
type SegmentWriter struct {
writer *storage.BinlogSerializeWriter
closers []func() (*storage.Blob, error)
tsFrom typeutil.Timestamp
tsTo typeutil.Timestamp
pkstats *storage.PrimaryKeyStats
bm25Stats map[int64]*storage.BM25Stats
segmentID int64
partitionID int64
collectionID int64
sch *schemapb.CollectionSchema
rowCount *atomic.Int64
syncedSize *atomic.Int64
batchSize int
maxBinlogSize uint64
}
func (w *SegmentWriter) GetRowNum() int64 {
return w.rowCount.Load()
}
func (w *SegmentWriter) GetCollectionID() int64 {
return w.collectionID
}
func (w *SegmentWriter) GetPartitionID() int64 {
return w.partitionID
}
func (w *SegmentWriter) GetSegmentID() int64 {
return w.segmentID
}
func (w *SegmentWriter) GetPkID() int64 {
return w.pkstats.FieldID
}
func (w *SegmentWriter) WrittenMemorySize() uint64 {
return w.writer.GetWrittenUncompressed()
}
func (w *SegmentWriter) WriteRecord(r storage.Record) error {
tsArray := r.Column(common.TimeStampField).(*array.Int64)
rows := r.Len()
for i := 0; i < rows; i++ {
ts := typeutil.Timestamp(tsArray.Value(i))
if ts < w.tsFrom {
w.tsFrom = ts
}
if ts > w.tsTo {
w.tsTo = ts
}
switch schemapb.DataType(w.pkstats.PkType) {
case schemapb.DataType_Int64:
pkArray := r.Column(w.GetPkID()).(*array.Int64)
pk := &storage.Int64PrimaryKey{
Value: pkArray.Value(i),
}
w.pkstats.Update(pk)
case schemapb.DataType_VarChar:
pkArray := r.Column(w.GetPkID()).(*array.String)
pk := storage.NewVarCharPrimaryKey(pkArray.Value(i))
w.pkstats.Update(pk)
default:
panic("invalid data type")
}
for fieldID, stats := range w.bm25Stats {
field, ok := r.Column(fieldID).(*array.Binary)
if !ok {
return merr.WrapErrServiceInternalMsg("bm25 field value not found")
}
stats.AppendBytes(field.Value(i))
}
w.rowCount.Inc()
}
return w.writer.Write(r)
}
func (w *SegmentWriter) Write(v *storage.Value) error {
ts := typeutil.Timestamp(v.Timestamp)
if ts < w.tsFrom {
w.tsFrom = ts
}
if ts > w.tsTo {
w.tsTo = ts
}
w.pkstats.Update(v.PK)
for fieldID, stats := range w.bm25Stats {
data, ok := v.Value.(map[storage.FieldID]interface{})[fieldID]
if !ok {
return merr.WrapErrServiceInternalMsg("bm25 field value not found")
}
bytes, ok := data.([]byte)
if !ok {
return merr.WrapErrServiceInternalMsg("bm25 field value not sparse bytes")
}
stats.AppendBytes(bytes)
}
w.rowCount.Inc()
return w.writer.WriteValue(v)
}
func (w *SegmentWriter) Finish() (*storage.Blob, error) {
w.writer.Flush()
codec := storage.NewInsertCodecWithSchema(&etcdpb.CollectionMeta{ID: w.collectionID, Schema: w.sch})
return codec.SerializePkStats(w.pkstats, w.GetRowNum())
}
func (w *SegmentWriter) GetBm25Stats() map[int64]*storage.BM25Stats {
return w.bm25Stats
}
func (w *SegmentWriter) GetBm25StatsBlob() (map[int64]*storage.Blob, error) {
result := make(map[int64]*storage.Blob)
for fieldID, stats := range w.bm25Stats {
bytes, err := stats.Serialize()
if err != nil {
return nil, err
}
result[fieldID] = &storage.Blob{
Key: fmt.Sprintf("%d", fieldID),
Value: bytes,
RowNum: stats.NumRow(),
MemorySize: int64(len(bytes)),
}
}
return result, nil
}
func (w *SegmentWriter) IsFull() bool {
return w.writer.GetWrittenUncompressed() > w.maxBinlogSize
}
func (w *SegmentWriter) FlushAndIsFull() bool {
w.writer.Flush()
return w.writer.GetWrittenUncompressed() > w.maxBinlogSize
}
func (w *SegmentWriter) IsFullWithBinlogMaxSize(binLogMaxSize uint64) bool {
return w.writer.GetWrittenUncompressed() > binLogMaxSize
}
func (w *SegmentWriter) IsEmpty() bool {
return w.writer.GetWrittenUncompressed() == 0
}
func (w *SegmentWriter) FlushAndIsEmpty() bool {
w.writer.Flush()
return w.writer.GetWrittenUncompressed() == 0
}
func (w *SegmentWriter) GetTimeRange() *writebuffer.TimeRange {
return writebuffer.NewTimeRange(w.tsFrom, w.tsTo)
}
func (w *SegmentWriter) SerializeYield() ([]*storage.Blob, *writebuffer.TimeRange, error) {
w.writer.Flush()
w.writer.Close()
fieldData := make([]*storage.Blob, len(w.closers))
for i, f := range w.closers {
blob, err := f()
if err != nil {
return nil, nil, err
}
fieldData[i] = blob
}
tr := w.GetTimeRange()
if err := w.clear(); err != nil {
return nil, nil, err
}
return fieldData, tr, nil
}
func (w *SegmentWriter) GetTotalSize() int64 {
return w.syncedSize.Load() + int64(w.writer.GetWrittenUncompressed())
}
func (w *SegmentWriter) clear() error {
w.syncedSize.Add(int64(w.writer.GetWrittenUncompressed()))
writer, closers, err := newBinlogWriter(w.collectionID, w.partitionID, w.segmentID, w.sch, w.batchSize)
if err != nil {
return err
}
w.writer = writer
w.closers = closers
w.tsFrom = math.MaxUint64
w.tsTo = 0
return nil
}
// deprecated: use NewMultiSegmentWriter instead
func NewSegmentWriter(sch *schemapb.CollectionSchema, maxCount int64, batchSize int, segID, partID, collID int64, Bm25Fields []int64) (*SegmentWriter, error) {
writer, closers, err := newBinlogWriter(collID, partID, segID, sch, batchSize)
if err != nil {
return nil, err
}
pkField, err := typeutil.GetPrimaryFieldSchema(sch)
if err != nil {
mlog.Warn(context.TODO(), "failed to get pk field from schema")
return nil, err
}
stats, err := storage.NewPrimaryKeyStats(pkField.GetFieldID(), int64(pkField.GetDataType()), maxCount)
if err != nil {
return nil, err
}
segWriter := SegmentWriter{
writer: writer,
closers: closers,
tsFrom: math.MaxUint64,
tsTo: 0,
pkstats: stats,
bm25Stats: make(map[int64]*storage.BM25Stats),
sch: sch,
segmentID: segID,
partitionID: partID,
collectionID: collID,
rowCount: atomic.NewInt64(0),
syncedSize: atomic.NewInt64(0),
batchSize: batchSize,
maxBinlogSize: paramtable.Get().DataNodeCfg.BinLogMaxSize.GetAsUint64(),
}
for _, fieldID := range Bm25Fields {
segWriter.bm25Stats[fieldID] = storage.NewBM25Stats()
}
return &segWriter, nil
}
func newBinlogWriter(collID, partID, segID int64, schema *schemapb.CollectionSchema, batchSize int,
) (writer *storage.BinlogSerializeWriter, closers []func() (*storage.Blob, error), err error) {
fieldWriters := storage.NewBinlogStreamWriters(collID, partID, segID, schema)
closers = make([]func() (*storage.Blob, error), 0, len(fieldWriters))
for _, w := range fieldWriters {
closers = append(closers, w.Finalize)
}
writer, err = storage.NewBinlogSerializeWriter(schema, partID, segID, fieldWriters, batchSize)
return writer, closers, err
}