Solr配置:隐式请求处理器详解

Solr自带许多开箱即用的请求处理器,它们被称为隐式的,因为在你能够使用它们之前不需要在solrconfig.xml中配置它们。

这些处理器具有预定义的默认参数,称为参数集,如有必要可以修改。

可用的隐式端点

注意:下面列出的所有端点路径都应放在Solr的主机和端口(如果使用端口)之后以构造URL。

管理处理器

这些处理器中的许多在整个Admin UI中使用,以显示有关Solr的信息。

文件:返回${solr.home}/conf/中文件的内容。
此处理器必须在端点路径中包含集合名称。

API端点 类和Javadocs 参数集
solr/<collection>/admin/file ShowFileRequestHandler _ADMIN_FILE

健康检查:报告节点的健康状况(仅在SolrCloud模式下可用

API端点 类和Javadocs 参数集
v1: solr/admin/info/health
v2: api/node/health
HealthCheckHandler

此端点还接受其他请求参数。
详情请参见Javadocs

日志记录:检索和修改注册的记录器。

API端点 类和Javadocs 参数集
v1: solr/admin/info/logging
v2: api/node/logging
LoggingHandler _ADMIN_LOGGING

Luke:公开内部Lucene索引。
此处理器必须在端点路径中包含集合名称。

文档Luke请求处理器

API端点 类和Javadocs 参数集
solr/<collection>/admin/luke LukeRequestHandler _ADMIN_LUKE

MBeans:提供有关所有注册SolrInfoMBeans的信息。
此处理器必须在端点路径中包含集合名称。

文档MBean请求处理器

API端点 类和Javadocs 参数集
solr/<collection>/admin/mbeans SolrInfoMBeanHandler _ADMIN_MBEANS

Ping:健康检查。
此处理器必须在端点路径中包含集合名称。

文档Ping

API端点 类和Javadocs 参数集
solr/<collection>/admin/ping PingRequestHandler _ADMIN_PING

插件:返回有关所有注册插件的信息。
此处理器必须在端点路径中包含集合名称。

API端点 类和Javadocs 参数集
solr/<collection>/admin/plugins PluginInfoHandler None.

系统属性:返回JRE系统属性。

API端点 类和Javadocs 参数集
v1: solr/admin/info/properties
v2: api/node/properties
PropertiesRequestHandler _ADMIN_PROPERTIES

:返回最后提交生成的Lucene索引段信息。

API端点 类和Javadocs 参数集
solr/<collection>/admin/segments SegmentsInfoRequestHandler _ADMIN_SEGMENTS

系统信息:返回服务器统计信息和设置。

文档系统信息处理器

API端点 类和Javadocs 参数集
v1: solr/admin/info/system
v2: api/node/system
SystemInfoHandler _ADMIN_SYSTEM

此端点还可以在路径中包含集合或核心名称(solr/<collection>/admin/systemsolr/<core>/admin/system),这将包括所有系统级别信息和有关服务请求的特定核心的附加信息。

线程:返回有关所有JVM线程的信息。

API端点 类和Javadocs 参数集
v1: solr/admin/info/threads
v2: api/node/threads
ThreadDumpHandler _ADMIN_THREADS

分析处理器

文档分析:返回给定文档的分析过程分解。

文档AnalysisRequestHandler

API端点 类和Javadocs 参数集
solr/<collection>/analysis/document DocumentAnalysisRequestHandler _ANALYSIS_DOCUMENT

字段分析:返回给定字段/字段类型的索引时和查询时分析。
此处理器驱动Solr Admin UI中的分析界面

API端点 类和Javadocs 参数集
solr/<collection>/analysis/field FieldAnalysisRequestHandler _ANALYSIS_FIELD

配置处理器

Config API:检索和修改Solr配置。

文档Config API

API端点 类和Javadocs 参数集
v1: solr/<collection>/config
v2: api/collections/<collection>/config
SolrConfigHandler _CONFIG

Dump:将请求内容回显给客户端。

API端点 类和Javadocs 参数集
solr/debug/dump DumpRequestHandler _DEBUG_DUMP

复制:为SolrCloud恢复和用户管理集群索引分发复制索引。
此处理器必须在端点路径中包含核心名称。

API端点 类和Javadocs 参数集
solr/<core>/replication ReplicationHandler _REPLICATION

Schema API:检索和修改Solr schema。

文档Schema API

API端点 类和Javadocs 参数集
v1: solr/<collection>/schema, solr/<core>/schema
v2: api/collections/<collection>/schema, api/cores/<core>/schema
SchemaHandler _SCHEMA

查询处理器

导出:导出完整排序的结果集。

文档导出结果集

API端点 类和Javadocs 参数集
solr/<collection>/export ExportHandler _EXPORT

实时获取:低延迟检索文档的最新版本。

文档实时获取

API端点 类和Javadocs 参数集
solr/<collection>/get RealTimeGetHandler _GET

图遍历:从gatherNodes流表达式返回GraphML格式的输出。

文档图遍历

API端点 类和Javadocs 参数集
solr/<collection>/graph GraphHandler _ADMIN_GRAPH

SQL:SQL查询支持。

文档SQL请求处理器

API端点 类和Javadocs 参数集
solr/<collection>/sql SQLHandler _SQL

流表达式:分布式流处理。

文档流请求和响应

API端点 类和Javadocs 参数集
solr/<collection>/stream StreamHandler _STREAM

词条:返回字段的索引词条和包含每个词条的文档数。

文档在请求处理器中使用词条组件

API端点 类和Javadocs 参数集
solr/<collection>/terms SearchHandler _TERMS

更新处理器

更新:添加、删除和更新格式化为SolrXML、CSV、SolrJSON或javabin的索引文档。

文档使用更新处理器索引

API端点 类和Javadocs 参数集
solr/<collection>/update UpdateRequestHandler _UPDATE

CSV更新:添加和更新CSV格式的文档。

文档CSV更新便捷路径

API端点 类和Javadocs 参数集
solr/<collection>/update/csv UpdateRequestHandler _UPDATE_CSV

JSON更新:添加、删除和更新SolrJSON格式的文档。

文档JSON更新便捷路径

API端点 类和Javadocs 参数集
solr/<collection>/update/json UpdateRequestHandler _UPDATE_JSON

自定义JSON更新:添加和更新自定义JSON格式的文档。

文档转换和索引自定义JSON

API端点 类和Javadocs 参数集
solr/<collection>/update/json/docs UpdateRequestHandler _UPDATE_JSON_DOCS

如何查看隐式处理器参数集

你可以通过Config API查看所有请求处理器的配置,包括隐式请求处理器。

要在响应中包含展开的参数集,以及通过将参数集参数与内置参数合并得到的有效参数,请使用expandParams请求参数。

例如,对于/export请求处理器,你可以发出这样的请求:

V1 API

1
http://localhost:8983/solr/gettingstarted/config/requestHandler?componentName=/export&expandParams=true

V2 API

1
http://localhost:8983/api/collections/gettingstarted/config/requestHandler?componentName=/export&expandParams=true

响应将类似于:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
{
"config": {
"requestHandler": {
"/export": {
"class": "solr.ExportHandler",
"useParams": "_EXPORT",
"components": ["query"],
"defaults": {
"wt": "json"
},
"invariants": {
"rq": "{!xport}",
"distrib": false
},
"name": "/export",
"_useParamsExpanded_": {
"_EXPORT": "[NOT AVAILABLE]"
},
"_effectiveParams_": {
"distrib": "false",
"omitHeader": "true",
"wt": "json",
"rq": "{!xport}"
}
}
}
}
}

如何编辑隐式处理器参数集

由于隐式请求处理器不存在于solrconfig.xml中,可以通过使用上表中列出的参数集的请求参数API来编辑其关联的defaultinvariantappends参数的配置。
但是,不能修改其他参数,包括SearchHandler组件。
隐式配置中指定的不变量和附加项无法被覆盖。

© 2025 Solr Community of China All Rights Reserved. 本站访客数人次 本站总访问量
Theme by hiero