Get API
get API可以根据跟定的id来获取在索引库中存放的文档。下面演示了从一个叫twitter的索引库的tweet type下获取文档，id是0:
响应结果如下：
上面的结果包含了我们想要提取的文档的_index、_type、_id、_version信息，一旦我们找到文档，则真正的文档包含在_source下（响应体中的found标识了是否找到文档）。
API也可以使用HEAD请求来判断文档是否存在，例如：
实时
默认情况下，get API 是实时的，而且它不受创建索引文档的刷新频率的影响（当数据对search操作可见）。如果文档已经修改完，但没还有冲刷，get API将会发起 就地冲刷操作使得文档可见。这也会导致其他文档在上一次冲刷之后发生改变的也会可见。若要禁止GET的实时操作，可以设置realtime参数为false。
可选的Type
Typeget API允许_type是可选的，设置为_all后将会从所有的type中按顺序返回第一个匹配的文档。
Source过滤
Source过滤默认情况下，get操作返回_source字段的内容，除非你使用stored_fields参数或禁用_source字段。你可以使用_source参数来关闭提取_source信息：
如果你只想从_source的全部信息中获取其中的一到两个字段，你可以使用_source_include与_source_exclude参数来包含或排除你需要的信息部分。这在大型文档中非常有用，部分提取可以节省网络开销。这两个参数都可以使用逗号分隔多个字段以及通配符表达式，例如：
如果你仅需要使用包含某些字段，你可以使用更短的符号：
存储字段
get 操作允许指定一系列的存储字段，这些字段将会被通过传递stored_fields参数返回。如果请求的字段没有被储存，将会被忽略。参考以下示例：
现在我们添加一个文档：
然后提取它：
上面操作的返回结果为：
从文档中获取的字段的值通常是返回一个数组。由于counter字段没有存储，当尝试获取stored_fields时get会将其忽略。
也可以对元数据字段进行检索，比如_routing和_parent：
上面操作的返回结果为：
只有叶子字段才可以通过stored_field选项返回。所以object字段无法返回并且这个请求会失败
生成的字段
如果在创建索引和冲刷过程中没有发生冲刷操作，GET会访问事务日志来获取文档。然而，一些字段只会在创建索引时生成，如果你尝试访问那些只有在创建索引时才会创建的字段，默认情况下会得到一个异常。你可以通过设置ignore_errors_on_generated_fields=true来忽略那些字段。
直接获取_source
_source使用/{index}/{type}/{id}/_source可以只获取文档的_source字段，不会有其他多余的内容，例如：
你也可以使用过滤参数来控制_source的哪些部分可以被返回：
路由
当创建索引时想要控制路由，为了获取文档，路由的值也因该提供，例如：
以上的操作会获取id为2的tweet，但是是基于用户来路由的。注意，如果没有设置正确的路由，将会导致问无法被获取。
偏好
可以控制preference来让get请求在哪个副本分片上进行搜索，默认情况下，操作将随机在各个副本分片上执行。
_primary
_local
自定义（字符串）值
冲刷（Refresh）
refresh参数可以被设置为true，用来在get操作之前冲刷相关的分片，使其变得可搜索。将其设置为true应在仔细思考和验证后，不会对系统造成重负荷（并减慢索引）。
分布式
get操作被散列到一个指定的分片id。然后被重定向到这个id对于的一个分片并返回结果。这个分片的id是主分片和副本分片组中的一个。这意味着我们在拥有更多的副本时，我们将拥有更好的GET扩展性。
版本控制支持
我们可以在提取文档时使用version参数，只有在它的当前版本等于指定的版本时才会返回。对于所有版本类型而言，此行为是相同的，但FORCE的版本类型除外，它始终检索文档。注意:FORCE版本类型已弃用。
在内部，Elasticsearch已将旧文档标记为已删除，并添加了全新的文档。文档的旧版本不会立即消失，尽管您将无法访问该文档。当您继续索引更多数据时，Elasticsearch会在后台清理已删除的文档。
Last updated
Was this helpful?