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

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

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

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

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

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

启用 S3 向量

创建新域或更新现有域时，您可以在 “高级功能” 部分中选择 “启用 S3 向量” 作为引擎选项。当您使用 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 保证所有数据（向量和非矢量）都是持久的。如果请求收到否定确认，则无法保证该批量请求中文档的持久性。您应该重试此类请求。

批量索引示例

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 engine 时，该knn_vector字段支持映射中的以下参数。

计量和计费

在宣布计量之前，此功能不会计费。

禁用 s3vector 引擎

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

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

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