qdrant-haystack 10.6.0__tar.gz → 11.1.0__tar.gz

{qdrant_haystack-10.6.0 → qdrant_haystack-11.1.0}/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [integrations/qdrant-v11.0.0] - 2026-09-25
+
+### 🚜 Refactor
+
+- [**breaking**] Qdrant - propagate errors on backend failures instead of empty responses (#3997)
+
+### ⚙️ CI
+
+- Improve changelog generation; fix existing changelogs (#3883)
+
+
+## [integrations/qdrant-v10.6.0] - 2026-09-01
+
+### 🐛 Bug Fixes
+
+- Standardize license files (#3771)
+- `QdrantDocumentStore` removing duplicated tests already covered by haystack Mixin tests + fixing dedup + adding missing Async test (#3785)
+
+
 ## [integrations/qdrant-v10.5.0] - 2026-08-03
 
 ### 🚀 Features
@@ -79,7 +98,7 @@
 
 - Feat: `QdrantDocumentStore` return number deleted docs on `delete_by_filter` (#2807)
 
-## [integrations/qdrant-v9.6.0] - 2026-02-02
+## [integrations/qdrant-v10.1.0] - 2026-02-02
 
 ### 🚀 Features
 
@@ -87,11 +106,15 @@
 
 ### 🧹 Chores
 
-- Make fmt command more forgiving (#2671)
-- [**breaking**] Qdrant - drop Python 3.9 and use X|Y typing (#2726)
 - Disabling progress bar in `QdrantDocumentStore` tests (#2797)
 
-### 🌀 Miscellaneous
+
+## [integrations/qdrant-v10.0.0] - 2026-01-13
+
+### 🧹 Chores
+
+- Make fmt command more forgiving (#2671)
+- [**breaking**] Qdrant - drop Python 3.9 and use X|Y typing (#2726)
 
 
 ## [integrations/qdrant-v9.5.0] - 2026-01-07
@@ -151,6 +174,8 @@
 - Align core-integrations Hatch scripts (#1898)
 - Update md files for new hatch scripts (#1911)
 
+## [integrations/qdrant-v9.1.3] - 2025-05-28
+
 ### 🌀 Miscellaneous
 
 - Add pins for Qdrant (#1853)
@@ -374,6 +399,18 @@
 - *(Qdrant)* Allow payload indexing + on disk vectors (#553)
 - Qdrant datetime filtering support (#570)
 
+### 📚 Documentation
+
+- Disable-class-def (#556)
+
+### 🌀 Miscellaneous
+
+- Make tests show coverage (#566)
+- Remove references to Python 3.7 (#601)
+- Make Document Stores initially skip `SparseEmbedding` (#606)
+
+## [integrations/qdrant-v3.1.0] - 2024-03-06
+
 ### 🐛 Bug Fixes
 
 - Fix: fix linter errors (#282)
@@ -388,18 +425,11 @@
 
 - Update category slug (#442)
 - Small consistency improvements (#536)
-- Disable-class-def (#556)
 
 ### ⚙️ CI
 
 - Generate API docs for Qdrant (#361)
 
-### 🌀 Miscellaneous
-
-- Make tests show coverage (#566)
-- Remove references to Python 3.7 (#601)
-- Make Document Stores initially skip `SparseEmbedding` (#606)
-
 ## [integrations/qdrant-v3.0.0] - 2024-01-22
 
 ### 🌀 Miscellaneous
@@ -408,20 +438,22 @@
 
 ## [integrations/qdrant-v2.0.1] - 2024-01-18
 
-### 🚀 Features
-
-- Add Qdrant integration (#98)
-
 ### 🐛 Bug Fixes
 
 - Fix import paths for beta5 (#237)
 
-### 🚜 Refactor
-
-- Use `hatch_vcs` to manage integrations versioning (#103)
-
 ### 🌀 Miscellaneous
 
 - Renamed QdrntRetriever to QdrntEmbeddingRetriever (#174)
 
+## [integrations/qdrant-v2.0.0] - 2023-12-18
+
+### 🚀 Features
+
+- Add Qdrant integration (#98)
+
+### 🚜 Refactor
+
+- Use `hatch_vcs` to manage integrations versioning (#103)
+
 <!-- generated by git-cliff -->

{qdrant_haystack-10.6.0 → qdrant_haystack-11.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: qdrant-haystack
-Version: 10.6.0
+Version: 11.1.0
 Summary: An integration of Qdrant ANN vector database backend with Haystack
 Project-URL: Source, https://github.com/deepset-ai/haystack-core-integrations
 Project-URL: Documentation, https://github.com/deepset-ai/haystack-core-integrations/blob/main/integrations/qdrant/README.md

{qdrant_haystack-10.6.0 → qdrant_haystack-11.1.0}/src/haystack_integrations/components/retrievers/qdrant/retriever.py

@@ -188,9 +188,9 @@ class QdrantEmbeddingRetriever:
             query_embedding=query_embedding,
             filters=filters,
             top_k=top_k or self._top_k,
-            scale_score=scale_score or self._scale_score,
-            return_embedding=return_embedding or self._return_embedding,
-            score_threshold=score_threshold or self._score_threshold,
+            scale_score=scale_score if scale_score is not None else self._scale_score,
+            return_embedding=return_embedding if return_embedding is not None else self._return_embedding,
+            score_threshold=score_threshold if score_threshold is not None else self._score_threshold,
             group_by=group_by or self._group_by,
             group_size=group_size or self._group_size,
         )
@@ -243,9 +243,9 @@ class QdrantEmbeddingRetriever:
             query_embedding=query_embedding,
             filters=filters,
             top_k=top_k or self._top_k,
-            scale_score=scale_score or self._scale_score,
-            return_embedding=return_embedding or self._return_embedding,
-            score_threshold=score_threshold or self._score_threshold,
+            scale_score=scale_score if scale_score is not None else self._scale_score,
+            return_embedding=return_embedding if return_embedding is not None else self._return_embedding,
+            score_threshold=score_threshold if score_threshold is not None else self._score_threshold,
             group_by=group_by or self._group_by,
             group_size=group_size or self._group_size,
         )
@@ -433,9 +433,9 @@ class QdrantSparseEmbeddingRetriever:
             query_sparse_embedding=query_sparse_embedding,
             filters=filters,
             top_k=top_k or self._top_k,
-            scale_score=scale_score or self._scale_score,
-            return_embedding=return_embedding or self._return_embedding,
-            score_threshold=score_threshold or self._score_threshold,
+            scale_score=scale_score if scale_score is not None else self._scale_score,
+            return_embedding=return_embedding if return_embedding is not None else self._return_embedding,
+            score_threshold=score_threshold if score_threshold is not None else self._score_threshold,
             group_by=group_by or self._group_by,
             group_size=group_size or self._group_size,
         )
@@ -493,9 +493,9 @@ class QdrantSparseEmbeddingRetriever:
             query_sparse_embedding=query_sparse_embedding,
             filters=filters,
             top_k=top_k or self._top_k,
-            scale_score=scale_score or self._scale_score,
-            return_embedding=return_embedding or self._return_embedding,
-            score_threshold=score_threshold or self._score_threshold,
+            scale_score=scale_score if scale_score is not None else self._scale_score,
+            return_embedding=return_embedding if return_embedding is not None else self._return_embedding,
+            score_threshold=score_threshold if score_threshold is not None else self._score_threshold,
             group_by=group_by or self._group_by,
             group_size=group_size or self._group_size,
         )
@@ -560,9 +560,10 @@ class QdrantHybridRetriever:
         :param return_embedding: Whether to return the embeddings of the retrieved Documents.
         :param filter_policy: Policy to determine how filters are applied.
         :param score_threshold: A minimal score threshold for the result.
-            Score of the returned result might be higher or smaller than the threshold
-             depending on the Distance function used.
-            E.g. for cosine similarity only higher scores will be returned.
+            The threshold is applied to the fused Reciprocal Rank Fusion (RRF) scores, so only documents with a
+            higher fused score are returned. RRF scores are not comparable to dense or sparse similarity scores,
+            so thresholds tuned for those retrievers don't carry over. With `group_by`, groups with no surviving
+            hits are dropped.
         :param group_by: Payload field to group by, must be a string or number field. If the field contains more than 1
              value, all values will be used for grouping. One point can be in multiple groups.
         :param group_size: Maximum amount of points to return per group. Default is 3.
@@ -659,7 +660,7 @@ class QdrantHybridRetriever:
         rrf_weights: list[float] | None = None,
     ) -> dict[str, list[Document]]:
         """
-        Run the Sparse Embedding Retriever on the given input data.
+        Run the Hybrid Retriever on the given input data.
 
         :param query_embedding: Dense embedding of the query.
         :param query_sparse_embedding: Sparse embedding of the query.
@@ -670,9 +671,10 @@ class QdrantHybridRetriever:
              groups to return.
         :param return_embedding: Whether to return the embedding of the retrieved Documents.
         :param score_threshold: A minimal score threshold for the result.
-            Score of the returned result might be higher or smaller than the threshold
-             depending on the Distance function used.
-            E.g. for cosine similarity only higher scores will be returned.
+            The threshold is applied to the fused Reciprocal Rank Fusion (RRF) scores, so only documents with a
+            higher fused score are returned. RRF scores are not comparable to dense or sparse similarity scores,
+            so thresholds tuned for those retrievers don't carry over. With `group_by`, groups with no surviving
+            hits are dropped.
         :param group_by: Payload field to group by, must be a string or number field. If the field contains more than 1
              value, all values will be used for grouping. One point can be in multiple groups.
         :param group_size: Maximum amount of points to return per group. Default is 3.
@@ -704,8 +706,8 @@ class QdrantHybridRetriever:
             query_sparse_embedding=query_sparse_embedding,
             filters=filters,
             top_k=top_k or self._top_k,
-            return_embedding=return_embedding or self._return_embedding,
-            score_threshold=score_threshold or self._score_threshold,
+            return_embedding=return_embedding if return_embedding is not None else self._return_embedding,
+            score_threshold=score_threshold if score_threshold is not None else self._score_threshold,
             group_by=group_by or self._group_by,
             group_size=group_size or self._group_size,
             rrf_k=rrf_k if rrf_k is not None else self._rrf_k,
@@ -729,7 +731,7 @@ class QdrantHybridRetriever:
         rrf_weights: list[float] | None = None,
     ) -> dict[str, list[Document]]:
         """
-        Asynchronously run the Sparse Embedding Retriever on the given input data.
+        Asynchronously run the Hybrid Retriever on the given input data.
 
         :param query_embedding: Dense embedding of the query.
         :param query_sparse_embedding: Sparse embedding of the query.
@@ -740,9 +742,10 @@ class QdrantHybridRetriever:
              groups to return.
         :param return_embedding: Whether to return the embedding of the retrieved Documents.
         :param score_threshold: A minimal score threshold for the result.
-            Score of the returned result might be higher or smaller than the threshold
-             depending on the Distance function used.
-            E.g. for cosine similarity only higher scores will be returned.
+            The threshold is applied to the fused Reciprocal Rank Fusion (RRF) scores, so only documents with a
+            higher fused score are returned. RRF scores are not comparable to dense or sparse similarity scores,
+            so thresholds tuned for those retrievers don't carry over. With `group_by`, groups with no surviving
+            hits are dropped.
         :param group_by: Payload field to group by, must be a string or number field. If the field contains more than 1
              value, all values will be used for grouping. One point can be in multiple groups.
         :param group_size: Maximum amount of points to return per group. Default is 3.
@@ -774,8 +777,8 @@ class QdrantHybridRetriever:
             query_sparse_embedding=query_sparse_embedding,
             filters=filters,
             top_k=top_k or self._top_k,
-            return_embedding=return_embedding or self._return_embedding,
-            score_threshold=score_threshold or self._score_threshold,
+            return_embedding=return_embedding if return_embedding is not None else self._return_embedding,
+            score_threshold=score_threshold if score_threshold is not None else self._score_threshold,
             group_by=group_by or self._group_by,
             group_size=group_size or self._group_size,
             rrf_k=rrf_k if rrf_k is not None else self._rrf_k,

{qdrant_haystack-10.6.0 → qdrant_haystack-11.1.0}/src/haystack_integrations/document_stores/qdrant/document_store.py

@@ -15,7 +15,6 @@ from haystack.utils import Secret, deserialize_secrets_inplace
 from haystack.utils.misc import _normalize_metadata_field_name
 from numpy import exp
 from qdrant_client.http import models as rest
-from qdrant_client.http.exceptions import UnexpectedResponse
 from tqdm import tqdm
 
 from .converters import (
@@ -338,6 +337,9 @@ class QdrantDocumentStore:
     def count_documents(self) -> int:
         """
         Returns the number of documents present in the Document Store.
+
+        :returns: The number of documents in the collection.
+        :raises QdrantStoreError: Counting documents fails.
         """
         self._initialize_client()
         assert self._client is not None
@@ -346,15 +348,16 @@ class QdrantDocumentStore:
                 collection_name=self.index,
             )
             return response.count
-        except (UnexpectedResponse, ValueError):
-            # Qdrant local raises ValueError if the collection is not found, but
-            # with the remote server UnexpectedResponse is raised. Until that's unified,
-            # we need to catch both.
-            return 0
+        except Exception as e:
+            msg = f"Error when calling QdrantDocumentStore.count_documents(): {e}"
+            raise QdrantStoreError(msg) from e
 
     async def count_documents_async(self) -> int:
         """
-        Asynchronously returns the number of documents present in the document dtore.
+        Asynchronously returns the number of documents present in the document store.
+
+        :returns: The number of documents in the collection.
+        :raises QdrantStoreError: Counting documents fails.
         """
         await self._initialize_async_client()
         assert self._async_client is not None
@@ -363,11 +366,9 @@ class QdrantDocumentStore:
                 collection_name=self.index,
             )
             return response.count
-        except (UnexpectedResponse, ValueError):
-            # Qdrant local raises ValueError if the collection is not found, but
-            # with the remote server UnexpectedResponse is raised. Until that's unified,
-            # we need to catch both.
-            return 0
+        except Exception as e:
+            msg = f"Error when calling QdrantDocumentStore.count_documents_async(): {e}"
+            raise QdrantStoreError(msg) from e
 
     def filter_documents(
         self,
@@ -921,38 +922,39 @@ class QdrantDocumentStore:
         Deletes all documents from the document store.
 
         :param recreate_index: Whether to recreate the index after deleting all documents.
+        :raises QdrantStoreError: Deleting documents or recreating the collection fails.
         """
 
         self._initialize_client()
         assert self._client is not None
 
-        if recreate_index:
-            # get current collection config as json
-            collection_info = self._client.get_collection(collection_name=self.index)
-            info_json = collection_info.model_dump()
+        try:
+            if recreate_index:
+                # get current collection config as json
+                collection_info = self._client.get_collection(collection_name=self.index)
+                info_json = collection_info.model_dump()
 
-            # deal with the Optional use_sparse_embeddings
-            sparse_vectors = info_json["config"]["params"]["sparse_vectors"]
-            use_sparse_embeddings = True if sparse_vectors else False
+                # deal with the Optional use_sparse_embeddings
+                sparse_vectors = info_json["config"]["params"]["sparse_vectors"]
+                use_sparse_embeddings = True if sparse_vectors else False
 
-            # deal with the Optional sparse_idf
-            hnsw_config = info_json["config"]["params"]["vectors"].get("config", {}).get("hnsw_config", None)
-            sparse_idf = True if use_sparse_embeddings and hnsw_config else False
+                # deal with the Optional sparse_idf
+                hnsw_config = info_json["config"]["params"]["vectors"].get("config", {}).get("hnsw_config", None)
+                sparse_idf = True if use_sparse_embeddings and hnsw_config else False
 
-            # recreate collection
-            self._set_up_collection(
-                collection_name=self.index,
-                embedding_dim=info_json["config"]["params"]["vectors"]["size"],
-                recreate_collection=True,
-                similarity=info_json["config"]["params"]["vectors"]["distance"].lower(),
-                use_sparse_embeddings=use_sparse_embeddings,
-                sparse_idf=sparse_idf,
-                on_disk=info_json["config"]["hnsw_config"]["on_disk"],
-                payload_fields_to_index=info_json["payload_schema"],
-            )
+                # recreate collection
+                self._set_up_collection(
+                    collection_name=self.index,
+                    embedding_dim=info_json["config"]["params"]["vectors"]["size"],
+                    recreate_collection=True,
+                    similarity=info_json["config"]["params"]["vectors"]["distance"].lower(),
+                    use_sparse_embeddings=use_sparse_embeddings,
+                    sparse_idf=sparse_idf,
+                    on_disk=info_json["config"]["hnsw_config"]["on_disk"],
+                    payload_fields_to_index=info_json["payload_schema"],
+                )
 
-        else:
-            try:
+            else:
                 self._client.delete(
                     collection_name=self.index,
                     points_selector=rest.FilterSelector(
@@ -962,48 +964,48 @@ class QdrantDocumentStore:
                     ),
                     wait=self.wait_result_from_api,
                 )
-            except Exception as e:
-                logger.warning(
-                    f"Error {e} when calling QdrantDocumentStore.delete_all_documents()",
-                )
+        except Exception as e:
+            msg = f"Error when calling QdrantDocumentStore.delete_all_documents(): {e}"
+            raise QdrantStoreError(msg) from e
 
     async def delete_all_documents_async(self, recreate_index: bool = False) -> None:
         """
         Asynchronously deletes all documents from the document store.
 
         :param recreate_index: Whether to recreate the index after deleting all documents.
+        :raises QdrantStoreError: Deleting documents or recreating the collection fails.
         """
 
         await self._initialize_async_client()
         assert self._async_client is not None
 
-        if recreate_index:
-            # get current collection config as json
-            collection_info = await self._async_client.get_collection(collection_name=self.index)
-            info_json = collection_info.model_dump()
+        try:
+            if recreate_index:
+                # get current collection config as json
+                collection_info = await self._async_client.get_collection(collection_name=self.index)
+                info_json = collection_info.model_dump()
 
-            # deal with the Optional use_sparse_embeddings
-            sparse_vectors = info_json["config"]["params"]["sparse_vectors"]
-            use_sparse_embeddings = True if sparse_vectors else False
+                # deal with the Optional use_sparse_embeddings
+                sparse_vectors = info_json["config"]["params"]["sparse_vectors"]
+                use_sparse_embeddings = True if sparse_vectors else False
 
-            # deal with the Optional sparse_idf
-            hnsw_config = info_json["config"]["params"]["vectors"].get("config", {}).get("hnsw_config", None)
-            sparse_idf = True if use_sparse_embeddings and hnsw_config else False
+                # deal with the Optional sparse_idf
+                hnsw_config = info_json["config"]["params"]["vectors"].get("config", {}).get("hnsw_config", None)
+                sparse_idf = True if use_sparse_embeddings and hnsw_config else False
 
-            # recreate collection
-            await self._set_up_collection_async(
-                collection_name=self.index,
-                embedding_dim=info_json["config"]["params"]["vectors"]["size"],
-                recreate_collection=True,
-                similarity=info_json["config"]["params"]["vectors"]["distance"].lower(),
-                use_sparse_embeddings=use_sparse_embeddings,
-                sparse_idf=sparse_idf,
-                on_disk=info_json["config"]["hnsw_config"]["on_disk"],
-                payload_fields_to_index=info_json["payload_schema"],
-            )
+                # recreate collection
+                await self._set_up_collection_async(
+                    collection_name=self.index,
+                    embedding_dim=info_json["config"]["params"]["vectors"]["size"],
+                    recreate_collection=True,
+                    similarity=info_json["config"]["params"]["vectors"]["distance"].lower(),
+                    use_sparse_embeddings=use_sparse_embeddings,
+                    sparse_idf=sparse_idf,
+                    on_disk=info_json["config"]["hnsw_config"]["on_disk"],
+                    payload_fields_to_index=info_json["payload_schema"],
+                )
 
-        else:
-            try:
+            else:
                 await self._async_client.delete(
                     collection_name=self.index,
                     points_selector=rest.FilterSelector(
@@ -1013,10 +1015,9 @@ class QdrantDocumentStore:
                     ),
                     wait=self.wait_result_from_api,
                 )
-            except Exception as e:
-                logger.warning(
-                    f"Error {e} when calling QdrantDocumentStore.delete_all_documents_async()",
-                )
+        except Exception as e:
+            msg = f"Error when calling QdrantDocumentStore.delete_all_documents_async(): {e}"
+            raise QdrantStoreError(msg) from e
 
     def count_documents_by_filter(self, filters: dict[str, Any]) -> int:
         """
@@ -1026,6 +1027,7 @@ class QdrantDocumentStore:
             For filter syntax, see [Haystack metadata filtering](https://docs.haystack.deepset.ai/docs/metadata-filtering)
 
         :returns: The number of documents that match the filters.
+        :raises QdrantStoreError: Counting documents matching the filters fails.
         """
         self._initialize_client()
         assert self._client is not None
@@ -1037,9 +1039,9 @@ class QdrantDocumentStore:
                 count_filter=qdrant_filter,
             )
             return response.count
-        except (UnexpectedResponse, ValueError) as e:
-            logger.warning(f"Error {e} when calling QdrantDocumentStore.count_documents_by_filter()")
-            return 0
+        except Exception as e:
+            msg = f"Error when calling QdrantDocumentStore.count_documents_by_filter(): {e}"
+            raise QdrantStoreError(msg) from e
 
     async def count_documents_by_filter_async(self, filters: dict[str, Any]) -> int:
         """
@@ -1050,6 +1052,7 @@ class QdrantDocumentStore:
 
         :returns:
             The number of documents that match the filters.
+        :raises QdrantStoreError: Counting documents matching the filters fails.
         """
         await self._initialize_async_client()
         assert self._async_client is not None
@@ -1061,9 +1064,9 @@ class QdrantDocumentStore:
                 count_filter=qdrant_filter,
             )
             return response.count
-        except (UnexpectedResponse, ValueError) as e:
-            logger.warning(f"Error {e} when calling QdrantDocumentStore.count_documents_by_filter_async()")
-            return 0
+        except Exception as e:
+            msg = f"Error when calling QdrantDocumentStore.count_documents_by_filter_async(): {e}"
+            raise QdrantStoreError(msg) from e
 
     def get_metadata_fields_info(self) -> dict[str, dict[str, str]]:
         """
@@ -1078,6 +1081,7 @@ class QdrantDocumentStore:
             ```python
             {"category": {"type": "keyword"}, "priority": {"type": "long"}}
             ```
+        :raises QdrantStoreError: Retrieving or processing metadata field information fails.
         """
         self._initialize_client()
         assert self._client is not None
@@ -1103,9 +1107,9 @@ class QdrantDocumentStore:
                         break
 
             return fields_info
-        except (UnexpectedResponse, ValueError) as e:
-            logger.warning(f"Error {e} when calling QdrantDocumentStore.get_metadata_fields_info()")
-            return {}
+        except Exception as e:
+            msg = f"Error when calling QdrantDocumentStore.get_metadata_fields_info(): {e}"
+            raise QdrantStoreError(msg) from e
 
     async def get_metadata_fields_info_async(self) -> dict[str, dict[str, str]]:
         """
@@ -1120,6 +1124,7 @@ class QdrantDocumentStore:
             ```python
             {"category": {"type": "keyword"}, "priority": {"type": "long"}}
             ```
+        :raises QdrantStoreError: Retrieving or processing metadata field information fails.
         """
         await self._initialize_async_client()
         assert self._async_client is not None
@@ -1145,9 +1150,9 @@ class QdrantDocumentStore:
                         break
 
             return fields_info
-        except (UnexpectedResponse, ValueError) as e:
-            logger.warning(f"Error {e} when calling QdrantDocumentStore.get_metadata_fields_info_async()")
-            return {}
+        except Exception as e:
+            msg = f"Error when calling QdrantDocumentStore.get_metadata_fields_info_async(): {e}"
+            raise QdrantStoreError(msg) from e
 
     def get_metadata_field_min_max(self, metadata_field: str) -> dict[str, Any]:
         """
@@ -1158,6 +1163,7 @@ class QdrantDocumentStore:
         :returns: A dictionary with the keys "min" and "max", where each value is the minimum or maximum value of the
                   metadata field across all documents. Returns ``{"min": None, "max": None}`` if no documents have
                   the field.
+        :raises QdrantStoreError: Retrieving or computing the metadata bounds fails.
         """
         self._initialize_client()
         assert self._client is not None
@@ -1183,8 +1189,8 @@ class QdrantDocumentStore:
 
             return {"min": min_value, "max": max_value}
         except Exception as e:
-            logger.warning(f"Error {e} when calling QdrantDocumentStore.get_metadata_field_min_max()")
-            return {}
+            msg = f"Error when calling QdrantDocumentStore.get_metadata_field_min_max(): {e}"
+            raise QdrantStoreError(msg) from e
 
     async def get_metadata_field_min_max_async(self, metadata_field: str) -> dict[str, Any]:
         """
@@ -1195,6 +1201,7 @@ class QdrantDocumentStore:
         :returns: A dictionary with the keys "min" and "max", where each value is the minimum or maximum value of the
                   metadata field across all documents. Returns ``{"min": None, "max": None}`` if no documents have
                   the field.
+        :raises QdrantStoreError: Retrieving or computing the metadata bounds fails.
         """
         await self._initialize_async_client()
         assert self._async_client is not None
@@ -1220,8 +1227,8 @@ class QdrantDocumentStore:
 
             return {"min": min_value, "max": max_value}
         except Exception as e:
-            logger.warning(f"Error {e} when calling QdrantDocumentStore.get_metadata_field_min_max_async()")
-            return {}
+            msg = f"Error when calling QdrantDocumentStore.get_metadata_field_min_max_async(): {e}"
+            raise QdrantStoreError(msg) from e
 
     def count_unique_metadata_by_filter(self, filters: dict[str, Any], metadata_fields: list[str]) -> dict[str, int]:
         """
@@ -1233,6 +1240,7 @@ class QdrantDocumentStore:
 
         :returns: A dictionary mapping each metadata field name to the count of its unique values among the filtered
                   documents.
+        :raises QdrantStoreError: Retrieving or counting unique metadata values fails.
         """
         self._initialize_client()
         assert self._client is not None
@@ -1257,8 +1265,8 @@ class QdrantDocumentStore:
 
             return {field: len(unique_values_by_field[field]) for field in metadata_fields}
         except Exception as e:
-            logger.warning(f"Error {e} when calling QdrantDocumentStore.count_unique_metadata_by_filter()")
-            return dict.fromkeys(metadata_fields, 0)
+            msg = f"Error when calling QdrantDocumentStore.count_unique_metadata_by_filter(): {e}"
+            raise QdrantStoreError(msg) from e
 
     async def count_unique_metadata_by_filter_async(
         self, filters: dict[str, Any], metadata_fields: list[str]
@@ -1274,6 +1282,7 @@ class QdrantDocumentStore:
 
         :returns: A dictionary mapping each metadata field name to the count of its unique values among the filtered
                   documents.
+        :raises QdrantStoreError: Retrieving or counting unique metadata values fails.
         """
         await self._initialize_async_client()
         assert self._async_client is not None
@@ -1298,8 +1307,8 @@ class QdrantDocumentStore:
 
             return {field: len(unique_values_by_field[field]) for field in metadata_fields}
         except Exception as e:
-            logger.warning(f"Error {e} when calling QdrantDocumentStore.count_unique_metadata_by_filter_async()")
-            return dict.fromkeys(metadata_fields, 0)
+            msg = f"Error when calling QdrantDocumentStore.count_unique_metadata_by_filter_async(): {e}"
+            raise QdrantStoreError(msg) from e
 
     def get_metadata_field_unique_values(
         self,
@@ -1325,6 +1334,7 @@ class QdrantDocumentStore:
             For filter syntax, see [Haystack metadata filtering](https://docs.haystack.deepset.ai/docs/metadata-filtering)
 
         :returns: A tuple containing (list of unique values, total count of unique matching values).
+        :raises QdrantStoreError: Retrieving or processing unique metadata values fails.
         """
         self._initialize_client()
         assert self._client is not None
@@ -1353,8 +1363,8 @@ class QdrantDocumentStore:
             total_count = len(unique_values)
             return unique_values[from_ : from_ + size], total_count
         except Exception as e:
-            logger.warning(f"Error {e} when calling QdrantDocumentStore.get_metadata_field_unique_values()")
-            return [], 0
+            msg = f"Error when calling QdrantDocumentStore.get_metadata_field_unique_values(): {e}"
+            raise QdrantStoreError(msg) from e
 
     async def get_metadata_field_unique_values_async(
         self,
@@ -1380,6 +1390,7 @@ class QdrantDocumentStore:
             For filter syntax, see [Haystack metadata filtering](https://docs.haystack.deepset.ai/docs/metadata-filtering)
 
         :returns: A tuple containing (list of unique values, total count of unique matching values).
+        :raises QdrantStoreError: Retrieving or processing unique metadata values fails.
         """
         await self._initialize_async_client()
         assert self._async_client is not None
@@ -1408,8 +1419,8 @@ class QdrantDocumentStore:
             total_count = len(unique_values)
             return unique_values[from_ : from_ + size], total_count
         except Exception as e:
-            logger.warning(f"Error {e} when calling QdrantDocumentStore.get_metadata_field_unique_values_async()")
-            return [], 0
+            msg = f"Error when calling QdrantDocumentStore.get_metadata_field_unique_values_async(): {e}"
+            raise QdrantStoreError(msg) from e
 
     @classmethod
     def from_dict(cls, data: dict[str, Any]) -> "QdrantDocumentStore":
@@ -1746,9 +1757,10 @@ class QdrantDocumentStore:
              groups to return.
         :param return_embedding: Whether to return the embeddings of the retrieved documents.
         :param score_threshold: A minimal score threshold for the result.
-            Score of the returned result might be higher or smaller than the threshold
-             depending on the Distance function used.
-            E.g. for cosine similarity only higher scores will be returned.
+            The threshold is applied to the fused Reciprocal Rank Fusion (RRF) scores, so only documents with a
+            higher fused score are returned. RRF scores are not comparable to dense or sparse similarity scores,
+            so thresholds tuned for those retrievers don't carry over. With `group_by`, groups with no surviving
+            hits are dropped.
         :param group_by: Payload field to group by, must be a string or number field. If the field contains more than 1
              value, all values will be used for grouping. One point can be in multiple groups.
         :param group_size: Maximum amount of points to return per group. Default is 3.
@@ -2009,9 +2021,10 @@ class QdrantDocumentStore:
              groups to return.
         :param return_embedding: Whether to return the embeddings of the retrieved documents.
         :param score_threshold: A minimal score threshold for the result.
-            Score of the returned result might be higher or smaller than the threshold
-             depending on the Distance function used.
-            E.g. for cosine similarity only higher scores will be returned.
+            The threshold is applied to the fused Reciprocal Rank Fusion (RRF) scores, so only documents with a
+            higher fused score are returned. RRF scores are not comparable to dense or sparse similarity scores,
+            so thresholds tuned for those retrievers don't carry over. With `group_by`, groups with no surviving
+            hits are dropped.
         :param group_by: Payload field to group by, must be a string or number field. If the field contains more than 1
              value, all values will be used for grouping. One point can be in multiple groups.
         :param group_size: Maximum amount of points to return per group. Default is 3.

{qdrant_haystack-10.6.0 → qdrant_haystack-11.1.0}/tests/test_document_store.py

@@ -377,17 +377,19 @@ class TestQdrantDocumentStoreUnit:
             document_store._query_by_sparse(query_sparse_embedding=sparse_embedding)
 
     @pytest.mark.parametrize(
-        ("method_name", "args", "expected"),
+        ("method_name", "args"),
         [
-            ("count_documents", (), 0),
-            ("count_documents_by_filter", ({},), 0),
-            ("get_metadata_fields_info", (), {}),
-            ("get_metadata_field_min_max", ("score",), {}),
-            ("count_unique_metadata_by_filter", ({}, ["category"]), {"category": 0}),
-            ("get_metadata_field_unique_values", ("category",), ([], 0)),
+            ("count_documents", ()),
+            ("delete_all_documents", (False,)),
+            ("delete_all_documents", (True,)),
+            ("count_documents_by_filter", ({},)),
+            ("get_metadata_fields_info", ()),
+            ("get_metadata_field_min_max", ("score",)),
+            ("count_unique_metadata_by_filter", ({}, ["category"])),
+            ("get_metadata_field_unique_values", ("category",)),
         ],
     )
-    def test_metadata_methods_swallow_client_errors(self, method_name, args, expected):
+    def test_operations_raise_on_client_errors(self, method_name, args):
         document_store = QdrantDocumentStore(location=":memory:")
         document_store._initialize_client()
         err = ValueError("boom")
@@ -395,8 +397,11 @@ class TestQdrantDocumentStoreUnit:
             patch.object(document_store._client, "count", side_effect=err),
             patch.object(document_store._client, "scroll", side_effect=err),
             patch.object(document_store._client, "get_collection", side_effect=err),
+            patch.object(document_store._client, "delete", side_effect=err),
         ):
-            assert getattr(document_store, method_name)(*args) == expected
+            with pytest.raises(QdrantStoreError) as exc_info:
+                getattr(document_store, method_name)(*args)
+            assert exc_info.value.__cause__ is err
 
     def test_close(self):
         document_store = QdrantDocumentStore(location=":memory:")

{qdrant_haystack-10.6.0 → qdrant_haystack-11.1.0}/tests/test_document_store_async.py

@@ -141,17 +141,19 @@ class TestQdrantDocumentStoreAsyncUnit:
             await document_store.delete_documents_async(["doc-1"])
 
     @pytest.mark.parametrize(
-        ("method_name", "args", "expected"),
+        ("method_name", "args"),
         [
-            ("count_documents_async", (), 0),
-            ("count_documents_by_filter_async", ({},), 0),
-            ("get_metadata_fields_info_async", (), {}),
-            ("get_metadata_field_min_max_async", ("score",), {}),
-            ("count_unique_metadata_by_filter_async", ({}, ["category"]), {"category": 0}),
-            ("get_metadata_field_unique_values_async", ("category",), ([], 0)),
+            ("count_documents_async", ()),
+            ("delete_all_documents_async", (False,)),
+            ("delete_all_documents_async", (True,)),
+            ("count_documents_by_filter_async", ({},)),
+            ("get_metadata_fields_info_async", ()),
+            ("get_metadata_field_min_max_async", ("score",)),
+            ("count_unique_metadata_by_filter_async", ({}, ["category"])),
+            ("get_metadata_field_unique_values_async", ("category",)),
         ],
     )
-    async def test_metadata_methods_async_absorb_client_errors(self, method_name, args, expected):
+    async def test_operations_async_raise_on_client_errors(self, method_name, args):
         document_store = QdrantDocumentStore(location=":memory:")
         await document_store._initialize_async_client()
         err = ValueError("boom")
@@ -159,8 +161,11 @@ class TestQdrantDocumentStoreAsyncUnit:
             patch.object(document_store._async_client, "count", side_effect=err),
             patch.object(document_store._async_client, "scroll", side_effect=err),
             patch.object(document_store._async_client, "get_collection", side_effect=err),
+            patch.object(document_store._async_client, "delete", side_effect=err),
         ):
-            assert await getattr(document_store, method_name)(*args) == expected
+            with pytest.raises(QdrantStoreError) as exc_info:
+                await getattr(document_store, method_name)(*args)
+            assert exc_info.value.__cause__ is err
 
     async def test_close_async(self):
         document_store = QdrantDocumentStore(location=":memory:")

{qdrant_haystack-10.6.0 → qdrant_haystack-11.1.0}/tests/test_embedding_retriever.py

@@ -200,6 +200,37 @@ class TestQdrantRetriever:
         mock_store._query_by_embedding_async.assert_awaited_once()
         assert res["documents"][0].content == "doc"
 
+    def test_run_falsy_runtime_values_override_init(self):
+        mock_store = Mock(spec=QdrantDocumentStore)
+        mock_store._query_by_embedding.return_value = []
+
+        retriever = QdrantEmbeddingRetriever(
+            document_store=mock_store, scale_score=True, return_embedding=True, score_threshold=0.5
+        )
+        retriever.run(query_embedding=[0.5, 0.7], scale_score=False, return_embedding=False, score_threshold=0.0)
+
+        call_kwargs = mock_store._query_by_embedding.call_args.kwargs
+        assert call_kwargs["scale_score"] is False
+        assert call_kwargs["return_embedding"] is False
+        assert call_kwargs["score_threshold"] == 0.0
+
+    @pytest.mark.asyncio
+    async def test_run_async_falsy_runtime_values_override_init(self):
+        mock_store = Mock(spec=QdrantDocumentStore)
+        mock_store._query_by_embedding_async = AsyncMock(return_value=[])
+
+        retriever = QdrantEmbeddingRetriever(
+            document_store=mock_store, scale_score=True, return_embedding=True, score_threshold=0.5
+        )
+        await retriever.run_async(
+            query_embedding=[0.5, 0.7], scale_score=False, return_embedding=False, score_threshold=0.0
+        )
+
+        call_kwargs = mock_store._query_by_embedding_async.call_args.kwargs
+        assert call_kwargs["scale_score"] is False
+        assert call_kwargs["return_embedding"] is False
+        assert call_kwargs["score_threshold"] == 0.0
+
     def test_run_raises_when_merge_with_native_init_filter(self):
         document_store = QdrantDocumentStore(location=":memory:", index="test")
         retriever = QdrantEmbeddingRetriever(

{qdrant_haystack-10.6.0 → qdrant_haystack-11.1.0}/tests/test_hybrid_retriever.py

@@ -229,6 +229,39 @@ class TestQdrantHybridRetriever:
         assert call_args[1]["rrf_k"] == 100
         assert call_args[1]["rrf_weights"] == [3.0, 1.0]
 
+    def test_run_falsy_runtime_values_override_init(self):
+        mock_store = Mock(spec=QdrantDocumentStore)
+        mock_store._query_hybrid.return_value = []
+
+        retriever = QdrantHybridRetriever(document_store=mock_store, return_embedding=True, score_threshold=0.5)
+        retriever.run(
+            query_embedding=[0.5, 0.7],
+            query_sparse_embedding=SparseEmbedding(indices=[0, 5], values=[0.1, 0.7]),
+            return_embedding=False,
+            score_threshold=0.0,
+        )
+
+        call_args = mock_store._query_hybrid.call_args
+        assert call_args[1]["return_embedding"] is False
+        assert call_args[1]["score_threshold"] == 0.0
+
+    @pytest.mark.asyncio
+    async def test_run_async_falsy_runtime_values_override_init(self):
+        mock_store = Mock(spec=QdrantDocumentStore)
+        mock_store._query_hybrid_async = AsyncMock(return_value=[])
+
+        retriever = QdrantHybridRetriever(document_store=mock_store, return_embedding=True, score_threshold=0.5)
+        await retriever.run_async(
+            query_embedding=[0.5, 0.7],
+            query_sparse_embedding=SparseEmbedding(indices=[0, 5], values=[0.1, 0.7]),
+            return_embedding=False,
+            score_threshold=0.0,
+        )
+
+        call_args = mock_store._query_hybrid_async.call_args
+        assert call_args[1]["return_embedding"] is False
+        assert call_args[1]["score_threshold"] == 0.0
+
     def test_run_with_group_by(self):
         mock_store = Mock(spec=QdrantDocumentStore)
         sparse_embedding = SparseEmbedding(indices=[0, 1, 2, 3], values=[0.1, 0.8, 0.05, 0.33])

{qdrant_haystack-10.6.0 → qdrant_haystack-11.1.0}/tests/test_sparse_embedding_retriever.py

@@ -199,6 +199,39 @@ class TestQdrantSparseEmbeddingRetriever:
         mock_store._query_by_sparse_async.assert_awaited_once()
         assert res["documents"][0].content == "doc"
 
+    def test_run_falsy_runtime_values_override_init(self):
+        mock_store = Mock(spec=QdrantDocumentStore)
+        mock_store._query_by_sparse.return_value = []
+        sparse = SparseEmbedding(indices=[0, 5], values=[0.1, 0.7])
+
+        retriever = QdrantSparseEmbeddingRetriever(
+            document_store=mock_store, scale_score=True, return_embedding=True, score_threshold=0.5
+        )
+        retriever.run(query_sparse_embedding=sparse, scale_score=False, return_embedding=False, score_threshold=0.0)
+
+        call_kwargs = mock_store._query_by_sparse.call_args.kwargs
+        assert call_kwargs["scale_score"] is False
+        assert call_kwargs["return_embedding"] is False
+        assert call_kwargs["score_threshold"] == 0.0
+
+    @pytest.mark.asyncio
+    async def test_run_async_falsy_runtime_values_override_init(self):
+        mock_store = Mock(spec=QdrantDocumentStore)
+        mock_store._query_by_sparse_async = AsyncMock(return_value=[])
+        sparse = SparseEmbedding(indices=[0, 5], values=[0.1, 0.7])
+
+        retriever = QdrantSparseEmbeddingRetriever(
+            document_store=mock_store, scale_score=True, return_embedding=True, score_threshold=0.5
+        )
+        await retriever.run_async(
+            query_sparse_embedding=sparse, scale_score=False, return_embedding=False, score_threshold=0.0
+        )
+
+        call_kwargs = mock_store._query_by_sparse_async.call_args.kwargs
+        assert call_kwargs["scale_score"] is False
+        assert call_kwargs["return_embedding"] is False
+        assert call_kwargs["score_threshold"] == 0.0
+
     def test_run_raises_when_merge_with_native_filter(self):
         document_store = QdrantDocumentStore(location=":memory:", index="test")
         retriever = QdrantSparseEmbeddingRetriever(