// 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. // pkoracle package contains pk - segment mapping logic. package pkoracle import ( "fmt" "github.com/milvus-io/milvus/internal/storage" "github.com/milvus-io/milvus/pkg/util/typeutil" ) // PkOracle interface for pk oracle. type PkOracle interface { // GetCandidates returns segment candidates of which pk might belongs to. Get(pk storage.PrimaryKey, filters ...CandidateFilter) ([]int64, error) BatchGet(pks []storage.PrimaryKey, filters ...CandidateFilter) map[int64][]bool // RegisterCandidate adds candidate into pkOracle. Register(candidate Candidate, workerID int64) error // RemoveCandidate removes candidate Remove(filters ...CandidateFilter) error // CheckCandidate checks whether candidate with provided key exists. Exists(candidate Candidate, workerID int64) bool } var _ PkOracle = (*pkOracle)(nil) // pkOracle implementation. type pkOracle struct { candidates *typeutil.ConcurrentMap[string, candidateWithWorker] } // Get implements PkOracle. func (pko *pkOracle) Get(pk storage.PrimaryKey, filters ...CandidateFilter) ([]int64, error) { var result []int64 lc := storage.NewLocationsCache(pk) pko.candidates.Range(func(key string, candidate candidateWithWorker) bool { for _, filter := range filters { if !filter(candidate) { return true } } if candidate.MayPkExist(lc) { result = append(result, candidate.ID()) } return true }) return result, nil } func (pko *pkOracle) BatchGet(pks []storage.PrimaryKey, filters ...CandidateFilter) map[int64][]bool { result := make(map[int64][]bool) lc := storage.NewBatchLocationsCache(pks) pko.candidates.Range(func(key string, candidate candidateWithWorker) bool { for _, filter := range filters { if !filter(candidate) { return true } } hits := candidate.BatchPkExist(lc) result[candidate.ID()] = hits return true }) return result } func (pko *pkOracle) candidateKey(candidate Candidate, workerID int64) string { return fmt.Sprintf("%s-%d-%d", candidate.Type().String(), workerID, candidate.ID()) } // Register register candidate func (pko *pkOracle) Register(candidate Candidate, workerID int64) error { pko.candidates.Insert(pko.candidateKey(candidate, workerID), candidateWithWorker{ Candidate: candidate, workerID: workerID, }) return nil } // Remove removes candidate from pko. func (pko *pkOracle) Remove(filters ...CandidateFilter) error { pko.candidates.Range(func(key string, candidate candidateWithWorker) bool { for _, filter := range filters { if !filter(candidate) { return true } } pko.candidates.GetAndRemove(pko.candidateKey(candidate, candidate.workerID)) return true }) return nil } func (pko *pkOracle) Exists(candidate Candidate, workerID int64) bool { _, ok := pko.candidates.Get(pko.candidateKey(candidate, workerID)) return ok } // NewPkOracle returns pkOracle as PkOracle interface. func NewPkOracle() PkOracle { return &pkOracle{ candidates: typeutil.NewConcurrentMap[string, candidateWithWorker](), } }