Qdrant

Official n8n node to interface with Qdrant - https://qdrant.tech

Actions26

Collection Actions
Payload Actions
Point Actions
Search Actions
Vector Actions
- Update Vectors
- Delete Vectors

Overview

The node provides an interface to interact with Qdrant, a vector search engine and database. Specifically, the Scroll Points operation under the Point resource allows users to retrieve points (data entries) from a specified collection in a paginated or incremental manner. This is useful for scenarios where you want to process or analyze large datasets stored in Qdrant without loading all data at once.

Typical use cases include:

Incrementally fetching points from a collection for batch processing.
Exporting subsets of points based on filters or ordering.
Implementing custom pagination or scrolling through large collections.
Retrieving points with optional payloads and vectors for further analysis or machine learning workflows.

Properties

Name	Meaning
Collection Name	The target collection from which to scroll points. Can be selected from a list of existing collections or specified by name.
Limit	Maximum number of points to return in one request. Must be at least 1. Controls the page size of the scroll operation.
Filter	JSON object specifying conditions that points must satisfy to be included in the results. Allows filtering points based on payload fields or other criteria.
With Payload	Boolean flag indicating whether to include the payload data of each point in the response. Payload typically contains metadata or additional information associated with the point.
With Vector	Boolean flag indicating whether to include the vector embeddings of each point in the response. Useful when vector data is needed for downstream tasks like similarity calculations.
Offset	String ID indicating the starting point for reading points. Enables resuming scrolling from a specific point ID.
Order By	JSON object defining how to order the returned points based on a payload field. Supports sorting results by specific criteria.
Shard Key	JSON object specifying which shards to query for points. If not set, the operation searches across all shards. Useful for distributed or sharded collections.
Consistency	Defines read consistency guarantees for the operation. Options are: Majority, Quorum, or All, controlling how many replicas must respond before returning data.
Timeout	Overrides the global timeout for this request in seconds. Controls how long the node waits for the Qdrant API response before aborting. Default is 100 seconds.

Output

The output consists of JSON objects representing the points retrieved from the specified collection. Each point includes:

An identifier (ID).
Optionally, the payload data if With Payload is true.
Optionally, the vector embedding if With Vector is true.

This structure allows downstream nodes or workflows to access detailed point data for analysis, transformation, or further querying.

If binary data were involved (not indicated here), it would typically represent raw vector bytes or serialized payloads, but this node focuses on JSON data.

Dependencies

Requires connection to a Qdrant instance via its REST API.
Needs an API key or authentication token configured in n8n credentials to authorize requests.
The base URL of the Qdrant service must be provided in the credential configuration.
No additional external dependencies beyond the Qdrant REST API.

Troubleshooting

Timeouts: If the node times out, consider increasing the Timeout property or checking network connectivity to the Qdrant server.
Invalid Collection Name: Ensure the collection name exists and is correctly spelled; otherwise, the API will return errors.
Filter Syntax Errors: The Filter property expects valid JSON; malformed JSON will cause parsing errors.
Empty Results: If no points are returned, verify filter conditions, offset, and shard key settings.
Consistency Issues: Using stricter consistency levels (e.g., "All") may increase latency or cause failures if replicas are unavailable.
Authentication Failures: Confirm that the API key or authentication token is valid and has sufficient permissions.