快速入门

前置条件

1. 成功注册阿里云账号并通过实名认证。

2. 开通阿里云账号并登录控制台时，会提示先创建access key才能继续使用。

• 创建及使用应用依赖access key参数，主账号下access key参数不能为空。

• 在为主账号创建access key参数后，还可以再创建RAM子账号access key通过RAM子账号进行访问，RAM子账号赋予对应访问权限，请参考授权访问鉴权规则。

3. 需要用户拥有VPC环境，详情可点击此处进行查看。

购买实例

1. 进入OpenSearch控制台，在左上角切换到OpenSearch-召回引擎版。

2. 进入召回引擎版控制台后，在实例管理界面，点击创建实例。

3. 商品版本选择召回引擎版，选择地区，配置“查询节点个数”、“查询节点规格”、“数据节点数量”、“数据节点规格”、“单数据节点总存储空间”，设置“专有网络”和“虚拟交换机”，最后按提示要求设置用户名和用户密码（用于查询时校验权限，非阿里云账号密码），点击”立即购买”。

4. 在确认订单界面，查看服务协议，确认无误后，点击立即开通。

5. 购买成功后，点击管理控制台，即可在实例管理界面查看已购买的召回引擎版实例。

6. 新购的实例会设置一个默认实例名称，可在操作栏下点击管理按钮，进入详情页进行修改。

点击修改图标，按提示框要求修改实例名称最后点击确认。

配置集群

新购买的实例，在其详情页中，实例状态为“待配置”，并且会自动部署一个与购买的查询节点和数据节点的个数及规格一致的空集群，之后需要为该集群配置数据源--->配置索引--->索引重建，之后才可正常搜索。

1. 配置数据源（目前支持的数据源有“MaxCompute数据源”和“API推送数据源”）这里以MaxCompute数据源为例：点击“添加数据源”，数据源类型选择“MaxCompute”，设置project、accesskeyID、accesskeyId、accesskeySecret、Table、分组键partition，可按需选择是否开启“”。

校验成功之后，点击“确定”，完成数据源的添加。

2. 数据源配置成功后，需点击下一步配置索引结构：

2.1. 添加索引表：在索引结构页面中，单击添加索引表按钮。

2.2. 配置索引表：

• 索引表：可自定义

• 数据源：选择 1 中配置的数据源

• 数据分片：根据用户购买的数据节点个数进行配置

2.3. 字段设置：

字段设置表格中包含字段名称、字段类型、主键、属性、属性压缩、摘要压缩、摘要区间、分析方式和高级配置列，可按需配置各字段属性。

属性和字段内容压缩：

• 属性字段可以选择是否压缩，默认为不压缩，选择file_compressor表示开启压缩

• 字段内容可以选择是否压缩，默认为不压缩，默认多值和STRING类型选择uniq，单值数值类型是equal

2.4. 索引设置：

索引设置表格中包含索引名称、索引类型、包含字段、数据压缩、高级配置和操作列，可查看和修改各索引配置。

• 索引字段可以选择是否压缩，默认为不压缩，选择file_compressor表示开启压缩

4. 配置完成后，点击保存版本，并在弹框后填写备注（可选），点击发布。

等待索引发布完成后，可点击“下一步”进行索引重建。

5. 索引重建，选择索引重建需要配置的参数项，点击“下一步”。

• API推送数据源：

选择数据源名称和关联索引表，确认数据源类型为API推送数据源，然后单击下一步。

• MaxCompute数据源：

选择数据源名称和关联索引表，确认数据源类型为MaxCompute，配置数据分区和时间戳参数，然后单击下一步。

查看索引重建进度

数据源及索引结构配置完成后，可在运维中心>部署管理中查看集群拓扑：

拓扑图展示了查询接入、集群（含数据节点和查询节点）、索引表和数据源之间的层级关系。

更新配置之后，可在运维中心>变更历史>数据源变更处查看索引重建进度：

索引重建流程包含 init、trigger、scan、build 和 switch 五个阶段，各阶段完成后会显示绿色对勾标记。

并且在实例详情页中，也可查看集群的查询节点和数据节点的状态，状态均为正常后，即可进行查询测试：

查询节点显示服务状态（服务中）和配置状态（配置已更新）；数据节点额外显示数据状态（数据已更新），三项状态均为 100% 即表示正常。

查询测试

可在功能扩展>查询测试中进行简单的搜索测试，召回引擎版支持的查询方式有HA3子句和SQL子句两种：

选择查询方式（如SQL子句），在输入框中输入查询语句（例如 select * from index_a），单击搜索即可查看查询结果，结果中包含耗时（USE_TIME）和命中条数（ROW_COUNT）等信息。

注意事项