# Completion Suggester
完全(**completion**)**suggester **提供自动完成/按需搜索功能。 这是一种导航功能,可在用户输入时引导用户查看相关结果,从而提高搜索精度。 它不是用于拼写校正或平均值功能,如术语或短语 **suggesters **。
理想地,自动完成功能应当与用户键入的速度一样快,以提供与用户已经键入的内容相关的即时反馈。因此,完成 **suggester** 针对速度进行优化。 **suggester** 使用允许快速查找的数据结构,但是构建成本高并且存储在存储器中。
## 映射(mapping)
要使用此功能,请为此字段指定一个特殊映射,为快速完成的字段值编制索引。
|
`PUT music`
`{`
`"mappings"``: {`
`"song"` `: {`
`"properties"` `: {`
`"suggest"` `: {`
`"type"` `: ``"completion"`
`},`
`"title"` `: {`
`"type"``: ``"keyword"`
`}`
`}`
`}`
`}`
`}`
|
映射支持以下参数:
**analyzer**
使用索引分析器,默认为简单。 如果你想知道为什么我们没有选择标准分析器:我们尝试在这里很容易理解的行为,如果你索引字段内容在Drive-in,你不会得到任何建议, (第一个非停用词)
**search_analyzer**
要使用的搜索分析器,默认为分析器的值。
**preserve_separators**
保留分隔符,默认为true。 如果禁用,你可以找到一个以Foo Fighters开头的字段,如果你推荐foof。
**preserve_position_increments**
启用位置增量,默认为true。 如果禁用和使用停用分析器,您可以得到一个字段从披头士开始,如果你 suggest b。 注意:你也可以通过索引两个输入,Beatles和披头士,不需要改变一个简单的分析器,如果你能够丰富你的数据。
**max_input_length**
限制单个输入的长度,默认为50个UTF-16代码点。 此限制仅在索引时使用,以减少每个输入字符串的字符总数,以防止大量输入膨胀底层数据结构。 大多数用例不会受默认值的影响,因为前缀完成很少超过前缀长度超过少数几个字符。
## 索引
您像任何其他字段一样索引 **suggestion** 。 **suggestion** 由输入和可选的权重属性组成。 输入是要由 **suggestion** 查询匹配的期望文本,并且权重确定如何对 **suggestion** 进行评分。 索引 **suggestion** 如下:
|
`PUT music/song/``1``?refresh`
`{`
`"suggest"` `: {`
`"input"``: [ ``"Nevermind"``, ``"Nirvana"` `],`
`"weight"` `: ``34`
`}`
`}`
|
以下参数被支持:
**input**
输入存储,这可以是字符串数组或只是一个字符串。 此字段是必填字段。
**weight**
正整数或包含正整数的字符串,用于定义权重并允许对 **suggestions** 进行排名。 此字段是可选的。
您可以按如下所示为文档编制多个 suggestion s:
|
`PUT music/song/``1``?refresh`
`{`
`"suggest"` `: [`
`{`
`"input"``: ``"Nevermind"``,`
`"weight"` `: ``10`
`},`
`{`
`"input"``: ``"Nirvana"``,`
`"weight"` `: ``3`
`}`
`]`
`}`
|
您可以使用以下速记形式。 请注意,您不能使用 **suggestion** 指定权重。
|
`PUT music/song/``1``?refresh`
`{`
`"suggest"` `: [ ``"Nevermind"``, ``"Nirvana"` `]`
`}`
|
## 查询
**suggest** 像往常一样工作,除了您必须指定 **suggest** 类型为完成。 **suggestions** 接近实时,这意味着可以通过刷新显示新**suggestions** ,并且一旦删除就不会显示文档。 此请求:
|
`POST music/_suggest?pretty`
`{`
`"song-suggest"` `: {`
`"prefix"` `: ``"nir"``,`
`"completion"` `: {`
`"field"` `: ``"suggest"`
`}`
`}`
`}`
|
返回这个响应:
|
`{`
`"_shards"` `: {`
`"total"` `: ``5``,`
`"successful"` `: ``5``,`
`"failed"` `: ``0`
`},`
`"song-suggest"` `: [ {`
`"text"` `: ``"nir"``,`
`"offset"` `: ``0``,`
`"length"` `: ``3``,`
`"options"` `: [ {`
`"text"` `: ``"Nirvana"``,`
`"_index"``: ``"music"``,`
`"_type"``: ``"song"``,`
`"_id"``: ``"1"``,`
`"_score"``: ``1.0``,`
`"_source"``: {`
`"suggest"``: [``"Nevermind"``, ``"Nirvana"``]`
`}`
`} ]`
`} ]`
`}`
|
重要
_**source** 元字段必须启用,这是默认行为,以启用返回 **_source** 与 **suggestions** 。
配置的 **suggestion** 的权重返回为_score。 文本字段使用您的索引 **suggestion** 的输入。 默认情况下, suggestion 返回完整的文档_source。 由于磁盘读取和网络传输开销,_source的大小可能会影响性能。 为了节省一些网络开销,使用源过滤从_source中过滤掉不必要的字段,以最小化_source大小。 请注意,_suggest 端点不支持源过滤,但在_search端点上使用 **suggestion** :
|
`POST music/_search?size=``0`
`{`
`"_source"``: ``"suggest"``,`
`"suggest"``: {`
`"song-suggest"` `: {`
`"prefix"` `: ``"nir"``,`
`"completion"` `: {`
`"field"` `: ``"suggest"`
`}`
`}`
`}`
`}`
|
应该看起来像:
|
`{`
`"took"``: ``6``,`
`"timed_out"``: ``false``,`
`"_shards"` `: {`
`"total"` `: ``5``,`
`"successful"` `: ``5``,`
`"failed"` `: ``0`
`},`
`"hits"``: {`
`"total"` `: ``0``,`
`"max_score"` `: ``0.0``,`
`"hits"` `: []`
`},`
`"suggest"``: {`
`"song-suggest"` `: [ {`
`"text"` `: ``"nir"``,`
`"offset"` `: ``0``,`
`"length"` `: ``3``,`
`"options"` `: [ {`
`"text"` `: ``"Nirvana"``,`
`"_index"``: ``"music"``,`
`"_type"``: ``"song"``,`
`"_id"``: ``"1"``,`
`"_score"``: ``1.0``,`
`"_source"``: {`
`"suggest"``: [``"Nevermind"``, ``"Nirvana"``]`
`}`
`} ]`
`} ]`
`}`
`}`
|
基本的完全 **suggester** 查询支持以下参数:
**field**
要运行查询的字段的名称(必需)
**size**
要返回的 **suggestions** 数(默认为5)。
完全 **suggester** 考虑索引中的所有文档。 有关如何查询文档子集的解释,请参阅 [Context Suggester](http://www.apache.wiki/display/Elasticsearch/Context+Suggester)。
在跨越多个碎片的完成查询的情况下, **suggest** 在两个阶段中执行,其中最后阶段从碎片提取相关文档,这意味着对于单个碎片的执行完成请求由于文档提取开销而更加高效, **suggest** 跨越多个碎片。 为了获得最佳的完成性能, 建议将完成索引到单个分片索引中。 在由于碎片大小而导致堆使用率过高的情况下,仍建议将索引拆分为多个分片,而不是优化完成性能。
## 模糊查询
完成 **suggester** 还支持模糊查询 - 这意味着,您可以在搜索中输入错误,并仍然返回结果。
|
`POST music/_suggest?pretty`
`{`
`"song-suggest"` `: {`
`"prefix"` `: ``"nor"``,`
`"completion"` `: {`
`"field"` `: ``"suggest"``,`
`"fuzzy"` `: {`
`"fuzziness"` `: ``2`
`}`
`}`
`}`
`}`
|
与查询前缀共享最长前缀的 **suggestion** 将得分更高。
模糊查询可以采用特定的模糊参数。 支持以下参数:
| **fuzziness** | 模糊系数,默认为AUTO。 有关允许的设置,请参阅[ “Fuzzinessedit”一节](http://www.apache.wiki/pages/viewpage.action?pageId=4882851)。 |
| **transpositions** | 如果设置为true,则换位计数为一个更改而不是两个,默认为true |
| **min_length** | 返回模糊 **suggestions** 前的输入的最小长度,默认值3 |
| **prefix_length** | 输入的最小长度(未针对模糊替代项进行检查)默认为1 |
| **unicode_aware** | 如果为true,则所有度量(如模糊编辑距离,置换和长度)都以Unicode代码点而不是字节为单位。 这比原始字节稍慢,因此默认情况下设置为false。 |
如果你想坚持使用默认值,但仍然使用模糊,你可以使用 fuzzy:{}或fuzzy:true。
## 正则表达式查询
完成 **suggester** 还支持正则表达式查询,意味着您可以将前缀表达为正则表达式
|
`POST music/_suggest?pretty`
`{`
`"song-suggest"` `: {`
`"regex"` `: ``"n[ever|i]r"``,`
`"completion"` `: {`
`"field"` `: ``"suggest"`
`}`
`}`
`}`
|
正则表达式查询可以使用特定的正则表达式参数。 支持以下参数:
| **flags** | 可能的标志是ALL(默认),ANYSTRING,COMPLEMENT,EMPTY,INTERSECTION,INTERVAL或NONE。 有关它们的含义,请参见 [regexp-syntax](http://www.apache.wiki/pages/viewpage.action?pageId=4882851). |
| **max_determinized_states** | 正则表达式是危险的,因为很容易意外地创建一个无害的,需要指数数量的内部确定的自动机状态(以及相应的RAM和CPU)执行 **Lucene** 。 Lucene使用 **max_determinized_states** 设置(默认为10000)阻止这些操作。 您可以提高此限制以允许执行更复杂的正则表达式。 |
- 入门
- 基本概念
- 安装
- 探索你的集群
- 集群健康
- 列出所有索引库
- 创建一个索引库
- 索引文档创建与查询
- 删除一个索引库
- 修改你的数据
- 更新文档
- 删除文档
- 批量处理
- 探索你的数据
- 搜索API
- 查询语言介绍
- 执行搜索
- 执行过滤
- 执行聚合
- 总结
- Elasticsearch设置
- 安装Elasticsearch
- .zip或.tar.gz文件的安装方式
- Install Elasticsearch with .zip on Windows
- Debian软件包安装方式
- RPM安装方式
- Install Elasticsearch with Windows MSI Installer
- Docker安装方式
- 配置Elasticsearch
- 安全配置
- 日志配置
- 重要的Elasticsearch配置
- 重要的系统配置
- 系统设置
- 在jvm.options中设置JVM堆大小
- 禁用swapping
- 文件描述符
- 虚拟内存
- 线程数
- DNS cache settings
- 启动前检查
- 堆大小检查
- 文件描述符检查
- 内存锁定检查
- 最大线程数检查
- 最大虚拟内存检查
- Max file size check
- 最大map数检查
- JVM Client模式检查
- 串行收集使用检查
- 系统调用过滤检查
- OnError与OnOutOfMemoryError检查
- Early-access check
- G1GC检查
- Elasticsearch停机
- Elasticsearch升级
- 滚动升级
- 全集群重启升级
- 索引重建升级
- Set up X-Pack
- Installing X-Pack
- X-Pack Settings
- Watcher Settings
- Configuring Security
- Breaking changes in 6.0
- X-Pack Breaking Changes
- 重大变化
- 6.0的重大变化
- 聚合变化
- Cat API变化
- 客户端变化
- 集群变化
- 文档API变化
- 索引变化
- 预处理变化
- 映射变化
- Packaging变化
- Percolator变化
- 插件变化
- 索引重建变化
- 信息统计变化
- DSL查询变化
- 设置变化
- 脚本变化
- API约定
- 多索引语法
- 索引库名称的日期运算
- 常用选项
- URL-based访问控制
- 文档APIs
- 读写文档
- 索引接口
- Get接口
- 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
- 搜索APIs
- 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
- Returning the type of the suggester
- Multi Search API
- Count API
- Validate API
- Explain API
- Profile API
- Profiling Queries
- Profiling Aggregations
- Profiling Considerations
- Field Capabilities API
- Aggregations
- Metrics Aggregations
- 平均值聚合
- 值计数聚合(Value Count Aggregation)
- Cardinality Aggregation
- Extended Stats 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
- 邻接矩阵聚合
- Children Aggregation
- Date Histogram Aggregation
- Date Range Aggregation
- Significant Terms Aggregation
- Filter Aggregation(过滤器聚合)
- Filters Aggregation
- Geo Distance Aggregation(地理距离聚合) 转至元数据结尾
- GeoHash grid Aggregation(GeoHash网格聚合)
- Global Aggregation(全局聚合) 转至元数据结尾
- Histogram Aggregation
- IP Range Aggregation(IP范围聚合)
- Missing Aggregation
- Nested Aggregation(嵌套聚合)
- Range Aggregation(范围聚合)
- Reverse nested Aggregation
- Sampler Aggregation
- Significant Terms Aggregation
- Significant Text 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
- Returning the type of the aggregation
- Indices APIs
- 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
- 索引统计信息
- 索引段
- 索引恢复
- 索引分片存储
- 清理缓存
- 刷新
- 同步刷新
- 重新加载
- 强制合并
- Cat APIs
- 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 segments
- cat shards
- cat thread pool
- cat snapshots
- cat templates
- Cluster APIs
- 集群健康
- 集群状态
- 集群统计
- 挂起的集群任务
- 集群重新路由
- Cluster Update Settings
- Nodes Stats
- Nodes Info
- Nodes Feature Usage
- Remote Cluster Info
- Task Management API
- Nodes hot_threads
- Cluster Allocation Explain API
- Query DSL
- 查询context与过滤context
- Match All Query
- 全文搜索
- 匹配查询
- 短语匹配查询
- 短语前缀匹配查询
- 多字段查询
- 常用术语查询
- 查询语句查询
- 简单查询语句
- Term level queries
- Term Query
- Terms Query
- Range Query
- Exists Query
- Prefix Query
- Wildcard Query
- Regexp Query
- Fuzzy Query
- Type Query
- Ids Query
- 复合查询
- Constant Score 查询
- Bool 查询
- Dis Max 查询
- Function Score 查询
- Boosting 查询
- Joining queries
- Has Child Query
- Has Parent Query
- Nested Query(嵌套查询)
- Parent Id Query
- Geo queries
- GeoShape Query(地理形状查询)
- Geo Bounding Box Query(地理边框查询)
- Geo Distance Query(地理距离查询)
- Geo Polygon Query(地理多边形查询)
- Specialized queries
- More Like This Query
- Script Query
- Percolate Query
- Span queries
- Span Term 查询
- Span Multi Term 查询
- Span First 查询
- Span Near 查询
- Span Or 查询
- Span Not 查询
- Span Containing 查询
- Span Within 查询
- Span Field Masking 查询 转至元数据结尾
- Minimum Should Match
- Multi Term Query Rewrite
- Mapping
- Removal of mapping types
- Field datatypes
- Array
- Binary
- Range
- Boolean
- Date
- Geo-point datatype
- Geo-Shape datatype
- IP datatype
- Keyword datatype
- Nested datatype
- Numeric datatypes
- Object datatype
- Text
- Token数
- 渗滤型
- join datatype
- Meta-Fields
- _all field
- _field_names field
- _id field
- _index field
- _meta field
- _routing field
- _source field
- _type field
- _uid field
- Mapping parameters
- analyzer(分析器)
- normalizer(归一化)
- boost(提升)
- Coerce(强制类型转换)
- copy_to(合并参数)
- doc_values(文档值)
- dynamic(动态设置)
- enabled(开启字段)
- eager_global_ordinals
- fielddata(字段数据)
- format (日期格式)
- ignore_above(忽略超越限制的字段)
- ignore_malformed(忽略格式不对的数据)
- index (索引)
- index_options(索引设置)
- fields(字段)
- Norms (标准信息)
- null_value(空值)
- position_increment_gap(短语位置间隙)
- properties (属性)
- search_analyzer (搜索分析器)
- similarity (匹配方法)
- store(存储)
- Term_vectors(词根信息)
- Dynamic Mapping
- Dynamic field mapping(动态字段映射)
- Dynamic templates(动态模板)
- default mapping(mapping中的_default_)
- Analysis
- Anatomy of an analyzer(分析器的分析)
- Testing analyzers(测试分析器)
- Analyzers(分析器)
- Configuring built-in analyzers(配置内置分析器)
- Standard Analyzer(标准分析器)
- Simple Analyzer(简单分析器)
- 空白分析器
- Stop Analyzer
- Keyword Analyzer
- 模式分析器
- 语言分析器
- 指纹分析器
- 自定义分析器
- Normalizers
- Tokenizers(分词器)
- Standard Tokenizer(标准分词器)
- Letter Tokenizer
- Lowercase Tokenizer (小写分词器)
- Whitespace Analyzer
- UAX URL Email Tokenizer
- Classic Tokenizer
- Thai Tokenizer(泰语分词器)
- NGram Tokenizer
- Edge NGram Tokenizer
- Keyword Analyzer
- Pattern Tokenizer
- Simple Pattern Tokenizer
- Simple Pattern Split 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
- Word Delimiter Graph 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 Filters
- 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 Character Filter
- Mapping Character Filter
- Pattern Replace Character Filter
- 模块
- Cluster
- 集群级路由和碎片分配
- 基于磁盘的分片分配
- 分片分配awareness
- 分片分配过滤
- Miscellaneous cluster settings
- Scripting
- Painless Scripting Language
- Lucene Expressions Language
- Advanced scripts using script engines
- Snapshot And Restore
- Thread Pool
- Index Modules(索引模块)
- 预处理节点
- 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
- Monitoring Elasticsearch
- X-Pack APIs
- X-Pack Commands
- How To
- Testing(测试)
- Glossary of terms
- Release Notes
- X-Pack Release Notes