Elasticsearch Reference
  • Introduction
  • 入门
    • 基本概念
    • 安装
    • 探索集群
      • 集群健康
      • 获取所有索引库
      • 创建一个索引库
      • 索引文档创建与查询
      • 删除索引
    • 修改数据
      • 更新文档
      • 删除文档
      • 批量处理
    • 探索您的数据
      • 搜索API
      • 查询语言介绍
      • 执行搜索
      • 执行过滤
      • 执行聚合
    • 总结
  • Elasticsearch设置
    • 安装Elasticsearch
      • .zip或.tar.gz文件的安装方式
      • Debian软件包安装方式
      • RPM安装方式
      • Windows安装方式
      • Docker安装方式
    • 配置Elasticsearch
    • 重要的Elasticsearch配置
    • 安全配置
    • 启动前检查
      • 堆大小检查
      • 文件描述符检查
      • 内存锁定检查
      • 最大线程数检查
      • 最大虚拟内存检查
      • 最大map数检查
      • JVM检查
      • 串行收集使用检查
      • 系统调用过滤检查
      • OnError与OnOutOfMemroyError检查
      • G1GC检查
    • 重要的系统配置
      • 系统设置
      • 在jvm.options中设置JVM堆大小
      • 禁用swapping
      • 文件描述符
      • 虚拟内存
      • 线程数
    • Elasticsearch升级
      • 滚动升级
      • 全集群重启升级
      • 索引重建升级
    • Elasticsearch停机
  • 重大变更
    • 5.3重大变更
    • 5.2重大变更
      • 删除Shadow副本
    • 5.1重大变更
    • 5.0重大变更
      • 搜索与查询DSL变化
      • Mapping变化
      • Percolator变化
      • Suggester变化
      • Index API变化
      • Document API变化
      • Settings变化
      • Allocation变化
      • HTTP变化
      • REST API变化
      • CAT API变化
      • JAVA API变化
      • 安装包
      • 插件变化
      • 文件系统相关变化
      • 磁盘数据文件路径
      • Aggregation变化
      • 脚本相关变化
  • API约定
    • 多索引语法
    • 索引库名称的日期运算
    • 常用选项
    • URL-based访问控制
  • 文档API
    • 读写文档
    • Index API
    • Get API
    • Delete API
    • Delete By Query API
    • Update API
    • Update By Query API
    • Multi Get API
    • Bulk API
    • Reindex API
    • Term Vectors
    • Multi termvectors API
    • refresh
  • 搜索API
    • Search
    • URI Search
    • Request Body Search
      • Query
      • From / Size
      • Sort
      • Source filtering
      • Fields
      • Script Fields
      • Doc value Fields
      • Post filter
      • Highlighting
      • Rescoring
      • Search Type
      • Scroll
      • Preference
      • Explain
      • Version
      • Index Boost
      • min_score
      • Named Queries
      • Inner hits
      • Field Collapsing
      • Search After
    • Search Template
    • Multi Search Template
    • Search Shards API
    • Suggesters
      • Term suggester
      • Phrase Suggester
      • Completion Suggester
      • Context Suggester
    • Multi Search API
    • Count API
    • Validate API
    • Explain API
    • Profile API
      • Profiling Queries
      • Profiling Aggregations
      • Profiling Considerations
    • Percolator
    • Field stats API
  • 聚合
    • Metrics Aggregations
      • Avg Aggregation
      • Cardinality Aggregation
      • Extended Stats Aggregation
      • Geo Bounds Aggregation
      • Geo Centroid Aggregation
      • Max Aggregation
      • Min Aggregation
      • Percentiles Aggregation
      • Percentile Ranks Aggregation
      • Scripted Metric Aggregation
      • Stats Aggregation
      • Sum Aggregation
      • Top hits Aggregation
      • Value Count Aggregation
    • Bucket Aggregations
      • Adjacency Matrix Aggregation
      • Children Aggregation
      • Date Histogram Aggregation
      • Date Range Aggregation
      • Diversified Sampler Aggregation
      • Filter Aggregation
      • Filters Aggregation
      • Geo Distance Aggregation
      • GeoHash grid Aggregation
      • Global Aggregation
      • Histogram Aggregation
      • IP Range Aggregation
      • Missing Aggregation
      • Nested Aggregation
      • Range Aggregation
      • Reverse nested Aggregation
      • Sampler Aggregation
      • Significant Terms Aggregation
      • Terms Aggregation
    • Pipeline Aggregations
      • Avg Bucket Aggregation
      • Derivative Aggregation
      • Max Bucket Aggregation
      • Min Bucket Aggregation
      • Sum Bucket Aggregation
      • Stats Bucket Aggregation
      • Extended Stats Bucket Aggregation
      • Percentiles Bucket Aggregation
      • Moving Average Aggregation
      • Cumulative Sum Aggregation
      • Bucket Script Aggregation
      • Bucket Selector Aggregation
      • Serial Differencing Aggregation
    • Matrix Aggregations
      • Matrix Stats
    • Caching heavy aggregations
    • Returning only aggregation results
    • Aggregation Metadata
  • 索引库API
    • Create Index
    • Delete Index
    • Get Index
    • Indices Exists
    • Open / Close Index API
    • Shrink Index
    • Rollover Index
    • Put Mapping
    • Get Mapping
    • Get Field Mapping
    • Types Exists
    • Index Aliases
    • Update Indices Settings
    • Get Settings
    • Analyze
      • Explain Analyze
    • Index Templates
    • Shadow replica indices
      • Node level settings related to shadow replicas
    • Indices Stats
    • Indices Segments
    • Indices Recovery
    • Indices Shard Stores
    • Clear Cache
    • Flush
      • Synced Flush
    • Refresh
    • Force Merge
  • cat API
    • cat aliases
    • cat allocation
    • cat count
    • cat fielddata
    • cat health
    • cat indices
    • cat master
    • cat nodeattrs
    • cat nodes
    • cat pending tasks
    • cat plugins
    • cat recovery
    • cat repositories
    • cat thread pool
    • cat shards
    • cat segments
    • cat snapshots
    • cat templates
  • 集群API
    • Cluster Health
    • Cluster State
    • Cluster Stats
    • Pending cluster tasks
    • Cluster Reroute
    • Cluster Update Settings
    • Nodes Stats
    • Nodes Info
    • Task Management API
    • Nodes hot_threads
    • Cluster Allocation Explain API
  • DSL查询
    • Query and filter context
    • Match All Query
    • Full text queries
      • Match Query
      • Match Phrase Query
      • Match Phrase Prefix Query
      • Multi Match Query
      • Common Terms Query
      • Query String Query
      • Simple Query String Query
    • Term level queries
      • Term Query
      • Terms Query
      • Range Query
      • Exists Query
      • Prefix Query
      • Wildcard Query
      • Regexp Query
      • Fuzzy Query
      • Type Query
      • Ids Query
    • Compound queries
      • Constant Score Query
      • Bool Query
      • Dis Max Query
      • Function Score Query
      • Boosting Query
      • Indices Query
    • Joining queries
      • Nested Query
      • Has Child Query
      • Has Parent Query
      • Parent Id Query
    • Geo queries
      • GeoShape Query
      • Geo Bounding Box Query
      • Geo Distance Query
      • Geo Distance Range Query
      • Geo Polygon Query
    • Specialized queries
      • More Like This Query
      • Template Query
      • Script Query
      • Percolate Query
    • Span queries
      • Span Term Query
      • Span Multi Term Query
      • Span First Query
      • Span Near Query
      • Span Or Query
      • Span Not Query
      • Span Containing Query
      • Span Within Query
      • Span Field Masking Query
    • Minimum Should Match
    • Multi Term Query Rewrite
  • Mapping
    • Field datatypes
      • Array datatype
      • Binary datatype
      • Range datatypes
      • Boolean datatype
      • Date datatype
      • Geo-point datatype
      • Geo-Shape datatype
      • IP datatype
      • Keyword datatype
      • Nested datatype
      • Numeric datatypes
      • Object datatype
      • String datatype
      • Text datatype
      • Token count datatype
      • Percolator type
    • Meta-Fields
      • _all field
      • _field_names field
      • _id field
      • _index field
      • _meta field
      • _parent field
      • _routing field
      • _source field
      • _type field
      • _uid field
    • Mapping parameters
      • analyzer
      • normalizer
      • boost
      • coerce
      • copy_to
      • doc_values
      • dynamic
      • enabled
      • fielddata
      • format
      • ignore_above
      • ignore_malformed
      • include_in_all
      • index
      • index_options
      • fields
      • norms
      • null_value
      • position_increment_gap
      • properties
      • search_analyzer
      • similarity
      • store
      • term_vector
    • Dynamic Mapping
      • default mapping
      • Dynamic field mapping
      • Dynamic templates
      • Override default template
  • Analysis
    • Anatomy of an analyzer
    • Testing analyzers
    • Analyzers
      • Configuring built-in analyzers
      • Standard Analyzer
      • Simple Analyzer
      • Whitespace Analyzer
      • Stop Analyzer
      • Keyword Analyzer
      • Pattern Analyzer
      • Language Analyzers
      • Fingerprint Analyzer
      • Custom Analyzer
      • Normalizers
    • Tokenizers
      • Standard Tokenizer
      • Letter Tokenizer
      • Lowercase Tokenizer
      • Whitespace Tokenizer
      • UAX URL Email Tokenizer
      • Classic Tokenizer
      • Thai Tokenizer
      • NGram Tokenizer
      • Edge NGram Tokenizer
      • Keyword Tokenizer
      • Pattern Tokenizer
      • Path Hierarchy Tokenizer
    • Token Filters
      • Standard Token Filter
      • ASCII Folding Token Filter
      • Flatten Graph Token Filter
      • Length Token Filter
      • Lowercase Token Filter
      • Uppercase Token Filter
      • NGram Token Filter
      • Edge NGram Token Filter
      • Porter Stem Token Filter
      • Shingle Token Filter
      • Stop Token Filter
      • Word Delimiter Token Filter
      • Stemmer Token Filter
      • Stemmer Override Token Filter
      • Keyword Marker Token Filter
      • Keyword Repeat Token Filter
      • KStem Token Filter
      • Snowball Token Filter
      • Phonetic Token Filter
      • Synonym Token Filter
      • Synonym Graph Token Filter
      • Compound Word Token Filter
      • Reverse Token Filter
      • Elision Token Filter
      • Truncate Token Filter
      • Unique Token Filter
      • Pattern Capture Token Filter
      • Pattern Replace Token Filter
      • Trim Token Filter
      • Limit Token Count Token Filter
      • Hunspell Token Filter
      • Common Grams Token Filter
      • Normalization Token Filter
      • CJK Width Token Filter
      • CJK Bigram Token Filter
      • Delimited Payload Token Filter
      • Keep Words Token Filter
      • Keep Types Token Filter
      • Classic Token Filter
      • Apostrophe Token Filter
      • Decimal Digit Token Filter
      • Fingerprint Token Filter
      • Minhash Token Filter
    • Character Filters
      • HTML Strip Char Filter
      • Mapping Char Filter
      • Pattern Replace Char Filter
  • 模块
    • 集群
      • 集群的分片分配
      • 基于磁盘的分片分配
      • 了解分片分配
      • 分片分配过滤
      • 其他群集设置
    • Discovery
      • Azure Classic Discovery
      • EC2 Discovery
      • Google Compute Engine Discovery
      • Zen Discovery
    • 本地网关
    • HTTP
    • 索引库
      • 熔断
      • Fielddata
      • 节点查询缓存
      • 索引缓冲
      • 分片请求缓存
      • 索引库恢复
    • 网络设置
    • 节点
    • 插件
    • 脚本
      • 如何使用脚本
      • 文档中字段的访问以及一些特殊变量
      • 脚本与安全
      • Groovy脚本语言
      • PainLess脚本语言
      • PainLess语法
      • PainLess调试
      • Lucene表达式语言
      • 原生(java)脚本
      • 高级文本评分脚本
    • 快照与还原
    • 线程池
    • 传输
    • Tribe节点
    • 跨集群搜索
  • Index模块
    • Analysis
    • Index Shard Allocation
      • Shard Allocation Filtering
      • Delaying allocation when a node leaves
      • Index recovery prioritization
      • Total Shards Per Node
    • Mapper
    • Merge
    • Similarity module
    • Slow Log
    • Store
      • Pre-loading data into the file system cache
    • Translog
  • Ingest节点
    • Pipeline Definition
    • Ingest APIs
      • Put Pipeline API
      • Get Pipeline API
      • Delete Pipeline API
      • Simulate Pipeline API
    • Accessing Data in Pipelines
    • Handling Failures in Pipelines
    • Processors
      • Append Processor
      • Convert Processor
      • Date Processor
      • Date Index Name Processor
      • Fail Processor
      • Foreach Processor
      • Grok Processor
      • Gsub Processor
      • Join Processor
      • JSON Processor
      • KV Processor
      • Lowercase Processor
      • Remove Processor
      • Rename Processor
      • Script Processor
      • Set Processor
      • Split Processor
      • Sort Processor
      • Trim Processor
      • Uppercase Processor
      • Dot Expander Processor
  • How To
    • General recommendations
    • Recipes
    • Tune for indexing speed
    • Tune for search speed
    • Tune for disk usage
  • Testing
    • Java Testing Framework
      • why randomized testing?
      • Using the elasticsearch test classes
      • unit tests
      • integration tests
      • Randomized testing
      • Assertions
  • 术语表
  • 发布说明
    • 5.3.0 Release Notes
    • 5.2.2 Release Notes
    • 5.2.1 Release Notes
    • 5.2.0 Release Notes
    • 5.1.2 Release Notes
    • 5.1.1 Release Notes
    • 5.1.0 Release Notes
    • 5.0.2 Release Notes
    • 5.0.1 Release Notes
    • 5.0.0 Combined Release Notes
    • 5.0.0 GA Release Notes
    • 5.0.0-rc1 Release Notes
    • 5.0.0-beta1 Release Notes
    • 5.0.0-alpha5 Release Notes
    • 5.0.0-alpha4 Release Notes
    • 5.0.0-alpha3 Release Notes
    • 5.0.0-alpha2 Release Notes
    • 5.0.0-alpha1 Release Notes
    • 5.0.0-alpha1 Release Notes (Changes previously released in 2.x)
  • Painless API参考文档
Powered by GitBook
On this page
  • 下载与安装.zip格式安装包
  • 在命令行中运行Elasticsearch
  • 在命令行配置Elasticsearch
  • 检查Elasticsearch运行
  • Windows后台服务方式安装
  • 自定义服务设置
  • 使用管理界面
  • ZIP压缩文件的目录结构
  • 下一步

Was this helpful?

  1. Elasticsearch设置
  2. 安装Elasticsearch

Windows安装方式

PreviousRPM安装方式NextDocker安装方式

Last updated 4 years ago

Was this helpful?

Elasticsearch在Windows系统中可以采用.zip格式的安装包进行安装,这里有一个elasticsearch-service.bat的指令可以让Elasticsearch以服务进程的方式运行。

Elasticsearch的最新稳定版本可以在页面获取。其它版本可以在上找到。

注意

Elasticsearch需要Java 8或更高版本。可以使用或开源版本的。

下载与安装.zip格式安装包

下载Elasticsearch v5.3.0的.zip压缩包:

使用你的解压工具解压。它会创建一个elasticsearch-5.3.0目录,我们将用%ES_HOME%来引用它。在window的终端进入这个目录,像这样:

cd c:\elasticsearch-5.3.0

在命令行中运行Elasticsearch

Elasticsearch可以从命令行启动,如下所示:

.\bin\elasticsearch

默认情况下,Elasticsearch在前台运行,其打印日志采用标准输出(stdout),并且可以通过按下Ctrl-C停止。

在命令行配置Elasticsearch

Elasticsearch默认从%ES_HOME%/config/elasticsearch.yml文件中加载配置。这个配置文件的格式说明请参考。

可以在配置文件中指定的任何配置都可以在命令行上指定,使用-E的语法,例如:

./bin/elasticsearch -Ecluster.name=my_cluster -Enode.name=node_1

注意

值如果包含空格,需要采用引号包围。例如:Epath.logs="C:\My Logs\logs"。

提示

通常情况下,任何集群范围的设置(例如cluster.name)应该被加入到elasticsearch.yml配置文件,而任何特定于节点的设置,例如node.name可以在命令行上被指定。

检查Elasticsearch运行

您可以在已运行的Elasticsearch节点上,发送一个HTTP请求测试localhost的9200端口:

GET /

返回的消息应该是这样的:

{
  "name" : "Cp8oag6",
  "cluster_name" : "elasticsearch",
  "cluster_uuid" : "AT69_T_DTp-1qgIJlatQqA",
  "version" : {
    "number" : "5.3.0",
    "build_hash" : "f27399d",
    "build_date" : "2016-03-30T09:51:41.449Z",
    "build_snapshot" : false,
    "lucene_version" : "6.4.1"
  },
  "tagline" : "You Know, for Search"
}

Windows后台服务方式安装

Elasticsearch能够被安装到Window的后台服务,它可以在没有任何用户交互的情况下跟谁操作系统一起启动。这可以通过bin\目录中的elasticsearch-service.bat脚本来实现安装、删除、管理与配置后台服务的启动与停止,都是通过命令行来实现。

c:\elasticsearch-5.3.0\bin>elasticsearch-service

Usage: elasticsearch-service.bat install|remove|start|stop|manager [SERVICE_ID]

该脚本需要一个参数(要执行的命令),后面跟一个可选的服务ID名称(用于安装多个Elasticsearch服务时)。

可用的命令如下:

命令

描述

install

安装Elasticsearch后台服务

remove

删除Elasticsearch后台服务(如果Elasticsearch后台服务已启动则先停止它)

start

启动Elasticsearch后台服务(如果已安装)

stop

停止Elasticsearch后台服务(如果已启动)

manager

启动一个图形界面来管理已安装的服务

根据现有的JDK/JRE(通过设置的JAVA_HOME),相应的64位(x64)或32位(x86)的服务将被安装。此信息是安装过程:

c:\elasticsearch-5.3.0\bin>elasticsearch-service install
Installing service      :  "elasticsearch-service-x64"
Using JAVA_HOME (64-bit):  "c:\jvm\jdk1.8"
The service 'elasticsearch-service-x64' has been installed.

注意

虽然JRE可用于Elasticsearch服务,由于其使用的客户机JVM(而不是JVM服务器模式,服务器模式对于长期运行应用提供了更好的性能),我们不鼓励使用JRE并会在使用时发出警告。

注意

升级(或降级)JVM的版本时,你并不需要重新安装Elasticsearch后台服务。但是如果升级跨JVM类型(譬如:从JRE到SE)时不行,这需要重新安装后台服务。

自定义服务设置

参数名

描述

SERVICE_ID

服务器名称,需要唯一。在同一机器上安装多个后台服务时使用。在32位系统里面默认为elasticsearch-service-x86,64位系统里面默认为elasticsearch-service-x64。

SERVICE_USERNAME

运行的用户,默认为当前用户。

SERVICE_PASSWORD

运行用户的密码。

SERVICE_DISPLAY_NAME

服务名称。默认为Elasticsearch <version> %SERVICE_ID%

SERVICE_DESCRIPTION

服务的描述。默认为Elasticsearch <version> Windows Service - https://elastic.co。

JAVA_HOME

自定义java路径。

LOG_DIR

日志目录,默认为/var/log/elasticsearch。

DATA_DIR

Data目录,默认为/var/lib/elasticsearch。

CONF_DIR

配置文件目录(其中必须包括elasticsearch.yml和log4j2.properties文件),默认为/etc/elasticsearch。

ES_JAVA_OPTS

任何额外的JVM系统属性,你可能要应用。

ES_START_TYPE

启动模式。可以是自动或者manual(默认)

ES_STOP_TIMEOUT

优雅退出时,procrun 等待的秒数。默认为0

注意

注意

使用管理界面

你也可以在安装完之后使用管理界面(elasticsearch-service-mgr.exe)来配置后台服务,它提供了查看与设置已安装服务的运行状态、启动类型、JVM、启动与停止等能力,简单地调用 elasticsearch-service.bat manager 在命令行会打开管理器窗口:

通过管理界面做的大多数更改(如JVM设置),都要求服务重新启动才能生效。

ZIP压缩文件的目录结构

.zip包是完全独立的。在%ES_HOME%中,只要解压压缩包之后会自动创建所有的文件和目录。

这是非常方便,因为开始使用Elasticsearch前你不需要创建任何目录,卸载Elasticsearch只需要删除%ES_HOME%目录。不过,建议你最好是修改下config目录、数据目录y与日志目录的默认位置,避免之后误删了重要的数据。

类型

描述

默认位置

设置方式

home

Elasticsearch主目录或 %ES_HOME%

目录由解包归档创建

bin

二进制脚本,包括启动节点的elasticsearch、安装插件的elasticsearch-plugin

%ES_HOME%/bin

conf

配置文件,包括lasticsearch.yml

%ES_HOME%/config

path.conf

data

节点上分配的各索引/分片的数据文件的目录,可以配置多个位置。

%ES_HOME%/data

path.data

log

日志文件的位置。

%ES_HOME%/logs

path.logs

plugins

插件的位置。每一个插件将被包含在一个子目录。

%ES_HOME%/plugins

repo

共享文件系统存储库位置。可以容纳多个位置。文件系统存储库可以放在这里指定的任意目录中的任何子目录。

未配置

path.repo

script

脚本文件位置。

%ES_HOME%/scripts

path.scripts

下一步

现在,您搭建了一个测试环境Elasticsearch。开始更深入的研究或投入生产使用Elasticsearch之前,你需要做一些额外的配置:

Elasticsearch服务可以在安装之前通过设置以下环境变量(可以通过[set命名](

核心的是,elasticsearch-service.bat依赖于项目来安装服务。该服务在安装之前设置环境变量被复制,并会在服务生命周期中使用。这意味着服务安装完成之后所做的任何修改都不会生效,除非你重新安装它。

在Windows中,的调整可以使任何时候的命令行启动走设置,或者是第一次安装Elasticsearch后台服务的时候设置。要调整已安装服务的JVM堆大小,可使用服务管理器:bin\elasticsearch-service.bat manager

管理界面

了解如何。

配置。

配置。

Elasticsearch下载
之前的下载页面
Oracle官方发布
OpenJDK
https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-5.3.0.zip
Elasticsearch配置
https://technet.microsoft.com/en-us/library/cc754250(v=ws.10).aspx)在命令行配置,也可以通过`系统设置`->`环境变量`的可视化界面配置)
Apache Commons Daemon
heap大小
配置Elasticsearch
重要的Elasticsearch设置
重要的系统设置