nucliadb 2.46.1.post382__py3-none-any.whl → 6.2.1.post2777__py3-none-any.whl

nucliadb/ingest/service/writer.py

@@ -17,44 +17,44 @@
 # You should have received a copy of the GNU Affero General Public License
 # along with this program. If not, see <http://www.gnu.org/licenses/>.
 #
-import json
 import uuid
-from io import BytesIO
-from typing import AsyncIterator, Optional
+from typing import AsyncIterator
 
+from nucliadb.common import datamanagers
+from nucliadb.common.cluster.exceptions import AlreadyExists, EntitiesGroupNotFound
+from nucliadb.common.cluster.manager import get_index_nodes
+from nucliadb.common.cluster.utils import get_shard_manager
+from nucliadb.common.datamanagers.exceptions import KnowledgeBoxNotFound
+from nucliadb.common.external_index_providers.exceptions import ExternalIndexCreationError
+from nucliadb.common.external_index_providers.manager import get_external_index_manager
+from nucliadb.common.maindb.utils import setup_driver
+from nucliadb.ingest import SERVICE_NAME, logger
+from nucliadb.ingest.orm.broker_message import generate_broker_message
+from nucliadb.ingest.orm.entities import EntitiesManager
+from nucliadb.ingest.orm.exceptions import KnowledgeBoxConflict, VectorSetConflict
+from nucliadb.ingest.orm.knowledgebox import KnowledgeBox as KnowledgeBoxORM
+from nucliadb.ingest.orm.processor import Processor, sequence_manager
+from nucliadb.ingest.orm.resource import Resource as ResourceORM
+from nucliadb.ingest.settings import settings
+from nucliadb_protos import nodewriter_pb2, writer_pb2, writer_pb2_grpc
 from nucliadb_protos.knowledgebox_pb2 import (
     DeleteKnowledgeBoxResponse,
-    GCKnowledgeBoxResponse,
     KnowledgeBoxID,
-    KnowledgeBoxNew,
     KnowledgeBoxResponseStatus,
     KnowledgeBoxUpdate,
-    Labels,
-    NewKnowledgeBoxResponse,
     SemanticModelMetadata,
     UpdateKnowledgeBoxResponse,
+    VectorSetConfig,
 )
-from nucliadb_protos.resources_pb2 import CloudFile
 from nucliadb_protos.writer_pb2 import (
-    BinaryData,
     BrokerMessage,
     DelEntitiesRequest,
-    DelLabelsRequest,
     DelVectorSetRequest,
-    ExtractedVectorsWrapper,
-    FileRequest,
-    FileUploaded,
+    DelVectorSetResponse,
     GetEntitiesGroupRequest,
     GetEntitiesGroupResponse,
     GetEntitiesRequest,
     GetEntitiesResponse,
-    GetLabelSetRequest,
-    GetLabelSetResponse,
-    GetLabelsRequest,
-    GetLabelsResponse,
-    GetSynonymsResponse,
-    GetVectorSetsRequest,
-    GetVectorSetsResponse,
     IndexResource,
     IndexStatus,
     ListEntitiesGroupsRequest,
@@ -63,50 +63,22 @@ from nucliadb_protos.writer_pb2 import (
     ListMembersResponse,
     NewEntitiesGroupRequest,
     NewEntitiesGroupResponse,
+    NewVectorSetRequest,
+    NewVectorSetResponse,
     OpStatusWriter,
-    ResourceFieldExistsResponse,
-    ResourceFieldId,
-    ResourceIdRequest,
-    ResourceIdResponse,
     SetEntitiesRequest,
-    SetLabelsRequest,
-    SetSynonymsRequest,
-    SetVectorSetRequest,
-    SetVectorsRequest,
-    SetVectorsResponse,
     UpdateEntitiesGroupRequest,
     UpdateEntitiesGroupResponse,
-    UploadBinaryData,
     WriterStatusRequest,
     WriterStatusResponse,
 )
-
-from nucliadb import learning_proxy
-from nucliadb.common import datamanagers
-from nucliadb.common.cluster.exceptions import AlreadyExists, EntitiesGroupNotFound
-from nucliadb.common.cluster.manager import get_index_nodes
-from nucliadb.common.cluster.utils import get_shard_manager
-from nucliadb.common.datamanagers.exceptions import KnowledgeBoxNotFound
-from nucliadb.common.maindb.driver import Transaction
-from nucliadb.common.maindb.utils import setup_driver
-from nucliadb.ingest import SERVICE_NAME, logger
-from nucliadb.ingest.orm.entities import EntitiesManager
-from nucliadb.ingest.orm.exceptions import KnowledgeBoxConflict
-from nucliadb.ingest.orm.knowledgebox import KnowledgeBox as KnowledgeBoxORM
-from nucliadb.ingest.orm.processor import Processor, sequence_manager
-from nucliadb.ingest.orm.resource import Resource as ResourceORM
-from nucliadb.ingest.settings import settings
-from nucliadb_protos import utils_pb2, writer_pb2, writer_pb2_grpc
 from nucliadb_telemetry import errors
-from nucliadb_utils import const
-from nucliadb_utils.settings import is_onprem_nucliadb, running_settings
-from nucliadb_utils.storages.storage import Storage, StorageField
+from nucliadb_utils.settings import is_onprem_nucliadb
 from nucliadb_utils.utilities import (
     get_partitioning,
     get_pubsub,
     get_storage,
     get_transaction_utility,
-    has_feature,
 )
 
 
@@ -117,54 +89,64 @@ class WriterServicer(writer_pb2_grpc.WriterServicer):
     async def initialize(self):
         self.storage = await get_storage(service_name=SERVICE_NAME)
         self.driver = await setup_driver()
-        self.proc = Processor(
-            driver=self.driver, storage=self.storage, pubsub=await get_pubsub()
-        )
+        self.proc = Processor(driver=self.driver, storage=self.storage, pubsub=await get_pubsub())
         self.shards_manager = get_shard_manager()
 
-    async def finalize(self):
-        ...
-
-    async def SetVectors(  # type: ignore
-        self, request: SetVectorsRequest, context=None
-    ) -> SetVectorsResponse:
-        response = SetVectorsResponse()
-        response.found = True
-
-        async with self.driver.transaction() as txn:
-            kbobj = KnowledgeBoxORM(txn, self.storage, request.kbid)
-            resobj = ResourceORM(txn, self.storage, kbobj, request.rid)
+    async def finalize(self): ...
 
-            field = await resobj.get_field(
-                request.field.field, request.field.field_type, load=True
+    async def NewKnowledgeBoxV2(
+        self, request: writer_pb2.NewKnowledgeBoxV2Request, context=None
+    ) -> writer_pb2.NewKnowledgeBoxV2Response:
+        """v2 of KB creation endpoint. Payload has been refactored and cleaned
+        up to include only necessary fields. It has also been extended to
+        support KB creation with multiple vectorsets
+        """
+        if is_onprem_nucliadb():
+            logger.error(
+                "Sorry, this endpoint is only available for hosted. Onprem must use the REST API"
             )
-            if field.value is None:
-                response.found = False
-                return response
+            return writer_pb2.NewKnowledgeBoxV2Response(
+                status=KnowledgeBoxResponseStatus.ERROR,
+                error_message="This endpoint is only available for hosted. Onprem must use the REST API",
+            )
+        # Hosted KBs are created through backend endpoints. We assume learning
+        # configuration has been already created for it and we are given the
+        # model metadata in the request
 
-            evw = ExtractedVectorsWrapper()
-            evw.field.CopyFrom(request.field)
-            evw.vectors.CopyFrom(request.vectors)
-            logger.debug(f"Setting {len(request.vectors.vectors.vectors)} vectors")
+        try:
+            kbid, _ = await KnowledgeBoxORM.create(
+                self.driver,
+                kbid=request.kbid,
+                slug=request.slug,
+                title=request.title,
+                description=request.description,
+                semantic_models={
+                    vs.vectorset_id: SemanticModelMetadata(
+                        similarity_function=vs.similarity,
+                        vector_dimension=vs.vector_dimension,
+                        matryoshka_dimensions=vs.matryoshka_dimensions,
+                    )
+                    for vs in request.vectorsets
+                },
+                external_index_provider=request.external_index_provider,
+                hidden_resources_enabled=request.hidden_resources_enabled,
+                hidden_resources_hide_on_creation=request.hidden_resources_hide_on_creation,
+            )
 
-            try:
-                await field.set_vectors(evw)
-                await txn.commit()
-            except Exception as e:
-                errors.capture_exception(e)
-                logger.error("Error in ingest gRPC servicer", exc_info=True)
+        except KnowledgeBoxConflict:
+            logger.info("KB already exists", extra={"slug": request.slug})
+            return writer_pb2.NewKnowledgeBoxV2Response(status=KnowledgeBoxResponseStatus.CONFLICT)
 
-            return response
+        except ExternalIndexCreationError as exc:
+            logger.exception(
+                "Error creating external index",
+                extra={"slug": request.slug, "error": str(exc)},
+            )
+            return writer_pb2.NewKnowledgeBoxV2Response(
+                status=KnowledgeBoxResponseStatus.EXTERNAL_INDEX_PROVIDER_ERROR,
+                error_message=exc.message,
+            )
 
-    async def NewKnowledgeBox(  # type: ignore
-        self, request: KnowledgeBoxNew, context=None
-    ) -> NewKnowledgeBoxResponse:
-        try:
-            kbid = await self.create_kb(request)
-            logger.info("KB created successfully", extra={"kbid": kbid})
-        except KnowledgeBoxConflict:
-            logger.warning("KB already exists", extra={"slug": request.slug})
-            return NewKnowledgeBoxResponse(status=KnowledgeBoxResponseStatus.CONFLICT)
         except Exception as exc:
             errors.capture_exception(exc)
             logger.exception(
@@ -172,101 +154,50 @@ class WriterServicer(writer_pb2_grpc.WriterServicer):
                 exc_info=True,
                 extra={"slug": request.slug},
             )
-            return NewKnowledgeBoxResponse(status=KnowledgeBoxResponseStatus.ERROR)
-        return NewKnowledgeBoxResponse(status=KnowledgeBoxResponseStatus.OK, uuid=kbid)
-
-    async def create_kb(self, request: KnowledgeBoxNew) -> str:
-        if is_onprem_nucliadb():
-            return await self._create_kb_onprem(request)
-        else:
-            return await self._create_kb_hosted(request)
+            return writer_pb2.NewKnowledgeBoxV2Response(status=KnowledgeBoxResponseStatus.ERROR)
 
-    async def _create_kb_onprem(self, request: KnowledgeBoxNew) -> str:
-        """
-        First, try to get the learning configuration for the new knowledge box.
-        From there we need to extract the semantic model metadata and pass it to the create_kb method.
-        If the kb creation fails, rollback the learning configuration for the kbid that was just created.
-        """
-        kbid = request.forceuuid or str(uuid.uuid4())
-        release_channel = get_release_channel(request)
-        request.config.release_channel = release_channel
-        lconfig = await learning_proxy.get_configuration(kbid)
-        lconfig_created = False
-        if lconfig is None:
-            if request.learning_config:
-                # We parse the desired configuration from the request and set it
-                config = json.loads(request.learning_config)
-            else:
-                # We set an empty configuration so that learning chooses the default values.
-                config = {}
-                logger.warning(
-                    "No learning configuration provided. Default will be used.",
-                    extra={"kbid": kbid},
-                )
-            lconfig = await learning_proxy.set_configuration(kbid, config=config)
-            lconfig_created = True
         else:
-            logger.info("Learning configuration already exists", extra={"kbid": kbid})
-        try:
-            await self.proc.create_kb(
-                request.slug,
-                request.config,
-                parse_model_metadata_from_learning_config(lconfig),
-                forceuuid=kbid,
-                release_channel=release_channel,
-            )
-            return kbid
-        except Exception:
-            # Rollback learning config for the kbid that was just created
-            try:
-                if lconfig_created:
-                    await learning_proxy.delete_configuration(kbid)
-            except Exception:
-                logger.warning(
-                    "Could not rollback learning configuration",
-                    exc_info=True,
-                    extra={"kbid": kbid},
-                )
-            raise
-
-    async def _create_kb_hosted(self, request: KnowledgeBoxNew) -> str:
-        """
-        For the hosted case, we assume that the learning configuration
-        is already set and we are given the model metadata in the request.
-        """
-        kbid = request.forceuuid or str(uuid.uuid4())
-        release_channel = get_release_channel(request)
-        request.config.release_channel = release_channel
-        await self.proc.create_kb(
-            request.slug,
-            request.config,
-            parse_model_metadata_from_request(request),
-            forceuuid=kbid,
-            release_channel=release_channel,
-        )
-        return kbid
+            logger.info("KB created successfully", extra={"kbid": kbid})
+            return writer_pb2.NewKnowledgeBoxV2Response(status=KnowledgeBoxResponseStatus.OK)
 
     async def UpdateKnowledgeBox(  # type: ignore
         self, request: KnowledgeBoxUpdate, context=None
     ) -> UpdateKnowledgeBoxResponse:
-        try:
-            kbid = await self.proc.update_kb(request.uuid, request.slug, request.config)
-        except KnowledgeBoxNotFound:
+        if is_onprem_nucliadb():
+            logger.error(
+                "Sorry, this endpoint is only available for hosted. Onprem must use the REST API"
+            )
             return UpdateKnowledgeBoxResponse(
-                status=KnowledgeBoxResponseStatus.NOTFOUND
+                status=KnowledgeBoxResponseStatus.ERROR,
             )
+
+        try:
+            async with self.driver.transaction() as txn:
+                kbid = await KnowledgeBoxORM.update(
+                    txn, uuid=request.uuid, slug=request.slug, config=request.config
+                )
+                await txn.commit()
+        except KnowledgeBoxNotFound:
+            return UpdateKnowledgeBoxResponse(status=KnowledgeBoxResponseStatus.NOTFOUND)
         except Exception:
-            logger.exception("Could not create KB", exc_info=True)
+            logger.exception("Could not update KB", exc_info=True)
             return UpdateKnowledgeBoxResponse(status=KnowledgeBoxResponseStatus.ERROR)
-        return UpdateKnowledgeBoxResponse(
-            status=KnowledgeBoxResponseStatus.OK, uuid=kbid
-        )
+        return UpdateKnowledgeBoxResponse(status=KnowledgeBoxResponseStatus.OK, uuid=kbid)
 
     async def DeleteKnowledgeBox(  # type: ignore
         self, request: KnowledgeBoxID, context=None
     ) -> DeleteKnowledgeBoxResponse:
+        if is_onprem_nucliadb():
+            logger.error(
+                "Sorry, this endpoint is only available for hosted. Onprem must use the REST API"
+            )
+            return DeleteKnowledgeBoxResponse(status=KnowledgeBoxResponseStatus.ERROR)
+
         try:
-            await self.delete_kb(request)
+            kbid = request.uuid
+            # learning configuration is automatically removed in nuclia backend for
+            # hosted users, we don't need to do it
+            await KnowledgeBoxORM.delete(self.driver, kbid=kbid)
         except KnowledgeBoxNotFound:
             logger.warning(f"KB not found: kbid={request.uuid}, slug={request.slug}")
         except Exception:
@@ -274,28 +205,6 @@ class WriterServicer(writer_pb2_grpc.WriterServicer):
             return DeleteKnowledgeBoxResponse(status=KnowledgeBoxResponseStatus.ERROR)
         return DeleteKnowledgeBoxResponse(status=KnowledgeBoxResponseStatus.OK)
 
-    async def delete_kb(self, request: KnowledgeBoxID) -> None:
-        kbid = request.uuid
-        await self.proc.delete_kb(kbid, request.slug)
-        # learning configuration is automatically removed in nuclia backend for
-        # hosted users, we only need to remove it for onprem
-        if is_onprem_nucliadb():
-            try:
-                await learning_proxy.delete_configuration(kbid)
-                logger.info("Learning configuration deleted", extra={"kbid": kbid})
-            except Exception:
-                logger.exception(
-                    "Unexpected error deleting learning configuration",
-                    exc_info=True,
-                    extra={"kbid": kbid},
-                )
-
-    async def GCKnowledgeBox(  # type: ignore
-        self, request: KnowledgeBoxID, context=None
-    ) -> GCKnowledgeBoxResponse:
-        response = GCKnowledgeBoxResponse()
-        return response
-
     async def ProcessMessage(  # type: ignore
         self, request_stream: AsyncIterator[BrokerMessage], context=None
     ):
@@ -313,128 +222,21 @@ class WriterServicer(writer_pb2_grpc.WriterServicer):
             logger.info(f"Processed {message.uuid}")
         return response
 
-    async def SetLabels(self, request: SetLabelsRequest, context=None) -> OpStatusWriter:  # type: ignore
-        async with self.driver.transaction() as txn:
-            kbobj = await self.proc.get_kb_obj(txn, request.kb)
-            response = OpStatusWriter()
-            if kbobj is not None:
-                try:
-                    await kbobj.set_labelset(request.id, request.labelset)
-                    await txn.commit()
-                    response.status = OpStatusWriter.Status.OK
-                except Exception as e:
-                    errors.capture_exception(e)
-                    logger.error("Error in ingest gRPC servicer", exc_info=True)
-                    response.status = OpStatusWriter.Status.ERROR
-            else:
-                response.status = OpStatusWriter.Status.NOTFOUND
-            return response
-
-    async def DelLabels(self, request: DelLabelsRequest, context=None) -> OpStatusWriter:  # type: ignore
-        async with self.driver.transaction() as txn:
-            kbobj = await self.proc.get_kb_obj(txn, request.kb)
-            response = OpStatusWriter()
-            if kbobj is not None:
-                try:
-                    await kbobj.del_labelset(request.id)
-                    await txn.commit()
-                    response.status = OpStatusWriter.Status.OK
-                except Exception as e:
-                    errors.capture_exception(e)
-                    logger.error("Error in ingest gRPC servicer", exc_info=True)
-                    response.status = OpStatusWriter.Status.ERROR
-            else:
-                response.status = OpStatusWriter.Status.NOTFOUND
-
-            return response
-
-    async def GetLabels(self, request: GetLabelsRequest, context=None) -> GetLabelsResponse:  # type: ignore
-        async with self.driver.transaction() as txn:
-            kbobj = await self.proc.get_kb_obj(txn, request.kb)
-            labels: Optional[Labels] = None
-            if kbobj is not None:
-                labels = await kbobj.get_labels()
-        response = GetLabelsResponse()
-        if kbobj is None:
-            response.status = GetLabelsResponse.Status.NOTFOUND
-        else:
-            response.kb.uuid = kbobj.kbid
-            if labels is not None:
-                response.labels.CopyFrom(labels)
-
-        return response
-
-    async def GetLabelSet(  # type: ignore
-        self, request: GetLabelSetRequest, context=None
-    ) -> GetLabelSetResponse:
-        async with self.driver.transaction() as txn:
-            kbobj = await self.proc.get_kb_obj(txn, request.kb)
-            response = GetLabelSetResponse()
-            if kbobj is not None:
-                await kbobj.get_labelset(request.labelset, response)
-                response.kb.uuid = kbobj.kbid
-                response.status = GetLabelSetResponse.Status.OK
-            else:
-                response.status = GetLabelSetResponse.Status.NOTFOUND
-            return response
-
-    async def GetVectorSets(  # type: ignore
-        self, request: GetVectorSetsRequest, context=None
-    ) -> GetVectorSetsResponse:
-        async with self.driver.transaction() as txn:
-            kbobj = await self.proc.get_kb_obj(txn, request.kb)
-            response = GetVectorSetsResponse()
-            if kbobj is not None:
-                await kbobj.get_vectorsets(response)
-                response.kb.uuid = kbobj.kbid
-                response.status = GetVectorSetsResponse.Status.OK
-            else:
-                response.status = GetVectorSetsResponse.Status.NOTFOUND
-            return response
-
-    async def DelVectorSet(  # type: ignore
-        self, request: DelVectorSetRequest, context=None
-    ) -> OpStatusWriter:
-        async with self.driver.transaction() as txn:
-            kbobj = await self.proc.get_kb_obj(txn, request.kb)
-            response = OpStatusWriter()
-            if kbobj is not None:
-                await kbobj.del_vectorset(request.vectorset)
-                response.status = OpStatusWriter.Status.OK
-                await txn.commit()
-            else:
-                response.status = OpStatusWriter.Status.NOTFOUND
-            return response
-
-    async def SetVectorSet(  # type: ignore
-        self, request: SetVectorSetRequest, context=None
-    ) -> OpStatusWriter:
-        async with self.driver.transaction() as txn:
-            kbobj = await self.proc.get_kb_obj(txn, request.kb)
-            response = OpStatusWriter()
-            if kbobj is not None:
-                await kbobj.set_vectorset(request.id, request.vectorset)
-                response.status = OpStatusWriter.Status.OK
-                await txn.commit()
-            else:
-                response.status = OpStatusWriter.Status.NOTFOUND
-            return response
-
     async def NewEntitiesGroup(  # type: ignore
         self, request: NewEntitiesGroupRequest, context=None
     ) -> NewEntitiesGroupResponse:
         response = NewEntitiesGroupResponse()
-        async with self.driver.transaction() as txn:
-            kbobj = await self.proc.get_kb_obj(txn, request.kb)
+        async with self.driver.transaction(read_only=True) as ro_txn:
+            kbobj = await self.proc.get_kb_obj(ro_txn, request.kb)
             if kbobj is None:
                 response.status = NewEntitiesGroupResponse.Status.KB_NOT_FOUND
                 return response
 
+        async with self.driver.transaction() as txn:
+            kbobj.txn = txn
             entities_manager = EntitiesManager(kbobj, txn)
             try:
-                await entities_manager.create_entities_group(
-                    request.group, request.entities
-                )
+                await entities_manager.create_entities_group(request.group, request.entities)
             except AlreadyExists:
                 response.status = NewEntitiesGroupResponse.Status.ALREADY_EXISTS
                 return response
@@ -447,9 +249,8 @@ class WriterServicer(writer_pb2_grpc.WriterServicer):
         self, request: GetEntitiesRequest, context=None
     ) -> GetEntitiesResponse:
         response = GetEntitiesResponse()
-        async with self.driver.transaction() as txn:
+        async with self.driver.transaction(read_only=True) as txn:
             kbobj = await self.proc.get_kb_obj(txn, request.kb)
-
             if kbobj is None:
                 response.status = GetEntitiesResponse.Status.NOTFOUND
                 return response
@@ -470,9 +271,8 @@ class WriterServicer(writer_pb2_grpc.WriterServicer):
         self, request: ListEntitiesGroupsRequest, context=None
     ) -> ListEntitiesGroupsResponse:
         response = ListEntitiesGroupsResponse()
-        async with self.driver.transaction() as txn:
+        async with self.driver.transaction(read_only=True) as txn:
             kbobj = await self.proc.get_kb_obj(txn, request.kb)
-
             if kbobj is None:
                 response.status = ListEntitiesGroupsResponse.Status.NOTFOUND
                 return response
@@ -495,7 +295,7 @@ class WriterServicer(writer_pb2_grpc.WriterServicer):
         self, request: GetEntitiesGroupRequest, context=None
     ) -> GetEntitiesGroupResponse:
         response = GetEntitiesGroupResponse()
-        async with self.driver.transaction() as txn:
+        async with self.driver.transaction(read_only=True) as txn:
             kbobj = await self.proc.get_kb_obj(txn, request.kb)
             if kbobj is None:
                 response.status = GetEntitiesGroupResponse.Status.KB_NOT_FOUND
@@ -503,9 +303,7 @@ class WriterServicer(writer_pb2_grpc.WriterServicer):
 
             entities_manager = EntitiesManager(kbobj, txn)
             try:
-                entities_group = await entities_manager.get_entities_group(
-                    request.group
-                )
+                entities_group = await entities_manager.get_entities_group(request.group)
             except Exception as e:
                 errors.capture_exception(e)
                 logger.error("Error in ingest gRPC servicer", exc_info=True)
@@ -513,9 +311,7 @@ class WriterServicer(writer_pb2_grpc.WriterServicer):
             else:
                 response.kb.uuid = kbobj.kbid
                 if entities_group is None:
-                    response.status = (
-                        GetEntitiesGroupResponse.Status.ENTITIES_GROUP_NOT_FOUND
-                    )
+                    response.status = GetEntitiesGroupResponse.Status.ENTITIES_GROUP_NOT_FOUND
                 else:
                     response.status = GetEntitiesGroupResponse.Status.OK
                     response.group.CopyFrom(entities_group)
@@ -524,17 +320,17 @@ class WriterServicer(writer_pb2_grpc.WriterServicer):
 
     async def SetEntities(self, request: SetEntitiesRequest, context=None) -> OpStatusWriter:  # type: ignore
         response = OpStatusWriter()
-        async with self.driver.transaction() as txn:
-            kbobj = await self.proc.get_kb_obj(txn, request.kb)
+        async with self.driver.transaction(read_only=True) as ro_txn:
+            kbobj = await self.proc.get_kb_obj(ro_txn, request.kb)
             if kbobj is None:
                 response.status = OpStatusWriter.Status.NOTFOUND
                 return response
 
+        async with self.driver.transaction() as txn:
+            kbobj.txn = txn
             entities_manager = EntitiesManager(kbobj, txn)
             try:
-                await entities_manager.set_entities_group(
-                    request.group, request.entities
-                )
+                await entities_manager.set_entities_group(request.group, request.entities)
             except Exception as e:
                 errors.capture_exception(e)
                 logger.error("Error in ingest gRPC servicer", exc_info=True)
@@ -548,14 +344,15 @@ class WriterServicer(writer_pb2_grpc.WriterServicer):
         self, request: UpdateEntitiesGroupRequest, context=None
     ) -> UpdateEntitiesGroupResponse:
         response = UpdateEntitiesGroupResponse()
-        async with self.driver.transaction() as txn:
-            kbobj = await self.proc.get_kb_obj(txn, request.kb)
+        async with self.driver.transaction(read_only=True) as ro_txn:
+            kbobj = await self.proc.get_kb_obj(ro_txn, request.kb)
             if kbobj is None:
                 response.status = UpdateEntitiesGroupResponse.Status.KB_NOT_FOUND
                 return response
 
+        async with self.driver.transaction() as txn:
+            kbobj.txn = txn
             entities_manager = EntitiesManager(kbobj, txn)
-
             try:
                 await entities_manager.set_entities_group_metadata(
                     request.group,
@@ -566,9 +363,7 @@ class WriterServicer(writer_pb2_grpc.WriterServicer):
                 await entities_manager.update_entities(request.group, updates)
                 await entities_manager.delete_entities(request.group, request.delete)  # type: ignore
             except EntitiesGroupNotFound:
-                response.status = (
-                    UpdateEntitiesGroupResponse.Status.ENTITIES_GROUP_NOT_FOUND
-                )
+                response.status = UpdateEntitiesGroupResponse.Status.ENTITIES_GROUP_NOT_FOUND
                 return response
 
             await txn.commit()
@@ -577,12 +372,15 @@ class WriterServicer(writer_pb2_grpc.WriterServicer):
 
     async def DelEntities(self, request: DelEntitiesRequest, context=None) -> OpStatusWriter:  # type: ignore
         response = OpStatusWriter()
-        async with self.driver.transaction() as txn:
-            kbobj = await self.proc.get_kb_obj(txn, request.kb)
+
+        async with self.driver.transaction(read_only=True) as ro_txn:
+            kbobj = await self.proc.get_kb_obj(ro_txn, request.kb)
             if kbobj is None:
                 response.status = OpStatusWriter.Status.NOTFOUND
                 return response
 
+        async with self.driver.transaction() as txn:
+            kbobj.txn = txn
             entities_manager = EntitiesManager(kbobj, txn)
             try:
                 await entities_manager.delete_entities_group(request.group)
@@ -595,77 +393,12 @@ class WriterServicer(writer_pb2_grpc.WriterServicer):
                 response.status = OpStatusWriter.Status.OK
             return response
 
-    async def GetSynonyms(  # type: ignore
-        self, request: KnowledgeBoxID, context=None
-    ) -> GetSynonymsResponse:
-        kbid = request
-        response = GetSynonymsResponse()
-        txn: Transaction
-        async with self.driver.transaction() as txn:
-            kbobj = await self.proc.get_kb_obj(txn, kbid)
-            if kbobj is None:
-                response.status.status = OpStatusWriter.Status.NOTFOUND
-                return response
-            try:
-                await kbobj.get_synonyms(response.synonyms)
-                response.status.status = OpStatusWriter.Status.OK
-                return response
-            except Exception as e:
-                errors.capture_exception(e)
-                logger.exception("Errors getting synonyms")
-                response.status.status = OpStatusWriter.Status.ERROR
-                return response
-
-    async def SetSynonyms(  # type: ignore
-        self, request: SetSynonymsRequest, context=None
-    ) -> OpStatusWriter:
-        kbid = request.kbid
-        response = OpStatusWriter()
-        txn: Transaction
-        async with self.driver.transaction() as txn:
-            kbobj = await self.proc.get_kb_obj(txn, kbid)
-            if kbobj is None:
-                response.status = OpStatusWriter.Status.NOTFOUND
-                return response
-            try:
-                await kbobj.set_synonyms(request.synonyms)
-                await txn.commit()
-                response.status = OpStatusWriter.Status.OK
-                return response
-            except Exception as e:
-                errors.capture_exception(e)
-                logger.exception("Errors setting synonyms")
-                response.status = OpStatusWriter.Status.ERROR
-                return response
-
-    async def DelSynonyms(  # type: ignore
-        self, request: KnowledgeBoxID, context=None
-    ) -> OpStatusWriter:
-        kbid = request
-        response = OpStatusWriter()
-        txn: Transaction
-        async with self.driver.transaction() as txn:
-            kbobj = await self.proc.get_kb_obj(txn, kbid)
-            if kbobj is None:
-                response.status = OpStatusWriter.Status.NOTFOUND
-                return response
-            try:
-                await kbobj.delete_synonyms()
-                await txn.commit()
-                response.status = OpStatusWriter.Status.OK
-                return response
-            except Exception as e:
-                errors.capture_exception(e)
-                logger.exception("Errors deleting synonyms")
-                response.status = OpStatusWriter.Status.ERROR
-                return response
-
     async def Status(  # type: ignore
         self, request: WriterStatusRequest, context=None
     ) -> WriterStatusResponse:
         logger.info("Status Call")
         response = WriterStatusResponse()
-        async with self.driver.transaction() as txn:
+        async with self.driver.transaction(read_only=True) as txn:
             async for _, slug in datamanagers.kb.get_kbs(txn):
                 response.knowledgeboxes.append(slug)
 
@@ -695,60 +428,11 @@ class WriterServicer(writer_pb2_grpc.WriterServicer):
         )
         return response
 
-    async def GetResourceId(  # type: ignore
-        self, request: ResourceIdRequest, context=None
-    ) -> ResourceIdResponse:
-        response = ResourceIdResponse()
-        response.uuid = ""
-        async with self.driver.transaction() as txn:
-            kbobj = KnowledgeBoxORM(txn, self.storage, request.kbid)
-            rid = await kbobj.get_resource_uuid_by_slug(request.slug)
-            if rid:
-                response.uuid = rid
-            return response
-
-    async def ResourceFieldExists(  # type: ignore
-        self, request: ResourceFieldId, context=None
-    ) -> ResourceFieldExistsResponse:
-        response = ResourceFieldExistsResponse()
-        response.found = False
-        resobj = None
-        async with self.driver.transaction() as txn:
-            kbobj = KnowledgeBoxORM(txn, self.storage, request.kbid)
-            resobj = ResourceORM(txn, self.storage, kbobj, request.rid)
-
-            if request.field != "":
-                field = await resobj.get_field(
-                    request.field, request.field_type, load=True
-                )
-                if field.value is not None:
-                    response.found = True
-                else:
-                    response.found = False
-                return response
-
-            if request.rid != "":
-                if await resobj.exists():
-                    response.found = True
-                else:
-                    response.found = False
-                return response
-
-            if request.kbid != "":
-                config = await datamanagers.kb.get_config(txn, kbid=request.kbid)
-                if config is not None:
-                    response.found = True
-                else:
-                    response.found = False
-                return response
-
-            return response
-
     async def Index(self, request: IndexResource, context=None) -> IndexStatus:  # type: ignore
         async with self.driver.transaction() as txn:
             kbobj = KnowledgeBoxORM(txn, self.storage, request.kbid)
             resobj = ResourceORM(txn, self.storage, kbobj, request.rid)
-            bm = await resobj.generate_broker_message()
+            bm = await generate_broker_message(resobj)
             transaction = get_transaction_utility()
             partitioning = get_partitioning()
             partition = partitioning.generate_partition(request.kbid, request.rid)
@@ -763,42 +447,25 @@ class WriterServicer(writer_pb2_grpc.WriterServicer):
                 kbobj = KnowledgeBoxORM(txn, self.storage, request.kbid)
                 resobj = ResourceORM(txn, self.storage, kbobj, request.rid)
                 resobj.disable_vectors = not request.reindex_vectors
-
-                brain = await resobj.generate_index_message()
-                shard_id = await datamanagers.resources.get_resource_shard_id(
-                    txn, kbid=request.kbid, rid=request.rid
-                )
-                shard: Optional[writer_pb2.ShardObject] = None
-                if shard_id is not None:
-                    shard = await kbobj.get_resource_shard(shard_id)
-
-                if shard is None:
-                    shard = await self.shards_manager.get_current_active_shard(
-                        txn, request.kbid
-                    )
-                    if shard is None:
-                        # no shard currently exists, create one
-                        model = await datamanagers.kb.get_model_metadata(
-                            txn, kbid=request.kbid
-                        )
-                        shard = await self.shards_manager.create_shard_by_kbid(
-                            txn, request.kbid, semantic_model=model
-                        )
-
-                    await datamanagers.resources.set_resource_shard_id(
-                        txn, kbid=request.kbid, rid=request.rid, shard=shard.shard
+                brain = await resobj.generate_index_message(reindex=True)
+                shard = await self.proc.get_or_assign_resource_shard(txn, kbobj, request.rid)
+                index_message = brain.brain
+                external_index_manager = await get_external_index_manager(kbid=request.kbid)
+                if external_index_manager is not None:
+                    await self.proc.external_index_add_resource(
+                        request.kbid,
+                        request.rid,
+                        index_message,
                     )
-
-                if shard is not None:
+                else:
                     await self.shards_manager.add_resource(
                         shard,
-                        brain.brain,
+                        index_message,
                         0,
                         partition=self.partitions[0],
                         kb=request.kbid,
                         reindex_id=uuid.uuid4().hex,
                     )
-
                 response = IndexStatus()
                 return response
         except Exception as e:
@@ -806,109 +473,51 @@ class WriterServicer(writer_pb2_grpc.WriterServicer):
             logger.error("Error in ingest gRPC servicer", exc_info=True)
             raise
 
-    async def DownloadFile(self, request: FileRequest, context=None):
-        async for data in self.storage.download(request.bucket, request.key):
-            yield BinaryData(data=data)
-
-    async def UploadFile(self, request: AsyncIterator[UploadBinaryData], context=None) -> FileUploaded:  # type: ignore
-        data: UploadBinaryData
+    async def NewVectorSet(  # type: ignore
+        self, request: NewVectorSetRequest, context=None
+    ) -> NewVectorSetResponse:
+        config = VectorSetConfig(
+            vectorset_id=request.vectorset_id,
+            vectorset_index_config=nodewriter_pb2.VectorIndexConfig(
+                similarity=request.similarity,
+                normalize_vectors=request.normalize_vectors,
+                vector_type=request.vector_type,
+                vector_dimension=request.vector_dimension,
+            ),
+            matryoshka_dimensions=request.matryoshka_dimensions,
+        )
+        response = NewVectorSetResponse()
+        try:
+            async with self.driver.transaction() as txn:
+                kbobj = KnowledgeBoxORM(txn, self.storage, request.kbid)
+                await kbobj.create_vectorset(config)
+                await txn.commit()
+        except VectorSetConflict as exc:
+            response.status = NewVectorSetResponse.Status.ERROR
+            response.details = str(exc)
+        except Exception as exc:
+            errors.capture_exception(exc)
+            logger.error("Error in ingest gRPC while creating a vectorset", exc_info=True)
+            response.status = NewVectorSetResponse.Status.ERROR
+            response.details = str(exc)
+        else:
+            response.status = NewVectorSetResponse.Status.OK
+        return response
 
-        destination: Optional[StorageField] = None
-        cf = CloudFile()
-        data = await request.__anext__()
-        if data.HasField("metadata"):
-            bucket = self.storage.get_bucket_name(data.metadata.kbid)
-            destination = self.storage.field_klass(
-                storage=self.storage, bucket=bucket, fullkey=data.metadata.key
-            )
-            cf.content_type = data.metadata.content_type
-            cf.filename = data.metadata.filename
-            cf.size = data.metadata.size
+    async def DelVectorSet(  # type: ignore
+        self, request: DelVectorSetRequest, context=None
+    ) -> DelVectorSetResponse:
+        response = DelVectorSetResponse()
+        try:
+            async with self.driver.transaction() as txn:
+                kbobj = KnowledgeBoxORM(txn, self.storage, request.kbid)
+                await kbobj.delete_vectorset(request.vectorset_id)
+                await txn.commit()
+        except Exception as exc:
+            errors.capture_exception(exc)
+            logger.error("Error in ingest gRPC while deleting a vectorset", exc_info=True)
+            response.status = DelVectorSetResponse.Status.ERROR
+            response.details = str(exc)
         else:
-            raise AttributeError("Metadata not found")
-
-        async def generate_buffer(
-            storage: Storage, request: AsyncIterator[UploadBinaryData]  # type: ignore
-        ):
-            # Storage requires uploading chunks of a specified size, this is
-            # why we need to have an intermediate buffer
-            buf = BytesIO()
-            async for chunk in request:
-                if not chunk.HasField("payload"):
-                    raise AttributeError("Payload not found")
-                buf.write(chunk.payload)
-                while buf.tell() > storage.chunk_size:
-                    buf.seek(0)
-                    data = buf.read(storage.chunk_size)
-                    if len(data):
-                        yield data
-                    old_data = buf.read()
-                    buf = BytesIO()
-                    buf.write(old_data)
-            buf.seek(0)
-            data = buf.read()
-            if len(data):
-                yield data
-
-        if destination is None:
-            raise AttributeError("No destination file")
-        await self.storage.uploaditerator(
-            generate_buffer(self.storage, request), destination, cf
-        )
-        result = FileUploaded()
-        return result
-
-
-LEARNING_SIMILARITY_FUNCTION_TO_PROTO = {
-    "cosine": utils_pb2.VectorSimilarity.COSINE,
-    "dot": utils_pb2.VectorSimilarity.DOT,
-}
-
-
-def parse_model_metadata_from_learning_config(
-    lconfig: learning_proxy.LearningConfiguration,
-) -> SemanticModelMetadata:
-    model = SemanticModelMetadata()
-    model.similarity_function = LEARNING_SIMILARITY_FUNCTION_TO_PROTO[
-        lconfig.semantic_vector_similarity
-    ]
-    if lconfig.semantic_vector_size is not None:
-        model.vector_dimension = lconfig.semantic_vector_size
-    else:
-        logger.warning("Vector dimension not set!")
-    if lconfig.semantic_threshold is not None:
-        model.default_min_score = lconfig.semantic_threshold
-    else:
-        logger.warning("Default min score not set!")
-    return model
-
-
-def parse_model_metadata_from_request(
-    request: KnowledgeBoxNew,
-) -> SemanticModelMetadata:
-    model = SemanticModelMetadata()
-    model.similarity_function = request.similarity
-    if request.HasField("vector_dimension"):
-        model.vector_dimension = request.vector_dimension
-    else:
-        logger.warning(
-            "Vector dimension not set. Will be detected automatically on the first vector set."
-        )
-    if request.HasField("default_min_score"):
-        model.default_min_score = request.default_min_score
-    else:
-        logger.warning("Default min score not set!")
-    return model
-
-
-def get_release_channel(request: KnowledgeBoxNew) -> utils_pb2.ReleaseChannel.ValueType:
-    """
-    Set channel to Experimental if specified in the grpc request or if the requested
-    slug has the experimental_kb feature enabled in stage environment.
-    """
-    release_channel = request.release_channel
-    if running_settings.running_environment == "stage" and has_feature(
-        const.Features.EXPERIMENTAL_KB, context={"slug": request.slug}
-    ):
-        release_channel = utils_pb2.ReleaseChannel.EXPERIMENTAL
-    return release_channel
+            response.status = DelVectorSetResponse.Status.OK
+        return response