# Solr配置详解
## 1. 目录结构说明
```properties
bin: Solr控制台管理工具存在该目录下。如：solr 等。
contrib: 该文件包含大量关于Solr的扩展。
dist: 在这里能找到Solr的核心JAR包和扩展JAR包。当我们试图把Solr嵌入到某个应用程序的时候会用 到核心JAR包。
docs: 该文件夹里面存放的是Solr文档，离线的静态HTML文件，还有API的描述。
example: 包含Solr的简单示例。
licenses: 各种许可和协议。
server: solr应用程序的核心,SolrCore核心必要文件都存放在这里。
```
```properties
#contrib
analysis-extras: 该目录下面包含一些相互依赖的文本分析组件 分词器相关。
clustering: 该目录下有一个用于集群检索结果的引擎。
dataimporthandler: DIH是Solr中一个重要的组件，该组件可以从数据库或者其他数据源导入数据到 Solr中。 dataimporthandler-extras: 这里面包含了对DIH的扩展。
extraction: 集成Apache Tika，用于从普通格式文件中提取文本。
langid: 该组件使得Solr拥有在建索引之前识别和检测文档语言的能力。
prometheus-exporter: 采集监控数据并通过prometheus监控 solr监控相关。 velocity：包含一个基于Velocity: 模板语言简单检索UI框架。
```
```properties
#server
contexts: 启动Solr的Jetty的上下文配置。
etc: Jetty服务器配置文件，在这里可以把默认的8983端口改成其他的。
lib: Jetty服务器程序对应的可执行JAR包和响应的依赖包。
logs: 默认情况下，日志将被输出到这个文件夹。
modules: http\https\server\ssl等配置模块。
resources: 存放着Log4j的配置文件。这里可以改变输出日志的级别和位置等设置。
scripts: Solr运行的必要脚本。
solr: 运行Solr的配置文件都保存在这里。solr.xml文件,zoo.cfg文件，使用SolrCloud的时候有 用。子文件 夹configsets存放着Solr的示例配置文件。每创建一个核心Core都会在server目录下生 成相应的core 名称 目录。 solr-webapp：Solr的平台管理界面的站点就存放在这里。
tmp: 存放临时文件。
```
## 2. SolrCore结构
SolrCore内核：是运行在Solr服务器中的具体唯一命名的、可管理和可配置的索引，即内核就是Lucene中说到的索引。一台solr服务器可以托管一个或多个内核
```properties
#core.properties
#Written by CorePropertiesLocator
#Mon Jun 27 07:43:33 UTC 2022
name=qiang_core_1
config=solrconfig.xml
schema=schema.xml
dataDir=data
```
## 3. solrconfig.xml
这个文件是来配置SolrCore实例的相关信息。如果使用默认配置可以不用做任何修改。它里面包含了很多标签，例如：lib标签、dataDir标签、requestHandler标签等
- lib标签
在solrconfifig.xml中可以加载一些扩展的jar,如果需要使用，则首先要把这些jar复制到指定的目录，比
如把安装包中的contrib和dist文件夹, 复制到SolrHome同级目录下 需要把 `../../../.. `修改为
`../..`
然后修改solrconfig.xml配置文件中加载扩展的jar路径
- dataDir标签
配置SolrCore的data目录.data目录用来存放SolrCore的索引文件和tlog日志文件
```xml
${solr.data.dir:}
```
- directoryFactory
```xml
索引存储方案，共有以下存储方案:
1、solr.StandardDirectoryFactory,这是一个基于文件系统存储目录的工厂，它会试图选择最 好的实现基于你当前的操作系统和Java虚拟机版本。
2、solr.SimpleFSDirectoryFactory,适用于小型应用程序，不支持大数据和多线程。
3、solr.NIOFSDirectoryFactory,适用于多线程环境，但是不适用在windows平台（很慢），是因为JVM还存在bug。
4、solr.MMapDirectoryFactory,这个是solr3.1到4.0版本在linux64位系统下默认的实现。它是通过使用虚拟内存和内核特性调用 mmap去访问存储在磁盘中的索引文件。它允许lucene或solr直接访问I/O缓存。如果不需要近实时 搜索功能，使用此工厂是个不错的方案。
5、solr.NRTCachingDirectoryFactory,此工厂设计目的是存储部分索引在内存中，从而加快了 近实时搜索的速度。
6、solr.RAMDirectoryFactory,这是一个内存存储方案，不能持久化存储，在系统重启或服务器 crash时数据会丢失。且不支持索引复制
```
- luceneMatchVersion
```xml
7.7.3
solr 版本
```
- indexConfig
用于设置索引的底层的属性
```xml
1000
8// false//solr默认为false。如果为true,索引文件减少, 检索性能降低,追求平衡。
100 1000 10 10 //合并策略。 10//合并因子,每次合并多少个segments。 //合并调度器。
${solr.lock.type:native}//锁工厂。 false//是否启动时先解锁。 128//Luceneloads terms into memory 间隔 true//重新打开,替代先关闭-再打开。
//提交删除策略,必须实现org.apache.lucene.index.IndexDeletionPolicy 1 0 30MINUTES OR 1DAY
false//相当于把创建索引时的日志输 出。${solr.lock.type:native}
```
- updateHandler
```xml
${solr.ulog.dir:}
${solr.ulog.numVersionBuckets:65536}
${solr.autoCommit.maxTime:15000}
false
5000
其中硬提交是提交数据持久化到磁盘里面，并且能够查询到这条数据。 软提交是提交数据到内存里面，并没有持久化到磁盘，但是他会把提交的记录写到tlog的日志文件里面
```
- query
```xml
1024
true
50
false
```
- requestHandler
requestHandler请求处理器，定义了索引和搜索的访问方式
通过/update维护索引，可以完成索引的添加、修改、删除操作
```xml
true
ignored_
_text_
```
设置搜索参数完成搜索，搜索参数也可以设置一些默认值，如下：
```xml
explicit
10
false
explicit
json
true
text
```
## 4. schema.xml
Schema：模式，是内核中字段的定义，让solr知道内核包含哪些字段、字段的数据类型、字段对应的索引存储
Solr中提供了两种方式来配置schema，两者只能选其一
- 默认方式，通过Schema API 来实时配置，模式信息存储在内核目录的conf/managed-schema 文件中，一般使用这种方式，特别是在SolrCloud模式下。
- 传统的手工编辑内核 schema.xml的方式，编辑完后需重载集合/内核才会生效。
两种方式之间是可以切换的，比如用于升级操作，从旧版本到新版本的升级，切换方式如下：
```\
手动编辑切换到API方式： 只需将solrconfig.xml中的去掉，或改为ManagedIndexSchemaFactory。Solr重启 时，它发现之前存储在schema.xml中但没有存储在 managed-schema中，则它会备份schema.xml，然 后改写schema.xml为managed-schema。此后就可以通过Schema API 管理schema了
API切换到手动编辑方式： 首先将managed-schema重命名为schema.xml；然后将solrconfig.xml中 schemaFactory 的ManagedIndexSchemaFactory去掉（如果存在）或者改为 ClassicIndexSchemaFactory
```
- managed-schema
Solr启动一个服务器实例后，会内置了很多fifield字段、唯一ID、fifieldType字段类型等，这些信息都是在managed-schema文件中定义的。我们先了解下managed-schema文件的大致结构：
```xml
id
```
- field
```xml
```
```properties
name:属性的名称。
type:字段的数据结构类型，所用到的类型需要在fieldType中设置。
default:默认值。
indexed:是否创建索引只有index=true 的字段才能做facet.field的字段，同时只有index=true该 字段才能当做搜索的内容,当然store=true或者false没关系,将不需要被用于搜索的，而只是作为结果返 回的field的indexed设置为false
stored:是否存储原始数据（如果不需要存储相应字段值，尽量设为false）,表示是否需要把域值存储到 硬盘上，方便你后续查询时能再次提取出来原样显示给用户
docValues:表示此域是否需要添加一个 docValues 域，这对 facet 查询， group 分组，排序， function 查询有好处，尽管这个属性不是必须的，但他能加快索引数据加载，对 NRT 近实时搜索比较友 好，且更节省内存，但它也有一些限制，比如当前docValues 域只支持 strField,UUIDField,Trie*Field 等域，且要求域的域值是单值不能是多值域
multValued:是否有多个值，比如说一个用户的所有好友id。（对可能存在多值的字段尽量设置为 true，避免建索引时抛出错误）
omitNorms:此属性若设置为 true ，即表示将忽略域值的长度标准化，忽略在索引过程中对当前域的权 重设置，且会节省内存。只有全文本域或者你需要在索引创建过程中设置域的权重时才需要把这个值设 false, 对于基本数据类型且不分词的域如intFeild,longField,Stre, 否则默认就是 false.
required：添加文档时，该字段必须存在，类似MySQL的not null
termVectors: 设置为 true 即表示需要为该 field 存储项向量信息，当你需要MoreLikeThis 功能 时，则需要将此属性值设为 true ，这样会带来一些性能提升。
termPositions: 是否存储 Term 的起始位置信息，这会增大索引的体积，但高亮功能需要依赖此项设 置，否则无法高亮
termOffsets:表示是否存储索引的位置偏移量，高亮功能需要此项配置，当你使用SpanQuery 时，此 项配置会影响匹配的结果集
field的定义相当重要，有几个技巧需注意一下，对可能存在多值得字段尽量设置 multiValued属性为 true，避免建索引是抛出错误；如果不需要存储相应字段值，尽量将stored属性设为false。
```
- dynamicField(动态域)
```xml
```
**Name**：动态域的名称，是一个表达式，*匹配任意字符，只要域的名称和表达式的规则能够匹配就可以使用。
例如：搜索时查询条件[product_i：钻石]就可以匹配这个动态域，可以直接使用，不用单独再定义一个product_i域。
- uniqueKey
```xml
id
```
相当于主键，每个文档中必须有一个id域。
- copyField(复制域)
```xml
```
可以将多个Field复制到一个Field中，以便进行统一的检索。当创建索引时，solr服务器会自动的将源域的内容复制到目标域中
**source**：源域
**dest**：目标域，搜索时，指定目标域为默认搜索域，可以提高查询效率
定义目标域：
```xml
```
目标域必须要使用：multiValued="true"
- fieldType(域类型)
```xml
```
```properties
name: 域类型名称，用于Field定义中的type属性引用
class: 存放该类型的值来进行索引的字段类名（同lucene中Field的子类）。注意，应以 solr.为前 缀，这样solr就可以很快定位到该到哪个包中去查找类，如 solr.TextField 。如果使用的是第三方包 的类，则需要用全限定名。
positionIncrementGap: 用于多值字段，定义多值间的间隔，来阻止假的短语匹配
autoGeneratePhraseQueries: 用于文本字段，如果设为true，solr会自动对该字段的查询生成短语 查询，即使搜索文本没带“”
synonymQueryStyle: 同义词查询分值计算方式
enableGraphQueries: 是否支持图表查询
analyzer: 指定分词器。在FieldType定义的时候最重要的就是定义这个类型的数据在建立索引和进行查 询的时候要使用的分析器analyzer，包括分词和过滤。
type: index和query。Index 是创建索引，query是查询索引。
tokenizer: 指定分词器
filter: 指定过滤器
```
- 分词器
**solr7自带分词中文分词器**
- 复制jar包
```sh
cp contrib/analysis-extras/lucene-libs/lucene-analyzers-smartcn-7.7.3.jar solr/WEB-INF/lib
```
- 复制新项目的配置文件
```sh
创建solrcore
mkdir solrhome/new_core
cp -r server/solr/configsets/_default/conf solrhome/new_core/
```
- 然后到solrhome/new_core/conf目录中打开managed-schema文件，增加如下代码
```xml
```
- 重启tomcat
- 访问项目,测试分词效果
**IK中文分词器**
- 下载分词器
一般解决分词问题会选择ikanalyzer，因为相对来说ikanalyzer更新的比较的好， solr7 本身提供中文的分词jar包，在此一并讲一下
下载solr7版本的ik分词器，下载地址：http://search.maven.org/#search%7Cga%7C1%7Ccom.github.magese
分词器GitHub源码地址：https://github.com/magese/ik-analyzer-solr7
将下载好的jar包放入 tomcat 对应的项目的 /WEB-INF/lib目录中
- 复制新项目配置文件
```sh
创建solrcore
mkdir solrhome/ik
cp -r server/solr/configsets/_default/conf solrhome/ik/
```
- 然后到server/solr/ik/conf目录中打开managed-schema文件，增加如下代码
```xml
```
- 重启tomcat
- 访问项目
**停用词和同义词**
```xml
停用词
- words属性指定停用词文件的绝对路径或相对solr主目录下conf/目录的相对路径
- 停用词定义语法：一行一个
如:
hello
like
```
```xml
同义词
```
mysynonyms.txt: synonyms属性指定同义词文件的绝对路径或相对solr主目录下conf/目录的相对路径同义词定义语法：一类一行，如下表示，=>表示查询时标准化为后面的内容
```
couch,sofa,divan
teh => the
huge,ginormous,humungous => large
small => tiny,teeny,weeny
瓷器 => 中国
```