安装使用 Elasticsearch

    首先给大家介绍一下如何安装和使用 Elasticsearch。

    首先,当然是 Elasticsearch 的下载,我们打开 Elastic 的官方网站:https://www.elastic.co/,如下图:

    点击右侧下载按钮,即可前往下载页面,选择 Elasticsearch 产品,如下图:

    我们可以看到 Elasticsearch 详细下载页面,当前显示最新的版本是 6.2.4,发布时间是 2018 年 4 月 17,有多个安装包类型可以选择,我们点击选择 ZIP 包的下载链接,浏览器即自动开始下载,如下图:

    因为 Elasticsearch 是基于 Java 运行时平台,所以还需要安装 JDK 8 以上版本环境,我们可以安装最新的版本,如:JDK10。关于 Java 环境的安装,这里就不做详细说明,大家可以自行前往下载安装。

    下载得到的是一个只有 29.1MB 大小的压缩包,压缩包内结构,如下图:

    我们来依次看一下他们都分别代表什么意思:

    bin 目录下面存放是一系列可执行程序,同名 .bat 后缀是用于 Windows 平台的可执行脚本:

    • elasticsearch,Elasticsearch 的启动进程,Elasticsearch 程序的主入口。
    • elasticsearch-env,用于环境变量的配置,可以在这里修改相关的环境配置,大部分情况不建议直接修改此配置文件,可以通过在外部通过变量名来进行设置。
    • elasticsearch-translog,主要用于对 Translog 进行清理操作。
    • elasticsearch-keystore,主要用于管理 Elasticsearch 的密钥。
    • elasticsearch-plugin,插件安装工具。
    • elasticsearch-service* 开头的几个程序是为 Windows 平台提供的服务管理工具。

    config 目录,主要是存放一下配置文件信息:

    • elasticsearch.yml,Elasticsearch 的配置文件,使用 Yaml 文件格式作为标准。
    • jvm.options,Java 虚拟机运行环境的相关参数配置。
    • log4j2.properties,日志文件相关的配置。

    lib 目录是 Elasticsearch 依赖的 Jar 包和自己的 Java 本身程序所在的地方。

    data 目录,数据默认存放的位置。

    logs 目录,日志默认存放的位置。

    modules 目录,存放 Elasticsearch 的内部功能模块。

    plugins 目录,存放 Elasticsearch 的外部扩展插件。

    然后,我们开始运行 Elasticsearch 程序。进入终端控制台,CD 切换到解压文件所在目录,注意目录名不要包含中文和空格。运行 Elasticsearch 主程序,如下图所示:(注:这里演示环境为 MacOS,后续如不加特别说明都以此作为演示环境)

    看到控制台输出了若干启动信息,可以看到有启动程序的环境变量,加载的模块和插件名称清单,当前监听了 92009300 端口,并且不再有新的日志输出,这个时候说明 Elasticsearch 已经启动完毕了,我们可以进一步验证 Elasticsearch 服务器是否正常。

    9200 端口是 Elasticsearch 默认监听的 RESTful 端口,属于 Http 协议,我们可以直接用浏览器访问:http://localhost:9200/ 来验证一下,如下图所示:

    可以看到,接口返回了一个 JSON 格式的消息,里面显示的是这个 Elasticsearch 集群(单个节点的集群)的基本信息,集群名称为 elasticsearch,Elasticsearch 的版本为 6.2.4 和底层 Lucene 的版本为 7.2.1

    到这里,我们一个最简单的 Elasticsearch 节点或者叫单实例集群就已经成功安装成功并启动了,下一步就是具体进行数据的操作了。

    我们先构建一个索引请求,使用 curl 来执行一个 Http Post 请求:

    curl -XPOST -H 'Content-Type: application/json'   http://localhost:9200/index/doc/1?pretty -d'{"name":"medcl"}'
    

    我们来分析一下这个 URL 请求:http://localhost:9200/index/doc/1http://localhost:9200/ 是 Elasticsearch 的访问地址,Http 协议,本机地址,端口是 9200,这个很好理解。

    /index/doc/1 可以理解为这个文档的路径,相当于是这个索引文档的唯一标识,由以下几部分组成:

    • index ,索引名称,是这个文档存放的索引数据库名称。
    • doc ,类型名称,是一个固定的类型,7.0 版本后会移除,暂时不用管它是干嘛的,我们可以忽略它的存在。
    • 1 ,文档 ID,是这个文档的在这个 Elasticsearch 数据库里面的唯一标识,可以对应理解为数据库里面的主键。

    在同一个index里面,为了保持唯一性,只能存在一个 ID 为 1doc,相同路径的新进来的数据会覆盖之前添加的数据。

    {"name":"medcl"} 是Http 请求的 Body 参数,是一个标准的 JSON 文档,里面有一个字段名为 name,这个字段的值为 medcl

    ?pretty 参数表示对请求的返回结果进行输出格式化,主要是为了让请求返回的 JSON 数据看起来更加清晰直观。

    在终端下执行命令,如下图:

    上面的信息说明 Elasticsearch 的 API 能够正常访问,并成功创建了一条索引数据。返回结果里面也返回了相应的元数据信息,我们来分别解读一下:

    • _index,索引名,值为 index,和索引操作的 URL 包含的数据一致,注意下划线开头的表示系统的元数据,也就是内置的属性。
    • _type,类型名,我们可以忽略它。
    • _id,唯一标识。
    • _version,是这个文档的版本,每对这个文档修改一次,版本号自增一次。
    • result,表示服务器操作的返回结果,用来表明该操作是是创建还是更新。
    • _seq_no 等其它属性,我们暂时不用关心。

    刚刚我们提交了一个索引数据,我们怎么验证是否真的写成功了呢?我们可以拿回来看一下,也就是取回我们刚刚添加的这个索引文档,我们只需要把刚刚的 HTTP 请求里面的 POST 谓词换成 GET 就可以了。

    curl -XGET -H 'Content-Type: application/json'   http://localhost:9200/index/doc/1?pretty'
    

    如图所示,该请求执行成功,并返回了一个 JSON 文档,里面包含了以下信息,我们来分别解读一下:

    • _index_type_id_version 同索引创建的返回值说明,不赘述。
    • _found,如果这个文档不存在或者已删除,这个返回的值是 false
    • _source,就是我们写入文档时候的原始数据,此处可以看到和我们之前提交的数据一致。

    至此,我们安装并验证了 Elasticsearch 的服务,读者可以自行参照学习,后面将进一步介绍。