milvus/internal/util/importutilv2/binlog/l0_reader_test.go
wei liu 46dfe260da
enhance: Add timestamp filtering support to L0Reader (#43747)
issue: #43745
Add timestamp filtering capability to L0Reader to match the
functionality available in the regular Reader. This enhancement allows
filtering delete records based on timestamp range during L0 import
operations.

Changes include:
- Add tsStart and tsEnd fields to l0Reader struct for timestamp
filtering
- Modify NewL0Reader function signature to accept tsStart and tsEnd
parameters
- Implement timestamp filtering logic in Read method to skip records
outside the specified range
- Update L0ImportTask and L0PreImportTask to parse timestamp parameters
from request options and pass them to NewL0Reader
- Add comprehensive test case TestL0Reader_ReadWithTsFilter to verify ts
filtering functionality using mockey framework

Signed-off-by: Wei Liu <wei.liu@zilliz.com>
2025-08-06 16:49:39 +08:00

176 lines
5.3 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 binlog
import (
"context"
"fmt"
"io"
"math"
"os"
"testing"
"github.com/bytedance/mockey"
"github.com/cockroachdb/errors"
"github.com/stretchr/testify/assert"
"github.com/stretchr/testify/mock"
"github.com/milvus-io/milvus/internal/mocks"
"github.com/milvus-io/milvus/internal/storage"
"github.com/milvus-io/milvus/pkg/v2/proto/internalpb"
"github.com/milvus-io/milvus/pkg/v2/util/paramtable"
)
func TestL0Reader_NewL0Reader(t *testing.T) {
ctx := context.Background()
t.Run("normal", func(t *testing.T) {
cm := mocks.NewChunkManager(t)
cm.EXPECT().WalkWithPrefix(mock.Anything, mock.Anything, mock.Anything, mock.Anything).Return(nil)
r, err := NewL0Reader(ctx, cm, nil, &internalpb.ImportFile{Paths: []string{"mock-prefix"}}, 100, 0, math.MaxUint64)
assert.NoError(t, err)
assert.NotNil(t, r)
})
t.Run("invalid path", func(t *testing.T) {
r, err := NewL0Reader(ctx, nil, nil, &internalpb.ImportFile{Paths: []string{"mock-prefix", "mock-prefix2"}}, 100, 0, math.MaxUint64)
assert.Error(t, err)
assert.Nil(t, r)
})
t.Run("list failed", func(t *testing.T) {
cm := mocks.NewChunkManager(t)
cm.EXPECT().WalkWithPrefix(mock.Anything, mock.Anything, mock.Anything, mock.Anything).Return(errors.New("mock error"))
r, err := NewL0Reader(ctx, cm, nil, &internalpb.ImportFile{Paths: []string{"mock-prefix"}}, 100, 0, math.MaxUint64)
assert.Error(t, err)
assert.Nil(t, r)
})
}
func TestL0Reader_Read(t *testing.T) {
ctx := context.Background()
const (
delCnt = 100
)
deleteData := storage.NewDeleteData(nil, nil)
for i := 0; i < delCnt; i++ {
deleteData.Append(storage.NewVarCharPrimaryKey(fmt.Sprintf("No.%d", i)), uint64(i+1))
}
deleteCodec := storage.NewDeleteCodec()
blob, err := deleteCodec.Serialize(1, 2, 3, deleteData)
assert.NoError(t, err)
cm := mocks.NewChunkManager(t)
cm.EXPECT().WalkWithPrefix(mock.Anything, mock.Anything, mock.Anything, mock.Anything).RunAndReturn(
func(ctx context.Context, s string, b bool, walkFunc storage.ChunkObjectWalkFunc) error {
for _, file := range []string{"a/b/c/"} {
walkFunc(&storage.ChunkObjectInfo{FilePath: file})
}
return nil
})
cm.EXPECT().Read(mock.Anything, mock.Anything).Return(blob.Value, nil)
r, err := NewL0Reader(ctx, cm, nil, &internalpb.ImportFile{Paths: []string{"mock-prefix"}}, 100, 0, math.MaxUint64)
assert.NoError(t, err)
res, err := r.Read()
assert.NoError(t, err)
assert.Equal(t, int64(delCnt), res.RowCount)
assert.Equal(t, deleteData.Size(), res.Size())
_, err = r.Read()
assert.Error(t, err)
assert.ErrorIs(t, err, io.EOF)
}
func TestMain(m *testing.M) {
paramtable.Init()
os.Exit(m.Run())
}
func TestL0Reader_NoFilters(t *testing.T) {
ctx := context.Background()
const (
delCnt = 100
)
deleteData := storage.NewDeleteData(nil, nil)
for i := 0; i < delCnt; i++ {
deleteData.Append(storage.NewVarCharPrimaryKey(fmt.Sprintf("No.%d", i)), uint64(i+1))
}
deleteCodec := storage.NewDeleteCodec()
blob, err := deleteCodec.Serialize(1, 2, 3, deleteData)
assert.NoError(t, err)
// Mock storage.ListAllChunkWithPrefix
mockListAllChunk := mockey.Mock(storage.ListAllChunkWithPrefix).Return([]string{"a/b/c/"}, nil, nil).Build()
defer mockListAllChunk.UnPatch()
// Mock ChunkManager.Read using interface
mockChunkManager := storage.NewLocalChunkManager()
mockRead := mockey.Mock((*storage.LocalChunkManager).Read).Return(blob.Value, nil).Build()
defer mockRead.UnPatch()
// Create reader without any filters
r, err := NewL0Reader(ctx, mockChunkManager, nil, &internalpb.ImportFile{Paths: []string{"mock-prefix"}}, 100, 0, math.MaxUint64)
assert.NoError(t, err)
res, err := r.Read()
assert.NoError(t, err)
// Should include all records
assert.Equal(t, int64(delCnt), res.RowCount)
}
func TestFilterDeleteWithTimeRange(t *testing.T) {
t.Run("normal range", func(t *testing.T) {
filter := FilterDeleteWithTimeRange(10, 20)
// Test within range
dl := &storage.DeleteLog{Ts: 15}
assert.True(t, filter(dl))
// Test at boundaries
dl.Ts = 10
assert.True(t, filter(dl))
dl.Ts = 20
assert.True(t, filter(dl))
// Test outside range
dl.Ts = 9
assert.False(t, filter(dl))
dl.Ts = 21
assert.False(t, filter(dl))
})
t.Run("edge cases", func(t *testing.T) {
// Test with max uint64
filter := FilterDeleteWithTimeRange(0, math.MaxUint64)
dl := &storage.DeleteLog{Ts: 1000}
assert.True(t, filter(dl))
// Test with same start and end
filter = FilterDeleteWithTimeRange(5, 5)
dl.Ts = 5
assert.True(t, filter(dl))
dl.Ts = 4
assert.False(t, filter(dl))
dl.Ts = 6
assert.False(t, filter(dl))
})
}