文档

通过Search Shell连接并使用搜索引擎

更新时间:

Search Shell是云原生多模数据库 Lindorm自带的数据库管理工具,您可以在本地或ECS上安装Search Shell工具,然后通过Search Shell连接Lindorm实例。本文介绍在ECS上通过Search Shell连接Lindorm的方法。

前提条件

  • 已安装Java环境,建议安装JDK 1.8及以上版本。

  • 已开通Lindorm搜索引擎。如何开通,请参见开通指南

  • 已将客户端的IP地址添加至Lindorm白名单。如何添加,请参见设置白名单

注意事项

Lindorm单节点实例不支持本文操作。如果您的实例类型为Lindorm单节点,请通过SQL连接并使用搜索引擎,具体操作,请参见通过SQL连接并使用搜索引擎

操作步骤

执行下述操作前,请先切换至非Root的用户。

  1. 安装Search Shell(如已安装,可跳过)。

    1. 登录ECS实例,执行下述命令下载Search Shell工具。

      wget https://hbaseuepublic.oss-cn-beijing.aliyuncs.com/lindorm-search-cli.tar.gz
    2. 执行下述命令解压Search Shell工具。

      tar -xzvf lindorm-search-cli.tar.gz
  2. bin/search.in.sh文件中的ZK_HOST地址修改为Lindorm搜索引擎的Solr兼容地址。如何获取地址,请参见查看连接地址

    ZK_HOST="host:port"   //host:port修改为Lindorm搜索引擎的Solr兼容地址

Search Shell访问示例代码

执行下述命令进入lindorm-search-cli/bin目录。

cd lindorm-search-cli/bin

执行以下代码查看帮助命令。

./search-cli       

使用示例。

  • 执行以下代码创建索引表。

    ./search-cli create_collection -c testIndex -n _indexer_default -shards 2            
    说明

    索引名为testIndex,使用默认配置集_indexer_default,分片数设置为2

  • 执行以下代码查看索引表。

    ./search-cli list_collections                
  • 执行以下代码下载配置集。

    ./search-cli zk downconfig -d . -n _indexer_default                
    说明

    _indexer_default是Search Shell工具提供的默认配置集,执行上述命令后,bin目录会自动创建一个名称为conf的子文件夹,子文件夹存储的是_indexer_default的配置集合。

  • 上传配置集。

    ./search-cli zk upconfig -d conf -n myConf                  
    说明

    可以将配置集修改为自定义的配置集名,如myConf

  • 查看配置集。

    ./search-cli zk ls /configs                   
  • 创建基于自定义配置集的索引表。

    ./search-cli create_collection -c myIndex -n myConf -shards 2