Skip to content

Commit 69bcc97

Browse files
szabostevelcawl
andauthored
Adds recommendation about choosing project profile (#2734)
## Overview This PR adds guidance for selecting the appropriate project profile based on the use case. It outlines when to use the General Purpose (GP) profile versus the Vector Optimized (VO) profile. --------- Co-authored-by: lcawl <[email protected]>
1 parent 95e690f commit 69bcc97

File tree

3 files changed

+20
-1
lines changed

3 files changed

+20
-1
lines changed

solutions/search/vector/bring-own-vectors.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,8 @@ In this introduction to [vector search](/solutions/search/vector.md), you’ll s
2323

2424
To learn about role-based access control, check out [](/deploy-manage/users-roles/cluster-or-deployment-auth/user-roles.md).
2525

26+
To learn about {{es-serverless}} project profiles, refer to [](dense-vector.md#vector-profiles).
27+
2628
## Create a vector database
2729

2830
When you create vectors (or _vectorize_ your data), you convert complex content (text, images, audio, video) into multidimensional numeric representations. These vectors are stored in specialized data structures that enable efficient similarity search and fast kNN distance calculations.
@@ -43,7 +45,8 @@ Each document in our simple data set will have:
4345
* An embedding of that review: stored in a `review_vector` field, which is defined as a [`dense_vector`](elasticsearch://reference/elasticsearch/mapping-reference/dense-vector.md) data type.
4446

4547
:::{tip}
46-
The `dense_vector` type automatically uses `int8_hnsw` quantization by default to reduce the memory footprint when searching float vectors. Learn how to balance performance and accuracy in [Dense vector quantization](elasticsearch://reference/elasticsearch/mapping-reference/dense-vector.md#dense-vector-quantization).
48+
The `dense_vector` type automatically uses quantization by default to reduce the memory footprint when searching float vectors.
49+
Learn more about the default quantization strategy and balancing performance and accuracy in [Dense vector field type](elasticsearch://reference/elasticsearch/mapping-reference/dense-vector.md).
4750
:::
4851

4952
The following API request defines the `review_text` and `review_vector` fields:

solutions/search/vector/dense-vector.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,17 @@ To implement dense vector search in {{es}}, you need both an index configuration
3030
2. **Query the index with k-NN search**
3131
- Use the [`knn` query](knn.md) to retrieve results based on vector similarity
3232

33+
### General purpose and vector optimized projects [vector-profiles]
34+
```{applies_to}
35+
serverless:
36+
```
37+
38+
When you use the [API]({{cloud-serverless-apis}}operation/operation-createelasticsearchproject) to create an {{es-serverless}} project, you can choose between two profiles: `general_purpose` and `vector`.
39+
The general purpose profile is recommended for most search use cases, including full text search, sparse vectors, and dense vectors that use compression such as BBQ.
40+
The vector profile is recommended only when your use case is based on uncompressed dense vectors with high dimensionality.
41+
42+
For more information about how the profile affects virtual compute unit (VCU) allocation and costs, refer to [](/deploy-manage/cloud-organization/billing/elasticsearch-billing-dimensions.md).
43+
3344
## Better Binary Quantization (BBQ) [bbq]
3445

3546
Better Binary Quantization (BBQ) is an advanced vector quantization technique for `dense_vector` fields. It compresses embeddings into compact binary form, enabling faster similarity search and reducing memory usage. This improves both search relevance and cost efficiency, especially when used with HNSW (Hierarchical Navigable Small World).

solutions/search/vector/knn.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,11 @@ To run a kNN search in {{es}}:
4444
* `create`, `index`, or `write` to add data
4545
* `read` to search the index
4646

47+
:::{tip}
48+
The default type of {{es-serverless}} project is suitable for this use case unless you plan to use uncompressed dense vectors (`int4` or `int8` quantization strategies) with high dimensionality.
49+
Refer to [](dense-vector.md#vector-profiles).
50+
:::
51+
4752
## kNN search methods: approxiamte and exact kNN [knn-methods]
4853

4954
{{es}} supports two methods for kNN search:

0 commit comments

Comments
 (0)