1.準備實例ID

在實例列表頁面，查看OpenSearch向量檢索版的實例ID，并保存到本地。

2.準備索引表

實例創建成功后，會進入待配置狀態。您需要為該實例配置表基礎信息>數據同步>字段配置>索引結構，之后等待索引重建完成即可正常搜索。具體操作步驟如下：

1. 單擊待配置實例操作列下的配置。

2. 進行表基礎信息配置，參數配置完成后，單擊下一步。

   其中關鍵參數說明如下，其他參數配置說明，請參見通用版快速入門。

   • 表名稱：自定義索引表名稱。

   • 數據分片數：如果您購買了查詢節點，則在分片數設置時，可配置為不超過256的正整數， 用于提升全量構建速度、單次查詢性能。如果未購買查詢節點，則數據分片數只能配置為1。

   • 數據更新資源數：數據更新所用資源數，每個索引默認免費提供2個4核8G的更新資源，超出免費額度的資源將產生費用，詳情可參考向量檢索版計費概述

   • 場景模板：選擇通用模板。

3. 進行數據同步配置，參數配置完成后，單擊下一步。

   其中全量數據來源支持三種數據源方式，您可以根據具體業務情況進行選擇：

   • MaxCompute+API：使用MaxCompute進行數據全量寫入，實時數據通過API寫入。使用該方式時，具體參數配置說明，請參見MaxCompute + API 數據源。

   • 對象存儲OSS+API：使用OSS進行數據全量寫入，實時數據通過API寫入。使用該方式時，具體參數配置說明，請參見OSS + API 數據源。

   • API：全量與實時數據均通過API寫入。

4. 進行字段配置，參數配置完成后，單擊下一步。

   將以下字段配置文件示例內容保存為JSON文件，然后單擊右上角的導入字段索引結構，并按控制臺操作指引導入索引文件。導入后，將基于文件內容填寫字段配置和索引結構。

   字段配置文件

   {
   	"schema": {
   		"summarys": {
   			"parameter": {
   				"file_compressor": "zstd"
   			},
   			"summary_fields": [
   				"id",
   				"embedding",
   				"file_path",
   				"file_name",
   				"file_type",
   				"node_content",
   				"node_type",
   				"doc_id",
   				"text",
   				"source_type"
   			]
   		},
   		"file_compress": [
   			{
   				"name": "file_compressor",
   				"type": "zstd"
   			},
   			{
   				"name": "no_compressor",
   				"type": ""
   			}
   		],
   		"indexs": [
   			{
   				"index_fields": [
   					{
   						"boost": 1,
   						"field_name": "id"
   					},
   					{
   						"boost": 1,
   						"field_name": "embedding"
   					}
   				],
   				"indexer": "aitheta2_indexer",
   				"index_name": "embedding",
   				"parameters": {
   					"enable_rt_build": "true",
   					"min_scan_doc_cnt": "20000",
   					"vector_index_type": "Qc",
   					"major_order": "col",
   					"builder_name": "QcBuilder",
   					"distance_type": "SquaredEuclidean",
   					"embedding_delimiter": ",",
   					"enable_recall_report": "true",
   					"ignore_invalid_doc": "true",
   					"is_embedding_saved": "false",
   					"linear_build_threshold": "5000",
   					"dimension": "1536",
   					"rt_index_params": "{\"proxima.oswg.streamer.segment_size\":2048}",
   					"search_index_params": "{\"proxima.qc.searcher.scan_ratio\":0.01}",
   					"searcher_name": "QcSearcher",
   					"build_index_params": "{\"proxima.qc.builder.quantizer_class\":\"Int8QuantizerConverter\",\"proxima.qc.builder.quantize_by_centroid\":true,\"proxima.qc.builder.optimizer_class\":\"BruteForceBuilder\",\"proxima.qc.builder.thread_count\":10,\"proxima.qc.builder.optimizer_params\":{\"proxima.linear.builder.column_major_order\":true},\"proxima.qc.builder.store_original_features\":false,\"proxima.qc.builder.train_sample_count\":3000000,\"proxima.qc.builder.train_sample_ratio\":0.5}"
   				},
   				"index_type": "CUSTOMIZED"
   			},
   			{
   				"has_primary_key_attribute": true,
   				"index_fields": "id",
   				"is_primary_key_sorted": false,
   				"index_name": "id",
   				"index_type": "PRIMARYKEY64"
   			},
   			{
   				"index_fields": "file_path",
   				"index_name": "file_path",
   				"index_type": "STRING"
   			},
   			{
   				"index_fields": "file_name",
   				"index_name": "file_name",
   				"index_type": "STRING"
   			},
   			{
   				"index_fields": "file_type",
   				"index_name": "file_type",
   				"index_type": "STRING"
   			},
   			{
   				"index_fields": "node_content",
   				"index_name": "node_content",
   				"index_type": "STRING"
   			},
   			{
   				"index_fields": "node_type",
   				"index_name": "node_type",
   				"index_type": "STRING"
   			},
   			{
   				"index_fields": "doc_id",
   				"index_name": "doc_id",
   				"index_type": "STRING"
   			},
   			{
   				"index_fields": "text",
   				"index_name": "text",
   				"index_type": "STRING"
   			},
   			{
   				"index_fields": "source_type",
   				"index_name": "source_type",
   				"index_type": "STRING"
   			}
   		],
   		"attributes": [
   			{
   				"file_compress": "no_compressor",
   				"field_name": "id"
   			},
   			{
   				"file_compress": "no_compressor",
   				"field_name": "embedding"
   			},
   			{
   				"file_compress": "no_compressor",
   				"field_name": "file_path"
   			},
   			{
   				"file_compress": "no_compressor",
   				"field_name": "file_name"
   			},
   			{
   				"file_compress": "no_compressor",
   				"field_name": "file_type"
   			},
   			{
   				"file_compress": "no_compressor",
   				"field_name": "node_content"
   			},
   			{
   				"file_compress": "no_compressor",
   				"field_name": "node_type"
   			},
   			{
   				"file_compress": "no_compressor",
   				"field_name": "doc_id"
   			},
   			{
   				"file_compress": "no_compressor",
   				"field_name": "text"
   			},
   			{
   				"file_compress": "no_compressor",
   				"field_name": "source_type"
   			}
   		],
   		"fields": [
   			{
   				"compress_type": "uniq",
   				"field_type": "STRING",
   				"field_name": "id"
   			},
   			{
   				"user_defined_param": {
   					"multi_value_sep": ","
   				},
   				"multi_value": true,
   				"compress_type": "uniq",
   				"field_type": "FLOAT",
   				"field_name": "embedding"
   			},
   			{
   				"compress_type": "uniq",
   				"field_type": "STRING",
   				"field_name": "file_path"
   			},
   			{
   				"compress_type": "uniq",
   				"field_type": "STRING",
   				"field_name": "file_name"
   			},
   			{
   				"compress_type": "uniq",
   				"field_type": "STRING",
   				"field_name": "file_type"
   			},
   			{
   				"compress_type": "uniq",
   				"field_type": "STRING",
   				"field_name": "node_content"
   			},
   			{
   				"compress_type": "uniq",
   				"field_type": "STRING",
   				"field_name": "node_type"
   			},
   			{
   				"compress_type": "uniq",
   				"field_type": "STRING",
   				"field_name": "doc_id"
   			},
   			{
   				"compress_type": "uniq",
   				"field_type": "STRING",
   				"field_name": "text"
   			},
   			{
   				"compress_type": "uniq",
   				"field_type": "STRING",
   				"field_name": "source_type"
   			}
   		],
   		"table_name": "abc"
   	},
   	"extend": {
   		"description": [],
   		"vector": [
   			"embedding"
   		],
   		"embeding": []
   	}
   }

5. 進行索引結構配置，參數配置完成后，單擊下一步。

   其中關鍵配置說明如下，其他參數配置說明，請參見向量索引通用配置。

   • 向量維度：設置為512。

   • 距離類型：建議選擇InnerProduct。

6. 在確認創建配置向導頁面，單擊確認創建。

   系統將自動跳轉至表管理頁面，當狀態為使用中時，表明索引表創建成功。

3.為OpenSearch向量檢索版實例開通公網訪問功能

目前，EAS只能通過公網訪問OpenSearch，需要具備訪問公網的能力。因此，您需要為EAS添加VPC，并為該VPC綁定NAT網關和彈性公網IP（EIP）。同時，為確保OpenSearch實例能夠接收來自EAS實例的公網請求，您需要為OpenSearch開通公網訪問，并將上述EIP地址加入白名單。以下內容為您介紹如何為EAS的VPC配置公網訪問OpenSearch功能，EAS可以使用與OpenSearch相同的VPC，也可以使用其他VPC。

1. 為后續部署RAG服務時綁定的專有網絡（VPC）配置公網訪問功能。具體操作，請參見使用公網NAT網關SNAT功能訪問互聯網。

2. 查看已綁定的彈性公網IP地址。

   1. 登錄專有網絡管理控制臺。單擊專有網絡實例ID，并切換到資源管理頁簽。

   2. 單擊已綁定的公網NAT網關，進入公網NAT網關頁面。

   3. 單擊公網NAT網關實例ID，進入基本信息頁面。

   4. 單擊綁定的彈性公網IP，查看已綁定的彈性公網IP地址，并保存到本地。

3. 在OpenSearch向量檢索版實例列表頁面，單擊目標實例名稱，進入實例詳情頁面。

4. 在網絡信息區域，打開公網訪問開關，并在修改公網訪問白名單配置面板中，按照控制臺操作指引，將上述步驟已查詢的彈性公網IP配置為公網訪問白名單。

5. 在網絡信息區域，將公網域名后的訪問地址保存到本地。

4.查看實例用戶名和密碼

即在創建OpenSearch向量檢索版實例時，輸入的用戶名和密碼。您可以在實例詳情頁面的API入口區域查看。

索引表管理

1. 進入阿里云OpenSearch向量檢索版實例詳情頁面。

   1. 登錄阿里云OpenSearch向量檢索版控制臺。

   2. 單擊已創建的實例ID，進入實例詳情頁面。

2. 進入表管理頁面，對索引表進行管理操作。

   1. 在左側導航欄，單擊表管理。

      頁面中展示當前實例下創建的所有表。

   2. 在表管理頁面，對索引表進行管理操作，包括查看字段及索引結構、編輯索引、索引重建以及刪除索引等。具體操作細節，請參見表管理。

數據管理

1. 進入阿里云OpenSearch向量檢索版實例詳情頁面。

   1. 登錄阿里云OpenSearch向量檢索版控制臺。

   2. 單擊已創建的實例ID，進入實例詳情頁面。

2. 添加數據。

   1. 在左側導航欄，單擊向量管理 > 添加數據 。

   2. 在頁面右側下拉列表中，選擇表單模式或開發者模式。

   3. 選擇要添加數據的目標索引表（Table）名稱。

   4. 按字段輸入數據內容或填寫數據寫入語句，然后單擊添加。具體操作請參見：添加數據。

      當執行結果出現"message": "success"時，表示數據上傳成功，即可完成單條數據或多條數據的添加。

3. 查看表指標數據。

   1. 在左側導航欄，單擊指標監控 > 表指標 。

   2. 選擇要查看數據的目標索引表（Table）名稱，即可查看索引內文檔個數、每秒請求成功次數等指標。詳情請參見表指標。

4. 刪除數據。

   1. 在左側導航欄，選擇向量管理 > 刪除數據。

   2. 在頁面右側下拉列表中，選擇表單模式或開發者模式。

   3. 選擇表名并輸入主鍵，然后單擊刪除。具體操作請參見：刪除數據。

      當執行結果出現"message": "success"時，表示數據刪除成功。