1.準(zhǔn)備實(shí)例ID

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

2.準(zhǔn)備索引表

實(shí)例創(chuàng)建成功后，會(huì)進(jìn)入待配置狀態(tài)。您需要為該實(shí)例配置表基礎(chǔ)信息>數(shù)據(jù)同步>字段配置>索引結(jié)構(gòu)，之后等待索引重建完成即可正常搜索。具體操作步驟如下：

1. 單擊待配置實(shí)例操作列下的配置。

2. 進(jìn)行表基礎(chǔ)信息配置，參數(shù)配置完成后，單擊下一步。

   其中關(guān)鍵參數(shù)說明如下，其他參數(shù)配置說明，請(qǐng)參見通用版快速入門。

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

   • 數(shù)據(jù)分片數(shù)：如果您購買了查詢節(jié)點(diǎn)，則在分片數(shù)設(shè)置時(shí)，可配置為不超過256的正整數(shù)， 用于提升全量構(gòu)建速度、單次查詢性能。如果未購買查詢節(jié)點(diǎn)，則數(shù)據(jù)分片數(shù)只能配置為1。

   • 數(shù)據(jù)更新資源數(shù)：數(shù)據(jù)更新所用資源數(shù)，每個(gè)索引默認(rèn)免費(fèi)提供2個(gè)4核8G的更新資源，超出免費(fèi)額度的資源將產(chǎn)生費(fèi)用，詳情可參考向量檢索版計(jì)費(fèi)概述

   • 場(chǎng)景模板：選擇通用模板。

3. 進(jìn)行數(shù)據(jù)同步配置，參數(shù)配置完成后，單擊下一步。

   其中全量數(shù)據(jù)來源支持三種數(shù)據(jù)源方式，您可以根據(jù)具體業(yè)務(wù)情況進(jìn)行選擇：

   • MaxCompute+API：使用MaxCompute進(jìn)行數(shù)據(jù)全量寫入，實(shí)時(shí)數(shù)據(jù)通過API寫入。使用該方式時(shí)，具體參數(shù)配置說明，請(qǐng)參見MaxCompute + API 數(shù)據(jù)源。

   • 對(duì)象存儲(chǔ)OSS+API：使用OSS進(jìn)行數(shù)據(jù)全量寫入，實(shí)時(shí)數(shù)據(jù)通過API寫入。使用該方式時(shí)，具體參數(shù)配置說明，請(qǐng)參見OSS + API 數(shù)據(jù)源。

   • API：全量與實(shí)時(shí)數(shù)據(jù)均通過API寫入。

4. 進(jìn)行字段配置，參數(shù)配置完成后，單擊下一步。

   將以下字段配置文件示例內(nèi)容保存為JSON文件，然后單擊右上角的導(dǎo)入字段索引結(jié)構(gòu)，并按控制臺(tái)操作指引導(dǎo)入索引文件。導(dǎo)入后，將基于文件內(nèi)容填寫字段配置和索引結(jié)構(gòu)。

   字段配置文件

   {
   	"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. 進(jìn)行索引結(jié)構(gòu)配置，參數(shù)配置完成后，單擊下一步。

   其中關(guān)鍵配置說明如下，其他參數(shù)配置說明，請(qǐng)參見向量索引通用配置。

   • 向量維度：設(shè)置為512。

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

6. 在確認(rèn)創(chuàng)建配置向?qū)ы撁妫瑔螕?b data-tag="uicontrol" id="720476a2f4kqv" class="uicontrol">確認(rèn)創(chuàng)建。

   系統(tǒng)將自動(dòng)跳轉(zhuǎn)至表管理頁面，當(dāng)狀態(tài)為使用中時(shí)，表明索引表創(chuàng)建成功。

3.為OpenSearch向量檢索版實(shí)例開通公網(wǎng)訪問功能

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

1. 為后續(xù)部署RAG服務(wù)時(shí)綁定的專有網(wǎng)絡(luò)（VPC）配置公網(wǎng)訪問功能。具體操作，請(qǐng)參見使用公網(wǎng)NAT網(wǎng)關(guān)SNAT功能訪問互聯(lián)網(wǎng)。

2. 查看已綁定的彈性公網(wǎng)IP地址。

   1. 登錄專有網(wǎng)絡(luò)管理控制臺(tái)。單擊專有網(wǎng)絡(luò)實(shí)例ID，并切換到資源管理頁簽。

   2. 單擊已綁定的公網(wǎng)NAT網(wǎng)關(guān)，進(jìn)入公網(wǎng)NAT網(wǎng)關(guān)頁面。

   3. 單擊公網(wǎng)NAT網(wǎng)關(guān)實(shí)例ID，進(jìn)入基本信息頁面。

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

3. 在OpenSearch向量檢索版實(shí)例列表頁面，單擊目標(biāo)實(shí)例名稱，進(jìn)入實(shí)例詳情頁面。

4. 在網(wǎng)絡(luò)信息區(qū)域，打開公網(wǎng)訪問開關(guān)，并在修改公網(wǎng)訪問白名單配置面板中，按照控制臺(tái)操作指引，將上述步驟已查詢的彈性公網(wǎng)IP配置為公網(wǎng)訪問白名單。

5. 在網(wǎng)絡(luò)信息區(qū)域，將公網(wǎng)域名后的訪問地址保存到本地。

4.查看實(shí)例用戶名和密碼

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

索引表管理

1. 進(jìn)入阿里云OpenSearch向量檢索版實(shí)例詳情頁面。

   1. 登錄阿里云OpenSearch向量檢索版控制臺(tái)。

   2. 單擊已創(chuàng)建的實(shí)例ID，進(jìn)入實(shí)例詳情頁面。

2. 進(jìn)入表管理頁面，對(duì)索引表進(jìn)行管理操作。

   1. 在左側(cè)導(dǎo)航欄，單擊表管理。

      頁面中展示當(dāng)前實(shí)例下創(chuàng)建的所有表。

   2. 在表管理頁面，對(duì)索引表進(jìn)行管理操作，包括查看字段及索引結(jié)構(gòu)、編輯索引、索引重建以及刪除索引等。具體操作細(xì)節(jié)，請(qǐng)參見表管理。

數(shù)據(jù)管理

1. 進(jìn)入阿里云OpenSearch向量檢索版實(shí)例詳情頁面。

   1. 登錄阿里云OpenSearch向量檢索版控制臺(tái)。

   2. 單擊已創(chuàng)建的實(shí)例ID，進(jìn)入實(shí)例詳情頁面。

2. 添加數(shù)據(jù)。

   1. 在左側(cè)導(dǎo)航欄，單擊向量管理 > 添加數(shù)據(jù) 。

   2. 在頁面右側(cè)下拉列表中，選擇表單模式或開發(fā)者模式。

   3. 選擇要添加數(shù)據(jù)的目標(biāo)索引表（Table）名稱。

   4. 按字段輸入數(shù)據(jù)內(nèi)容或填寫數(shù)據(jù)寫入語句，然后單擊添加。具體操作請(qǐng)參見：添加數(shù)據(jù)。

      當(dāng)執(zhí)行結(jié)果出現(xiàn)"message": "success"時(shí)，表示數(shù)據(jù)上傳成功，即可完成單條數(shù)據(jù)或多條數(shù)據(jù)的添加。

3. 查看表指標(biāo)數(shù)據(jù)。

   1. 在左側(cè)導(dǎo)航欄，單擊指標(biāo)監(jiān)控 > 表指標(biāo) 。

   2. 選擇要查看數(shù)據(jù)的目標(biāo)索引表（Table）名稱，即可查看索引內(nèi)文檔個(gè)數(shù)、每秒請(qǐng)求成功次數(shù)等指標(biāo)。詳情請(qǐng)參見表指標(biāo)。

4. 刪除數(shù)據(jù)。

   1. 在左側(cè)導(dǎo)航欄，選擇向量管理 > 刪除數(shù)據(jù)。

   2. 在頁面右側(cè)下拉列表中，選擇表單模式或開發(fā)者模式。

   3. 選擇表名并輸入主鍵，然后單擊刪除。具體操作請(qǐng)參見：刪除數(shù)據(jù)。

      當(dāng)執(zhí)行結(jié)果出現(xiàn)"message": "success"時(shí)，表示數(shù)據(jù)刪除成功。