Elasticsearch 7.0 弃用了接受类型的 API，引入了新的无类型 API，并移除了对 _default_ 映射的支持。

<p>自版本 5.0 起，我们一直在为从 Elasticsearch 中移除类型而铺平道路，终于自版本 7.0 起，实现了类型弃用。使用类型的初衷是在与 Lucene 不兼容的单个索引中提供多租户，但遗憾的是，事实证明，类型带来的问题比解决的问题还多。&nbsp;我们对是否应解决这一问题进行了长时间的讨论（例如，每个类型使用唯一的字段或在底层每个类型具有一个索引），最终我们决定移除对类型的支持。为了让用户更轻松地过渡，我们将更改分散在了四个主要版本中：
</p>
<ul>
	<li>5.0 开始，强制跨多个类型共享同一名称的字段具有兼容的映射。</li>
	<li>6.0 开始，禁止新索引具有多个类型，并弃用了 <code>_default_</code> 映射。</li>
	<li>7.0 弃用了接受类型的 API，引入了新的无类型 API，并移除了对 <code>_default_</code> 映射的支持。</li>
	<li>8.0 将移除接受类型的 API。</li>
</ul>
<h2>无类型 API</h2>
<p>在 URL 路径、请求正文或响应正文中接受类型的所有 API 将获得一个新的“无类型”对应项。部分特别常用的 API（如索引创建、索引和 GET API）都会发生这种情况。一例胜万言，我们来看一个使用无类型 API 与 7.0 集群交互的例子：
</p>
<pre class="prettyprint">PUT index
{
  "mappings": {
    "properties": { // Note how there is no top-level key with the type name
      "@timestamp": {
        "type": "date"
      }
    }
  }
}
PUT index/_doc/1 // _doc becomes the new endpoint for document index, get and delete requests
{
  "@timestamp":"2019-02-20"
}
POST index/_bulk
{"index": {"_id":"2"}} // no _type in the URL or in document metadata
{"@timestamp":"2019-03-01"}
{"update": {"_id":"1"}}
{"@timestamp":"2019-02-21"}
GET index/_doc/2
GET index/_search // unchanged, the `GET index/{type}/_search` endpoint is deprecated however
{
  "query": {
    "range": {
      "@timestamp": {
        "gte":"2019-01-01"
      }
    }
  }
}
GET index/_explain/1 // note how the type does not appear in the URL anymore, this would have been "GET index/{type}/1/_explain" in 6.x
{
  "query": {
    "range": {
      "@timestamp": {
        "gte":"2019-01-01"
      }
    }
  }
}
</pre>
<h2>我需要做什么？</h2>
<p>某些更改会造成中断，需要您在升级到 7.0 <strong>之前</strong>对集群执行一些更改。某些其他更改仅在升级到 8.0 时需要，应在升级到 7.0 之后执行。
</p>
<h3>升级之前</h3>
<h4>确保您在使用 6.8</h4>
<p>如果您计划以滚动方式进行无中断升级，应先升级到 6.8；在 6.x 的各个版本中，只有此版本具有支持 <code>include_type_name</code> 参数等功能，而对该参数的支持是顺利升级到 7.0 所必需的。
</p>
<h4>停止使用 _default_ 映射</h4>
<p>7.0 中将停用 <code>_default_</code> 映射。如果一些现有 6.x 索引具有 <code>_default_</code> 映射，可以继续使用，因为仅新索引才会拒绝 <code>_default_</code> 映射。
</p>
<p>请更新索引模板和应用程序代码，将这些映射添加到实际类型，而不是将它们包括在 <code>_default_</code> 映射中。如果类型名称对您不重要，建议使用 <code>_doc</code>，有助于您未来更轻松地过渡到无类型 API。
</p>
<h4>将 <code>include_type_name=true</code> 传递到索引创建、模板和映射 API</h4>
<p>迁移到无类型 API 意味着，以前在请求正文中需要类型的 API 现在应具有其他格式：
</p>
<ul>
	<li>create index</li>
	<li>put mapping</li>
	<li>put template</li>
</ul>
<p>而在响应中返回类型的其他 API 将具有其他响应格式：
</p>
<ul>
	<li>get index</li>
	<li>get mapping</li>
	<li>get field mapping</li>
	<li>get template</li>
</ul>
<p>为了不被此更改中断，请让应用程序将 <code>include_type_name=true</code> 传递到这些 API 调用；此参数在 6.x 中是一个 no-op 指令，且将要求 7.x 让这些 API 的行为与 6.x 中一致。例如，以下是使用此参数的索引创建调用。其在 6.8 和 7.x 上的行为方式相同。
</p>
<pre class="prettyprint">PUT index?include_type_name=true
{
  "mappings": {
    "my_type": {
      "properties": { // Note how there is no top-level key with the type name
        "@timestamp": {
          "type": "date"
        }
      }
    }
  }
}
</pre>
<h3>升级之后</h3>
<p>如果您遵循了建议的升级前步骤，则一切应正常运行。但在此阶段，因为您仍在使用接受类型的 API，这会触发弃用警告。为了避免此情况，请迁移到无类型 API。
</p>
<p>对于索引创建、模板和映射 API，需要从不再包含类型的 URL 参数、更改请求正文或有关响应格式的要求中移除 <code>include_type_name=true</code>。通常，如果请求正文或响应包含映射，则其中会包含一个类似以下内容的部分：
</p>
<pre class="prettyprint">{
  "my_type": { // this key is no longer accepted in mappings as of 7.0
    "properties": ...
  }
}
</pre>
<p>It needs to be updated to no longer include a type name, and would now look like that:
</p>
<pre class="prettyprint">{
  "properties": ...
}
</pre>
<p>For other APIs like the index, GET, or update API, you should replace the type name in the URL with <code>_doc</code>.This will work regardless of the name of the type of your index.For instance if you used to perform index calls for an index whose type name is <code>my_type</code>, the index call looked like this:
</p>
<pre class="prettyprint">PUT index/my_type/1
{
  "@timestamp":"2019-02-20"
}
</pre>
<p>and should be replaced with that:
</p>
<pre class="prettyprint">PUT index/_doc/1
{
  "@timestamp":"2019-02-20"
}
</pre>
<h2>了解详情</h2>
<p>如需了解有关移除类型以及如何迁移到无类型 API 的更多信息，建议查看我们<a href="/guide/en/elasticsearch/reference/7.0/removal-of-types.html">关于移除类型的文档</a>，从中更详细地了解有关这些更改的影响，以及如何为这些更改做好准备。
</p>
<p><a href="/cn/downloads/elasticsearch">下载 7.0.0</a>，试试这些新的无类型 API，并在<a href="https://discuss.elastic.co/">讨论</a>中告知我们您的想法。
</p>

types-typeless-banner.jpg

types-typeless-thumb.jpg

Goodbye, types. Hello, typeless.

告别类型。迎接无类型。

Tech Lead, Elasticsearch

Adrien Grand

Articles By

Register to Attend

Sign In to Attend

Register to Watch

You'll also receive an email with related content

Watch Now

Learn More

Contact Info

See All Posts

What to explore next...

Load more news

Load more press releases

Load More

Translate Content

Articles by Adrien Grand

告别类型。迎接无类型。

产品

公司

Resources

软件即服务 (SaaS)

编排

Articles by Adrien Grand

告别类型。迎接无类型。