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/system
或solr/<core>/admin/system
),这将包括所有系统级别信息和有关服务请求的特定核心的附加信息。
线程:返回有关所有JVM线程的信息。
API端点 | 类和Javadocs | 参数集 |
---|---|---|
v1: solr/admin/info/threads v2: api/node/threads |
ThreadDumpHandler | _ADMIN_THREADS |
分析处理器
文档分析:返回给定文档的分析过程分解。
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 | { |
如何编辑隐式处理器参数集
由于隐式请求处理器不存在于solrconfig.xml
中,可以通过使用上表中列出的参数集的请求参数API来编辑其关联的default
、invariant
和appends
参数的配置。
但是,不能修改其他参数,包括SearchHandler组件。
隐式配置中指定的不变量和附加项无法被覆盖。