elasticsearch-sql安装使用文档.docx

一、插件安装 由于 ES 2.x 和 5.x 的版本区别(详细参考：版本选择)，我们安装 ES 插件是有点区别的， 在 5.0之前的安装方式为：plugin install ./bin/plugin install https://github.com/NLPchina/elasticsearch-sql/releases/download/2.4.6.0/elasticsearch-sql-2.4.6.0.zip 在5.0之后(包括6.x)的安装方式为：elasticsearch-plugin install ./bin/elasticsearch-plugin install https://github.com/NLPchina/elasticsearch-sql/releases/download/5.0.1/elasticsearch-sql-5.0.1.0.zip 如果我们安装不成功，我们可以直接下载 Elasticsearch-SQL 插件的压缩包，然后解压，完成之后重命名文件夹为 sql ，放到 ES 的安装路径的 plugins目录中，例如：..\elasticsearch-6.4.0\plugins\sql。 【Elasticsearch-SQL安装与使用详解】 Elasticsearch（简称ES）是一个强大的分布式全文搜索引擎，而Elasticsearch-SQL插件则使得我们能够通过熟悉的SQL语法来查询ES中的数据，极大地降低了使用门槛，尤其对熟悉关系型数据库的开发者而言。下面我们将详细探讨如何安装和使用Elasticsearch-SQL。 ### 一、插件安装 1. **不同版本的安装方法** ES在2.x和5.x版本之间存在较大的差异，因此安装插件的方式也有所不同。 - 对于ES 5.0之前的版本（包括2.x），使用以下命令安装： ```bash plugin install ./bin/plugin install https://github.com/NLPchina/elasticsearch-sql/releases/download/2.4.6.0/elasticsearch-sql-2.4.6.0.zip ``` - 而对于ES 5.0及更高版本（包括6.x），应使用： ```bash elasticsearch-plugin install ./bin/elasticsearch-plugin install https://github.com/NLPchina/elasticsearch-sql/releases/download/5.0.1/elasticsearch-sql-5.0.1.0.zip ``` 2. **手动安装** 若上述命令安装失败，可以下载Elasticsearch-SQL插件的zip压缩包，解压后将文件夹重命名为`sql`，并将其放置于ES安装目录的`plugins`子目录下，例如：`\elasticsearch-6.4.0\plugins\sql`。安装完毕后，请务必重启Elasticsearch服务，否则可能会收到“Invalid index name [sql], must not start with '_'”的错误。 ### 二、前端可视化界面 Elasticsearch-SQL插件提供了一个直观的Web界面，允许用户通过GUI执行SQL查询。对于不同的ES版本，访问方式如下： - 对于ES 1.x和2.x，直接访问：`http://localhost:9200/_plugin/sql` - 对于ES 5.x和6.x，安装过程相对复杂，需要安装Node.js和site-server，以及Node.js模块库express。具体步骤如下： 1. 安装Node.js，下载并解压，配置环境变量。 2. 下载并解压site-server，将express模块安装到site-server目录下。 3. 使用npm安装express模块，然后运行node-server.js启动Web服务。 4. 重启当前Elasticsearch节点服务。 5. 访问地址：`http://<部署前台服务器IP>:8080/?username=elastic&password=changeme&base_uri=http://<ESIP>:9200`。 注意，为了使Web界面正常工作，可能需要在ES的配置文件`elasticsearch.yml`中添加如下设置，以允许CORS跨域请求： ``` http.cors.enabled: true http.cors.allow-credentials: true http.cors.allow-origin: "/.*" http.cors.allow-headers: WWW-Authenticate,X-Requested-With,X-Auth-Token,Content-Type,Content-Length,Authorization ``` ### 三、查询语法 安装并配置好Elasticsearch-SQL后，你就可以开始使用SQL查询了。基本的查询格式如下： ```http http://localhost:9200/_sql?sql=select * from indexName limit 10 ``` #### 3.1 简单查询 一个简单的查询示例是： ```sql SELECT fields FROM indexName WHERE conditions ``` 这里，索引名`indexName`替代了传统SQL中的表名`tableName`，条件`conditions`用于过滤结果。 ### 总结 Elasticsearch-SQL插件为Elasticsearch添加了SQL查询支持，使其更加易于理解和使用。通过上述安装和配置步骤，你可以享受到SQL查询带来的便利性。同时，插件提供的前端界面进一步简化了查询操作，使得非专业人员也能快速上手。在实际应用中，结合Elasticsearch的强大搜索功能，SQL查询语法可以帮助你更高效地处理和分析海量数据。