Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用 Amazon S3 矢量引擎实现高级搜索功能

亚马逊 OpenSearch 服务允许将 Amazon S3 用作向量索引的矢量引擎。此功能可将向量数据卸载至 Amazon S3，同时以低成本维持亚秒级的向量搜索功能。

使用此功能，可以将矢量嵌入 OpenSearch 存储在 Amazon S3 矢量索引中，同时将其他文档字段保留在 OpenSearch 集群的存储中。此架构具有以下优势：

OpenSearch 使用 S3 向量索引有以下要求：

启用 S3 Vectors

创建新域或更新现有域时，可在高级功能部分中选择启用 S3 Vectors 作为引擎选项。当您使用 S3 OpenSearch 向量作为引擎时，此设置允许创建 S3 矢量存储桶。启用此选项后， OpenSearch 请通过以下方式为您的域配置 S3 向量：

使用 S3 向量引擎创建索引

配置域后，可在索引映射中使用 s3vector 作为后端向量引擎，创建一个或多个包含字段的 k-NN 索引。您可以根据具体使用案例，配置不同引擎类型的向量字段。

以下是创建 S3 向量引擎索引的一些示例。

示例：使用 S3 向量引擎创建 k-NN 索引

PUT my-first-s3vector-index
{
  "settings": {
    "index": {
      "knn": true
    }
  },
  "mappings": {
    "properties": {
        "my_vector_1": {
          "type": "knn_vector",
          "dimension": 2,
          "space_type": "l2",
          "method": {
            "engine": "s3vector"
          }
        },
        "price": {
          "type": "float"
        }
    }
  }
}

示例：同时使用 S3 向量和 FAISS 引擎创建 k-NN 索引

此示例强调可在同一个索引中使用多个向量引擎这一事实。

PUT my-vector-index
{
  "settings": {
    "index": {
      "knn": true
    }
  },
  "mappings": {
    "properties": {
        "my_vector_1": {
          "type": "knn_vector",
          "dimension": 2,
          "space_type": "l2",
          "method": {
            "engine": "s3vector"
          }
        },
        "price": {
          "type": "float"
        },
        "my_vector_2": {
            "type": "knn_vector",
            "dimension": 2,
            "space_type": "cosine",
            "method": {
                "name": "hnsw",
                "engine": "faiss",
                "parameters": {
                    "ef_construction": 128,
                    "m": 24
                }
            }
        }
    }
  }
}

不支持的示例：创建索引后添加 S3 向量引擎

以下方法不受支持且会失败。

PUT my-first-s3vector-index
{
  "settings": {
    "index": {
      "knn": true
    }
  }
}

PUT my-first-s3vector-index/_mapping
{
  "properties": {
        "my_vector_1": {
          "type": "knn_vector",
          "dimension": 2,
          "space_type": "l2",
          "method": {
            "engine": "s3vector"
          }
        },
        "price": {
          "type": "float"
        }
    }
}

功能限制

在索引中使用 s3vector 引擎之前，请考虑以下限制：

索引文档

使用 S3 矢量引擎创建索引后，您可以使用标准 _bulk API 提取文档。 OpenSearch 使用s3vector引擎自动将knn_vector字段的矢量数据实时卸载到 S3 向量索引。属于其他字段或使用不同引擎的knn_vector字段的数据将由 OpenSearch 其自己的存储层保存。

对于所有已确认的批量请求， OpenSearch 保证所有数据（向量和非矢量）都是持久的。如果请求收到否定确认，则无法保证该批量请求中文档的持久性。最好在删除之前失败的请求之后，使用文档 ID 重试此类请求，以避免在极少数情况下重复文档。

批量索引示例

POST _bulk
{ "index": { "_index": "my-first-s3vector-index", "_id": "1" } }
{ "my_vector_1": [1.5, 2.5], "price": 12.2 }
{ "index": { "_index": "my-first-s3vector-index", "_id": "2" } }
{ "my_vector_1": [2.5, 3.5], "price": 7.1 }
{ "index": { "_index": "my-first-s3vector-index", "_id": "3" } }
{ "my_vector_1": [3.5, 4.5], "price": 12.9 }
{ "index": { "_index": "my-first-s3vector-index", "_id": "4" } }
{ "my_vector_1": [5.5, 6.5], "price": 1.2 }
{ "index": { "_index": "my-first-s3vector-index", "_id": "5" } }
{ "my_vector_1": [4.5, 5.5], "price": 3.7 }

搜索文档

您可以使用标准 _search API 搜索索引，以执行文本、k-NN 或混合查询。对于配置了s3vector引擎的knn_vector字段的查询， OpenSearch 会自动将查询卸载到相应的 S3 向量索引。

搜索查询示例

GET my-first-s3vector-index/_search
{
  "size": 2,
  "query": {
    "knn": {
      "my_vector_1": {
        "vector": [2.5, 3.5],
        "k": 2
      }
    }
  }
}

你可以使用 s3vector 引擎对 OpenSearch kNN 索引运行经过筛选的矢量搜索。 OpenSearch 应用过滤器作为后置过滤器，并使用基于某些启发式方法的过采样机制来平衡召回和延迟。

带过滤器的搜索查询示例：

GET my-index/_search
{
  "size": 10,
  "query": {
    "knn": {
      "my_vector_field": {
        "vector": [2.5, 3.5, 1.2, 4.8],
        "k": 10,
        "filter": {
          "range": {
            "price": {
              "gte": 10,
              "lte": 100
            }
          }
        }
      }
    }
  }
}

支持的映射参数

使用 s3vector 引擎时，knn_vector 字段在映射中支持以下参数。

计量和计费

有关此功能的计量和账单的信息，请参阅 Amazon OpenSearch 服务定价。

禁用 s3vector 引擎

禁用 s3vector 引擎之前，删除当前正在使用该引擎的所有索引。否则，任何禁用引擎的尝试都会失败。

另请注意，启用或禁用 s3vector 引擎会触发域上的蓝绿部署。

要禁用 s3vector 引擎，请编辑域配置，并设置 S3VectorsEngine.Enabled: false。