feat(remove): refactor Remove with mark remove mode

- add and refactor new interfaces
- implement if mark remove for HGraph, IVF

Signed-off-by: LHT129 <tianlan.lht@antgroup.com>

Author: LHT129

include/vsag/index.h

@@ -56,6 +56,23 @@ using OffsetType = uint64_t;
 using SizeType = uint64_t;
 using WriteFuncType = std::function<void(OffsetType, SizeType, const void*)>;
 
+enum class AddMode {
+    /** try to reuse the memory of the deleted vector, no recovery check */
+    DEFAULT = 0,
+
+    /** always allocate new memory for the vector, but also check whether recovery from the same id */
+    KEEP_TOMBSTONE = 1,
+};
+
+enum class RemoveMode {
+    /** mark the vector as deleted, but not remove it from index, no shrink and repair,
+        * this mode is fast */
+    MARK_REMOVE = 0,
+
+    /** remove the vector from index and repair the index, but not shrink the index, 
+        * this mode is heavy */
+    REMOVE_AND_REPAIR = 1,
+};
 class Index {
 public:
     // [basic methods]
@@ -127,19 +144,40 @@ class Index {
       * @return IDs that failed to insert into the index
       */
     virtual tl::expected<std::vector<int64_t>, Error>
-    Add(const DatasetPtr& base) {
+    Add(const DatasetPtr& base, AddMode mode = AddMode::DEFAULT) {
         throw std::runtime_error("Index not support adding vectors");
     }
 
     /**
-      * @brief Remove the vector corresponding to the given ID from the index
-      *
-      * @param id of the vector that need to be removed from the index
-      * @return result indicates whether the remove operation is successful.
-      */
-    virtual tl::expected<bool, Error>
-    Remove(int64_t id) {
-        throw std::runtime_error("Index not support delete vector");
+     * @brief Remove the vectors corresponding to the given IDs from the index
+     *
+     * @param ids of the vectors that need to be removed from the index
+     * @return number of vectors that successfully removed from the index
+     */
+    virtual tl::expected<uint32_t, Error>
+    Remove(const std::vector<int64_t>& ids, RemoveMode mode = RemoveMode::MARK_REMOVE) {
+        throw std::runtime_error("Index not support Remove");
+    }
+
+    /**
+     * @brief Remove the vector corresponding to the given ID from the index
+     *
+     * @param id of the vector that need to be removed from the index
+     * @return number of vectors that successfully removed from the index
+     */
+    virtual tl::expected<uint32_t, Error>
+    Remove(int64_t id, RemoveMode mode = RemoveMode::MARK_REMOVE) {
+        return this->Remove(std::vector<int64_t>({id}), mode);
+    }
+
+    /**
+     * @brief 
+     *  1. Shrink the index to release memory occupied by soft deleted vectors.
+     *  2. Repair the index which is corrupted by soft delete.
+     */
+    virtual void
+    ShrinkAndRepair() {
+        throw std::runtime_error("Index not support ShrinkAndRepair");
     }
 
     /**

include/vsag/vsag_ext.h

@@ -133,7 +133,7 @@ class IndexHandler {
     tl::expected<std::vector<int64_t>, Error>
     Add(DatasetHandler* base);
 
-    tl::expected<bool, Error>
+    tl::expected<uint32_t, Error>
     Remove(int64_t id);
 
     tl::expected<DatasetHandler*, Error>

mockimpl/vsag/simpleflat.cpp

@@ -69,7 +69,7 @@ SimpleFlat::Build(const DatasetPtr& base) {
 }
 
 tl::expected<std::vector<int64_t>, Error>
-SimpleFlat::Add(const DatasetPtr& base) {
+SimpleFlat::Add(const DatasetPtr& base, AddMode mode) {
     std::vector<int64_t> failed_ids;
     if (not this->data_.empty()) {
         if (this->dim_ != base->GetDim()) {
@@ -429,22 +429,25 @@ SimpleFlat::GetStats() const {
     return j.dump();
 }
 
-tl::expected<bool, Error>
-SimpleFlat::Remove(int64_t id) {
-    auto iter = std::find(ids_.begin(), ids_.end(), id);
-    if (iter != ids_.end()) {
-        int index = iter - ids_.begin();
-        num_elements_--;
-        ids_[index] = ids_[num_elements_];
-        std::memcpy(
-            data_.data() + index * dim_, data_.data() + num_elements_ * dim_, dim_ * sizeof(float));
-        ids_.resize(num_elements_);
-        data_.resize(num_elements_ * dim_);
-    } else {
-        return false;
+tl::expected<uint32_t, Error>
+SimpleFlat::Remove(const std::vector<int64_t>& ids, RemoveMode mode) {
+    uint32_t removed = 0;
+    for (auto id : ids) {
+        auto iter = std::find(ids_.begin(), ids_.end(), id);
+        if (iter != ids_.end()) {
+            int index = iter - ids_.begin();
+            num_elements_--;
+            ids_[index] = ids_[num_elements_];
+            std::memcpy(data_.data() + index * dim_,
+                        data_.data() + num_elements_ * dim_,
+                        dim_ * sizeof(float));
+            ids_.resize(num_elements_);
+            data_.resize(num_elements_ * dim_);
+            removed++;
+        }
     }
 
-    return true;
+    return removed;
 }
 
 }  // namespace vsag

mockimpl/vsag/simpleflat.h

@@ -29,10 +29,10 @@ class SimpleFlat : public Index {
     Build(const DatasetPtr& base) override;
 
     virtual tl::expected<std::vector<int64_t>, Error>
-    Add(const DatasetPtr& base) override;
+    Add(const DatasetPtr& base, AddMode mode) override;
 
-    tl::expected<bool, Error>
-    Remove(int64_t id) override;
+    tl::expected<uint32_t, Error>
+    Remove(const std::vector<int64_t>& ids, RemoveMode mode) override;
 
     tl::expected<DatasetPtr, Error>
     KnnSearch(const DatasetPtr& query,

src/algorithm/brute_force.cpp

@@ -64,7 +64,7 @@ BruteForce::Train(const DatasetPtr& data) {
 }
 
 std::vector<int64_t>
-BruteForce::Add(const DatasetPtr& data) {
+BruteForce::Add(const DatasetPtr& data, AddMode mode) {
     std::vector<int64_t> failed_ids;
     auto base_dim = data->GetDim();
     CHECK_ARGUMENT(base_dim == dim_,
@@ -146,34 +146,44 @@ BruteForce::Add(const DatasetPtr& data) {
     return failed_ids;
 }
 
-bool
-BruteForce::Remove(int64_t label) {
+uint32_t
+BruteForce::Remove(const std::vector<int64_t>& ids, RemoveMode mode) {
     CHECK_ARGUMENT(not use_attribute_filter_,
                    "remove is not supported when use_attribute_filter is true");
 
+    uint32_t delete_count = 0;
+    if (mode == RemoveMode::MARK_REMOVE) {
+        std::scoped_lock label_lock(this->label_lookup_mutex_);
+        delete_count = this->label_table_->MarkRemove(ids);
+        delete_count_ += delete_count;
+        return delete_count;
+    }
+
     std::scoped_lock lock(this->add_mutex_, this->label_lookup_mutex_);
-    const auto last_inner_id = static_cast<InnerIdType>(this->total_count_ - 1);
-    const auto inner_id = this->label_table_->GetIdByLabel(label);
+    for (auto label : ids) {
+        const auto last_inner_id = static_cast<InnerIdType>(this->total_count_ - 1);
+        const auto inner_id = this->label_table_->GetIdByLabel(label);
 
-    CHECK_ARGUMENT(inner_id <= last_inner_id, "the element to be remove is invalid");
+        CHECK_ARGUMENT(inner_id <= last_inner_id, "the element to be remove is invalid");
 
-    const auto last_label = this->label_table_->GetLabelById(last_inner_id);
-    this->label_table_->Remove(label);
-    --this->label_table_->total_count_;
+        const auto last_label = this->label_table_->GetLabelById(last_inner_id);
+        this->label_table_->MarkRemove(label);
+        --this->label_table_->total_count_;
 
-    if (inner_id < last_inner_id) {
-        Vector<float> data(dim_, allocator_);
-        GetVectorByInnerId(last_inner_id, data.data());
+        if (inner_id < last_inner_id) {
+            Vector<float> data(dim_, allocator_);
+            GetVectorByInnerId(last_inner_id, data.data());
 
-        this->label_table_->Remove(last_label);
-        --this->label_table_->total_count_;
+            this->label_table_->MarkRemove(last_label);
+            --this->label_table_->total_count_;
 
-        this->inner_codes_->InsertVector(data.data(), inner_id);
-        this->label_table_->Insert(inner_id, last_label);
-    }
+            this->inner_codes_->InsertVector(data.data(), inner_id);
+            this->label_table_->Insert(inner_id, last_label);
+        }
 
-    this->total_count_--;
-    return true;
+        this->total_count_--;
+    }
+    return 1;
 }
 
 DatasetPtr
@@ -199,10 +209,18 @@ BruteForce::SearchWithRequest(const SearchRequest& request) const {
     DistHeapPtr heap = nullptr;
     ExecutorPtr executor = nullptr;
     Filter* attr_filter = nullptr;
-    Filter* filter = nullptr;
+
+    auto combined_filter = std::make_shared<CombinedFilter>();
+    combined_filter->AppendFilter(this->label_table_->GetDeletedIdsFilter());
     if (request.filter_ != nullptr) {
-        filter = request.filter_.get();
+        combined_filter->AppendFilter(
+            std::make_shared<InnerIdWrapperFilter>(request.filter_, *this->label_table_));
     }
+    FilterPtr ft = nullptr;
+    if (not combined_filter->IsEmpty()) {
+        ft = combined_filter;
+    }
+
     if (request.enable_attribute_filter_) {
         auto& schema = this->attr_filter_index_->field_type_map_;
         auto expr = AstParse(request.attribute_filter_str_, &schema);
@@ -228,7 +246,7 @@ BruteForce::SearchWithRequest(const SearchRequest& request) const {
             if (attr_filter != nullptr and not attr_filter->CheckValid(i)) {
                 continue;
             }
-            if (filter == nullptr or filter->CheckValid(this->label_table_->GetLabelById(i))) {
+            if (ft == nullptr or ft->CheckValid(i)) {
                 inner_codes_->Query(&dist, computer, &i, 1);
                 ++dist_cmp_local;
                 cur_heap->Push(dist, i);

src/algorithm/brute_force.h

@@ -44,7 +44,7 @@ class BruteForce : public InnerIndexInterface {
     ~BruteForce() override = default;
 
     std::vector<int64_t>
-    Add(const DatasetPtr& data) override;
+    Add(const DatasetPtr& base, AddMode mode = AddMode::DEFAULT) override;
 
     std::vector<int64_t>
     Build(const DatasetPtr& data) override;
@@ -78,7 +78,12 @@ class BruteForce : public InnerIndexInterface {
 
     [[nodiscard]] int64_t
     GetNumElements() const override {
-        return this->total_count_;
+        return this->total_count_ - this->delete_count_;
+    }
+
+    [[nodiscard]] int64_t
+    GetNumberRemoved() const override {
+        return this->delete_count_;
     }
 
     void
@@ -100,8 +105,8 @@ class BruteForce : public InnerIndexInterface {
                 const FilterPtr& filter,
                 int64_t limited_size = -1) const override;
 
-    bool
-    Remove(int64_t label) override;
+    uint32_t
+    Remove(const std::vector<int64_t>& ids, RemoveMode mode = RemoveMode::MARK_REMOVE) override;
 
     [[nodiscard]] DatasetPtr
     SearchWithRequest(const SearchRequest& request) const override;
@@ -138,6 +143,8 @@ class BruteForce : public InnerIndexInterface {
 
     uint64_t total_count_{0};
 
+    uint64_t delete_count_{0};
+
     uint64_t resize_increase_count_bit_{DEFAULT_RESIZE_BIT};
 
     mutable std::shared_mutex global_mutex_;