Solr7新特性【升级须知】

女爷i 2023-02-16 06:49 24阅读 0赞

## 一.概述 ##

在开始迁移配置和索引之前，需要考虑 Solr 7 中的主要更改。可能需要了解的新功能，还包括默认行为和已删除的已否决功能的更改。

然而，Solr 7 中有许多变化，因此，对 Solr 升级说明以及 Solr 实例中的 CHANGES.txt 文件进行彻底的审查将有助于向 Solr 7 迁移。

还应该考虑在尚未升级到的任何版本中对 Solr 所做的所有更改。例如，如果当前正在使用 Solr 6.2，则除了 7.0 的更改之外，还应该查看所有后续 6.x 版本中所做的更改。

将数据重新编入索引被认为是最佳做法，如果可能的话，应该尝试这样做。但是，如果重新索引不可行，请记住，只能一次升级一个主要版本。因此，Solr 6.x 索引将与 Solr 7 兼容，但 Solr 5.x 索引不会。

如果现在不重新编制索引，请记住，将需要重新索引数据或升级索引，然后才能在将来发布 Solr 8 时转移到 Solr 8。

## 二.新增功能和功能增强 ##

1.复制模式  
直到 Solr 7 ，SolrCloud 模型的复制副本允许任何复制副本在领导者丢失时成为领导者。这对大多数用户来说非常有效，在集群出现问题的情况下提供可靠的故障切换。但是，由于所有副本必须在任何时候都同步，因此在大型群集中需要付出代价。

为了提供更多的灵活性，已经添加了两种新类型的副本，名为 TLOG＆PULL。这些新类型提供了一些选项，以便仅通过从前导项复制索引段与引线同步的副本。TLOG 类型还有一个额外的好处，就是维护一个事务日志（它的名字为 “tlog”），如果需要的话，它可以恢复并成为领导者；PULL 类型不维护事务日志，因此不能成为领导者。

作为这种改变的一部分，传统的副本现在被命名为 NRT。如果没有明确定义一些 TLOG 或 PULL 副本，则 Solr 默认创建 NRT 副本。如果这个模型比较适合，则不需要改变任何东西。

2.自动缩放  
Solr 自动缩放是 Solr 中的一个新功能套件，用于管理 SolrCloud 群集更加简单和自动化。

Solr 自动缩放的核心是为用户提供一个规则语法来定义如何在集群中分发节点和碎片的首选项和策略，目的是在集群中保持平衡。从 Solr 7 开始，Solr 将在确定将创建或移动各种 Collections API 命令的新碎片和副本放置到何处时，将考虑任何策略或首选项规则。

3.其他功能和增强

*  Analytics 组件已被重构。
 *  在早期的 6.x 版本中发布了其他几个新功能，您可能会错过这些功能：学习排名（Learning to Rank）。统一的高亮（Unified Highlighter）。度量 API（Metrics API）。

## 三.配置和默认更改 ##

1.新的默认配置集

*  对与 Solr 有关的配置进行了若干修改；不仅他们的内容，还有 Solr 在这些方面的行为：data\_driven\_configset 与 basic\_configset 已被删除，取而代之的是 \_defaultconfigset。sample\_techproducts\_configset 还保留，专门与example/exampledocs 目录中的 Solr 附带的示例文档一起使用。
 *  当创建一个新的集合时，如果不指定一个 configSet，\_default 将被使用。如果你使用 SolrCloud，\_defaultconfigSet 会自动上传到 ZooKeeper。如果使用独立模式，instanceDir 将自动创建，使用 \_defaultconfigSet 作为基础。

2.无模式的改进  
为了改进无模式的功能，当检测到传入字段中的数据应该具有基于文本的字段类型时，Solr 现在的行为会有所不同。

*  默认情况下，传入的字段将被索引为 text\_general（可以更改）。该字段的名称将与文档中定义的字段名称相同。
 *  复制字段规则将被插入到模式中，以将新的 text\_general 字段复制到具有名称的新字段 \_str。这个字段的类型将是一个 strings 字段（允许多个值）。文本字段的前 256 个字符将被插入到新的字符串字段中。

如果希望删除复制字段规则，或者更改插入到字符串字段的字符数或所使用的字段类型，则可以自定义此行为。  
**备注**：由于复制字段规则会降低索引的速度并增加索引大小, 所以建议在需要时使用复制字段。如果不需要对字段进行排序或分面，则应该删除自动生成的复制字段规则。  
可以使用 update.autoCreateFields 属性禁用自动字段创建。要做到这一点，可以通过如下命令使用 Config API 例如：

curl http://host:8983/solr/mycollection/config -d '{"set-user-property": {"update.autoCreateFields":"false"}}'

3.对默认行为的更改

*  JSON 现在是默认的响应格式。如果依赖于 XML 响应，现在必须在请求中定义：wt=xml。另外，行缩进是默认启用的（indent=on）。
 *  sow 参数（“Split on Whitespace”的缩写）现在默认为 false，允许支持多字同义词。该参数与 eDismax 和 standard/“lucene” 查询解析器一起使用。如果此参数没有明确指定为：true，查询文本将不会在空白上拆分。
 *  legacyCloud 参数现在默认为 false。如果副本的项不存在 state.json，则该副本将不会被注册。这可能会影响到复制副本的用户，并自动将其注册为分片的一部分。通过使用以下命令在群集属性中设置属性 legacyCloud=true，可以退回到旧的行为：
    
        ./server/scripts/cloud-scripts/zkcli.sh -zkhost 127.0.0.1:2181 -cmd clusterprop -name legacyCloud -val true
 *  如果 solrconfig 中的 luceneMatchVersion 是 7.0.0 或以上版本，则 eDismax 查询分析器参数 lowercaseOperators 现在默认为 false。luceneMatchVersion 低于7.0.0 的行为是不变的（因此，为 true）。这意味着客户端必须以大写的方式发送布尔运算符（如 AND、OR 和 NOT）才能被识别，或者必须明确地设置该参数为 true。
 *  如果 luceneMatchVersion 是7.0.0 或以上，则 solrconfig 中的 handleSelect 参数现在默认为 false。这会导致 Solr 忽略 qt 参数，如果它存在于请求中。如果请求处理程序没有前导 ‘/’，则可以设置 handleSelect=“true” 或考虑迁移配置。该 qt 参数仍用作指定要使用的请求处理程序（尾部 URL 路径）的 SolrJ特殊参数。
 *  lucenePlusSort 查询解析器（又名 “旧 Lucene 查询解析器”）已被弃用，不再隐式定义。如果你想继续使用这个解析器直到 Solr 8（当它将被删除），你必须将它注册到 solrconfig. xml 中，如：
    
        <queryParser name="lucenePlusSort" class="solr.OldLuceneQParserPlugin"/>
 *  TemplateUpdateRequestProcessorFactory 名称从 Template更改为 template，AtomicUpdateProcessorFactory 的名称从 Atomic 改为atomic，此外，TemplateUpdateRequestProcessorFactory 现在使用 \{\} 而不是 $ \{\} 作为模板。

4.弃用和删除的功能  
**点字段是默认的数值类型**  
Solr 全面实现了 \* PointField 类型，取代了基于 Trie \* 的数字字段。现在所有的 Trie \* 字段都被认为是不赞成使用的，并将在 Solr 8 中删除。

如果使用 Trie \* 字段，则应该考虑尽快迁移到 PointFields。更改为新的 PointField 类型将要求重新索引数据。

**空间领域**  
以下与空间相关的字段已被弃用：

*  LatLonType
 *  GeoHashField
 *  SpatialVectorFieldType
 *  SpatialTermQueryPrefixTreeFieldType

改为选择下列字段类型之一：

*  LatLonPointSpatialField
 *  SpatialRecursivePrefixTreeField
 *  RptWithGeometrySpatialField

## 四.JMX 支持和 MBeans ##

*  solrconfig.xml 中的 jmx 元素已被删除， 以支持在 solr 中定义的 metrics、 reporter 元素。如果缺少 SolrJmxReporter，并且在找到本地 MBean 服务器时自动添加默认的实例，则会提供有限的向后兼容性。本地 MBean 服务器可以通过 solr.in.sh 中的 ENABLE\_REMOTE\_JMX\_OPTS 或者经由系统的性能（例如：Dcom.sun.management.jmxremote）被激活。此默认实例将所有注册表中的所有 Solr 度量标准导出为分层 MBean。还可以通过指定SolrJmxReporter 配置来禁用该行为，该配置使用的布尔型 init 参数设置为 false。对于更加 fine-grained 的控制，用户应明确指定至少一个 SolrJmxReporter配置。请注意，后向兼容性支持可能会在 Solr 8 中删除。
 *  MBean 名称和属性现在遵循度量中使用的分层名称。这也反映在：/admin/mbeans和/admin/plugins 输出中，并且可以在 UI Plugins 选项卡中观察到，因为现在所有这些 API 都从度量 API 获取其数据。旧的JMX 视图已被删除。

## 五.SolrJ ##

*  HttpClientInterceptorPlugin：现在是 HttpClientBuilderPlugin，必须与一个 SolrHttpClientBuilder 一起工作，而不是一个 HttpClientConfigurer。
 *  HttpClientUtil：现在允许通过 SolrHttpClientBuilder 配置 HttpClient 实例，而不是通过一个 HttpClientConfigurer。使用 env 变量SOLR\_AUTHENTICATION\_CLIENT\_CONFIGURER 不再有效，请使用 SOLR\_AUTHENTICATION\_CLIENT\_BUILDER。
 *  SolrClient：实现使用自己的内部配置套接字超时、连接超时并允许重定向，而不是在生成 HttpClient 实例时设置为默认值。在 SolrClient 实例上使用适当的设置器。
 *  HttpSolrClient.setAllowCompression 已被移除，必须将压缩作为构造函数参数启用。
 *  HttpSolrClient.setDefaultMaxConnectionsPerHost 和 HttpSolrClient.setMaxTotalConnections 已被删除。现在这些默认值非常高，只能在创建HttpClient 实例时通过参数进行更改。

## 五.其他的弃用和删除 ##

*  模式中的 defaultOperator 参数不再被支持，改用 q.op 参数。这个选项已经被弃用了几个版本。
 *  模式中的 defaultSearchField 参数不再被支持，改用 df 参数。这个选项已经被弃用了几个版本。
 *  mergePolicy、mergeFactor 和 maxMergeDocs 参数已被删除并不再支持。你应该定义一个 mergePolicyFactory。
 *  PostingsSolrHighlighter 已被弃用。建议您改为使用 UnifiedHighlighter。
 *  索引时间提升已经从 Lucene 中删除，并且不再可以从 Solr 获得。如果提供了任何提升，它们将被索引链忽略。作为替代，索引时间评分因子应该在单独的字段中编入索引，并使用函数查询与查询评分相结合。
 *  StandardRequestHandler 已被弃用，改为使用 SearchHandler。
 *  为了提高集合 API 参数的一致性，MOVEREPLICA 命令和源的参数名称为 fromNode，REPLACENODE 命令中的 target 已被弃用，取而代之的是 sourceNode和 targetNode。旧名称将继续为后向兼容工作，但他们将在 Solr 8 中被删除。
 *  未使用的 valType 选项已从 ExternalFileField 中删除，如果在模式中有这个选项，则可以安全地删除它。