发布：2022/6/20 20:28:34作者：管理员 来源：本站 浏览次数：1151

一、Solr 安装

在 Unix 兼容或 Windows 服务器上安装 Solr 通常需要简单地提取（或解压）下载包。请务必在Solr 安装前准备好运行必备环境（如：JDK ），在准备安装必备环境时需要注意环境版本是否与你所安装的 Solr 兼容 Solr 系统要求（文档选用8.11版本）。

番外篇：很多人在安装 Solr 会纠结 Tomcat 和 Jetty 怎么选，都说 Solr 内置的 Jetty 不稳定有问题；我就想说就你们用到的那点功能 Jetty 要真有问题也响应不到你们，在说了要是 Jetty 真有问题 Solr 官方也不会选用，如果你领导还是说 Jetty 不行，你就把这个给你领导看Google 为 App Engine 选择了 Jetty；不过又说回来选择用什么就因人而异，用着顺手开心就行。
1、下载 Solr 安装包

Solr 可从 Solr 网站获得：最新版 Solr 下载。
也可以直接使用 Linux 命令下载： wget https://downloads.apache.org/lucene/solr/8.11.0/solr-8.11.0.tgz。

有三个独立的包：

    solr-8.11.0.tgz 适用于 Linux/Unix/OSX 系统

    solr-8.11.0.zip 适用于 Microsoft Windows 系统

    solr-8.11.0-src.tgz包 Solr 源代码。如果您想在不使用官方 Git 存储库的情况下在 Solr 上进行开发，这将非常有用。

2、准备安装

将下载好的 Solr 压缩包解压就行。

解压后目录布局

    bin

    此目录中包含几个重要的脚本，这些脚本将使使用 Solr 更容易。
        solr 和 solr.cmd

        这是 Solr 的控制脚本，也称为 bin/solr（对于 * nix）或者 bin/solr.cmd（对于 Windows）。这个脚本是启动和停止 Solr 的首选工具。您也可以在运行 SolrCloud 模式时创建集合或内核、配置身份验证以及配置文件。
        post

        Post Tool，它提供了用于发布内容到 Solr 的一个简单的命令行界面。
        solr.in.sh 和 solr.in.cmd

        这些分别是为 * nix 和 Windows 系统提供的属性文件。在这里配置了 Java、Jetty 和 Solr 的系统级属性。许多这些设置可以在使用 bin/solr 或者 bin/solr.cmd 时被覆盖，但这允许您在一个地方设置所有的属性。
        install_solr_services.sh

        该脚本用于 * nix 系统以安装 Solr 作为服务。在 “将 Solr 用于生产 ” 一节中有更详细的描述。
    contrib

    Solr 的 contrib 目录包含 Solr 专用功能的附加插件。
    dist

    该 dist 目录包含主要的 Solr .jar 文件。
    docs

    该 docs 目录包括一个链接到在线 Javadocs 的 Solr。
    example

    该 example 目录包括演示各种 Solr 功能的几种类型的示例。有关此目录中的内容的详细信息，请参阅下面的 Solr 示例。
    licenses

    该 licenses 目录包括 Solr 使用的第三方库的所有许可证。
    server

    此目录是 Solr 应用程序的核心所在。此目录中的 README 提供了详细的概述，但以下是一些特点：

        Solr 的 Admin UI（server/solr-webapp）

        Jetty 库（server/lib）

        日志文件（server/logs）和日志配置（server/resources）。有关如何自定义 Solr 的默认日志记录的详细信息，请参阅配置日志记录一节。

        示例配置（server/solr/configsets）

2、启动 Solr

我们下载的 Solr 文件都会带有实例。可以直接运行启动，或者也可以自己重新创建核心。Solr 创建核心命令为  ./solr create -c active。启动命令为 ./solr start （默认端口为8983），端口也可以自定义 ./solr start -p 8888 这样端口就为8888了。运行顺序为启动 Sol r项目，然后再创建 Solr 核心。

如果启动成功后远程依然无法访问服务说明服务器防火墙没有关。

在使用命令创建核心的时候可能会出现以下错误

这个时候只需要在创建命令后加-force强制创建接口。如：./solr create -c test_core -force

番外篇：除了使用 ./solr create -c <name> 命令创建核心以外还可以通过启动后的 Solr Admin UI 窗口创建和通过 API 的方式创建。Solr Admin UI - Core Admin 创建经常出错不推荐使用。

通过 API 创建核心：通过 API 创建核心必须在 SolrCloud 模式下启动 Solr 才行

name：collection(索引)名称，也可以理解为核心名称

numShards：分片数

replicationFactor：每个分片的复本数

maxShardsPerNode：每个Solr服务器节点上最大分片数(Solr 4.2新增)

collection.configName：使用的配置文件名
4、Solr 配置安全验证

由于启动后默认是不用登入即可访问 Solr 管理界面，这样暴露了Solr核心库，易引起他人删除索引库数据，故配置登入权限才可访问 Solr 管理界面，步骤如下

1、新建配置文件security.json

创建该 security.json 文件并将其放在 $SOLR_HOME 您的安装目录中（这与您所在的位置相同solr.xml，通常为 server/solr ）。以下配置用户名密码是：solr:SolrRocks

用户的增删改：

请求方式：post，Content-Type:application/json

请求路径：http://已有用户名:密码@127.0.0.1:8983/solr/admin/authentication
注意：用户名和密码尽量不要带特殊字符，否则使用地址栏传用户名密码的时候访问不了

配置说明：

在这个文件中定义了几件事：
1    启用了基本身份验证和基于规则的授权插件。
2    该参数"blockUnknown":true表示不允许未经身份验证的请求通过。
3    'SolrRocks'已经定义了一个名为“solr”的用户，并带有密码。
4    我们覆盖该realm属性以在登录提示上显示另一个文本。
5    该参数"forwardCredentials":false表示我们让 Solr 的 PKI 身份验证处理分布式请求，而不是转发 Basic Auth 标头。
6    'admin' 角色已被定义，它有权编辑安全设置。
7    'solr' 用户已被定义为 'admin' 角色。

完成 Solr 安全验证配置后重新启动 Solr 就需要登录账号密码了。
5、AdminUI 简单使用

访问方式 http://ip:端口号/solr

使用 Solr AdminUI 管理用户界面

查询页面参数说明

1、基本查询
参数    意义
q    查询的关键字，此参数最为重要，例如，q=id:1，默认为q=:，
fl    指定返回哪些字段，用逗号或空格分隔，注意：字段区分大小写，例如，fl= id,title,sort
start    返回结果的第几条记录开始，一般分页用，默认0开始
rows    指定返回结果最多有多少条记录，默认值为 10，配合start实现分页
sort    排序方式，例如id desc 表示按照 “id” 降序
wt    (writer type)指定输出格式，有 xml, json, php等
fq    （filter query）过虑查询，提供一个可选的筛选器查询。返回在q查询符合结果中同时符合的fq条件的查询结果，例如：q=id:1&fq=sort:[1 TO 5]，找关键字id为1 的，并且sort是1到5之间的。
df    默认的查询字段，一般默认指定。
qt    （query type）指定那个类型来处理查询请求，一般不用指定，默认是standard。
indent    返回的结果是否缩进，默认关闭，用 indent=true
version    查询语法的版本，建议不使用它，由服务器指定默认值。

2、Solr 的检索运算符
符号    意义
“:”    指定字段查指定值，如返回所有值:
“?”    表示单个任意字符的通配
“*”    表示多个任意字符的通配（不能在检索的项开始使用*或者?符号）
“~”    表示模糊检索，如检索拼写类似于”roam”的项这样写：roam~将找到形如foam和roams的单词；roam~0.8，检索返回相似度在0.8以上的记录。
AND ||    布尔操作符
OR、&&    布尔操作符
NOT、!、-    （排除操作符不能单独与项使用构成查询）
“+”    存在操作符，要求符号”+”后的项必须在文档相应的域中存在²
( )    用于构成子查询
[]    包含范围检索，如检索某时间段记录，包含头尾，date:[201507 TO 201510]
{}    不包含范围检索，如检索某时间段记录，不包含头尾date:{201507 TO 201510}

3、高亮
符号    意义
h1    

    是否高亮，hl=true，表示采用高亮

hl.fl    

    设定高亮显示的字段，用空格或逗号隔开的字段列表。要启用某个字段的highlight功能，就得保证该字段在schema中是stored。如果该参数未被给出，那么就会高亮默认字段 standard handler会用df参数，dismax字段用qf参数。你可以使用星号去方便的高亮所有字段。如果你使用了通配符，那么要考虑启用hl.requiredFieldMatch选项。

hl.requireFieldMatch    

    如果置为true，除非用hl.fl指定了该字段，查询结果才会被高亮。它的默认值是false。

hl.usePhraseHighlighter    

    如果一个查询中含有短语（引号框起来的）那么会保证一定要完全匹配短语的才会被高亮。

hl.highlightMultiTerm    

    如果使用通配符和模糊搜索，那么会确保与通配符匹配的term会高亮。默认为false，同时hl.usePhraseHighlighter要为true。

hl.fragsize    -返回的最大字符数。默认是100.如果为0，那么该字段不会被fragmented且整个字段的值会被返回。

4、分组（Field Facet）

facet 参数字段必须被索引，facet=on 或 facet=true
符号    意义
facet.field    分组的字段
facet.prefix    表示Facet字段前缀
facet.limit    Facet字段返回条数
facet.offict    开始条数,偏移量,它与facet.limit配合使用可以达到分页的效果
facet.mincount    Facet字段最小count,默认为0
facet.missing    如果为on或true,那么将统计那些Facet字段值为null的记录
facet.sort    表示 Facet 字段值以哪种顺序返回 .格式为 true(count)|false(index,lex)，true(count) 表示按照 count 值从大到小排列，false(index,lex) 表示按照字段值的自然顺序 (字母 , 数字的顺序 ) 排列 . 默认情况下为 true(count)

5、分组（Date Facet）

对日期类型的字段进行 Facet. Solr 为日期字段提供了更为方便的查询统计方式 .注意 , Date Facet的字段类型必须是 DateField( 或其子类型 ). 需要注意的是 , 使用 Date Facet 时 , 字段名 , 起始时间 , 结束时间 , 时间间隔这 4 个参数都必须提供 。
符号    意义
facet.date    该参数表示需要进行 Date Facet 的字段名 , 与 facet.field 一样 , 该参数可以被设置多次 , 表示对多个字段进行 Date Facet.
facet.date.start    起始时间 , 时间的一般格式为 ” 2015-12-31T23:59:59Z”, 另外可以使用 ”NOW”,”YEAR”,”MONTH” 等等 ,
facet.date.end    结束时间
facet.date.gap    时间间隔,如果 start 为 2015-1-1,end 为 2016-1-1，gap 设置为 ”+1MONTH” 表示间隔1 个月 , 那么将会把这段时间划分为 12 个间隔段 .
facet.date.hardend    表示 gap 迭代到 end 时，还剩余的一部分时间段，是否继续去下一个间隔. 取值可以为 true
6、番外篇 Solr+Tomcat

1、如果你选用 Tomcat 就将解压后 \solr-8.11.0\server\solr-webapp 目录下的 webapp 整个文件夹复制到下载安装好的 Tomcat 中，并将 webapp 文件夹改名为 solr（想叫其它名也可以）。

2、在将解压后 \solr-8.11.0\server\lib\ext 全部 jar 包和 \server\lib 下 merteics 和 http2 为前缀的 jar 包全部 copy 到 Tomcat 的 webapp\solr\WEB-INF\lib 下。

3、创建新的 Solr 核心（也可以用自带的）拷贝解压后 \solr-8.11.0\server\solr 目录下的所有内容或只拷贝 \solr-8.11.0\server\solr\configsets\_default 下的 conf 文件夹到你的新位置，在将新位置文件夹重命名为 active（名字可以自定义），这样就完成了新核心创建。

4、配置 Tomcat 下 webapps\solr\WEB-INF 中的 web.xml

5、将 web.xml 中的权限验证 注释掉就行

6、如果要增加账号密码验证就忽略第5步，首先在 tomcat/conf 下的 tomcat-users.xml 文件中增加以下代码

在 webapps/solr/WEB-INF/web.xml 文件权限验证配置后增加以下代码

7、启动 Tomcat 访问http://localhost:8080/solr/index.html
二、Solr 基本配置

在 Solr 中有几个配置文件，您将在执行过程中与之交互。
这些文件中的很多都是 XML 格式的，尽管与配置设置交互的 API 在需要时往往接受 JSON 以进行编程访问。

    solr.xml 指定 Solr 服务器实例的配置选项。有关 solr.xml 请参阅Solr 核心和 solr.xml 的更多信息。

    每个 Solr 核心：

        core.properties 定义每个核心的特定属性，例如其名称、核心所属的集合、模式的位置和其他参数。有关更多详细信息 core.properties，请参阅定义 core.properties部分。

        solrconfig.xml 控制高层行为。例如，您可以为数据目录指定一个备用位置。有关更多信息 solrconfig.xml，请参阅配置 solrconfig.xml。

        managed-schema（或 schema.xml 改为）描述您将要求 Solr 索引的文档。Schema 将文档定义为字段的集合。您可以定义字段类型和字段本身。字段类型定义功能强大，包括有关 Solr 如何处理传入字段值和查询值的信息。有关 Solr 架构的更多信息，请参阅文档、字段和架构设计以及架构 API。

        data/ 包含低级索引文件的目录。

1、 域中常用标签介绍

域（managed-schema）相当于数据库的表字段，用户存放数据，因此用户根据业务需要去定义相关的Field（域），一般来说，每一种对应着一种数据，用户对同一种数据进行相同的操作。
域的常用属性：

    name：指定域的名称
    type：指定域的类型
    indexed：是否索引
    stored：是否存储
    required：是否必须
    multiValued：是否多值

1、域（managed-schema）

Solr中默认定义唯一主键key为id域

Solr在删除、更新索引时使用id域进行判断，也可以自定义唯一主键。
注意在创建索引时必须指定唯一约束

2、copyField （复制域）
copyField复制域，可以将多个Field复制到一个Field中，以便进行统一的检索。
比如，根据关键字只搜索 item_keywords 域的内容就相当于搜索 name、content，即将 name、content 复制到 item_keywords 域中。
目标域必须是多值的。

3、dynamicField（动态字段）
动态字段就是不用指定具体的名称，只要定义字段名称的规则，例如定义一个 dynamicField，name 为*_i，定义它的 type 为 text，那么在使用这个字段的时候，任何以_i结尾的字段都被认为是符合这个定义的，例如：name_i，gender_i，school_i等。
自定义 Field 名为：product_title_t，“product_title_t” 和 managed-schema 文件中的 dynamicField 规则匹配成功。
2、Solr 添加中文分词器

其实 Solr 已经自带了中文分词器 lucene-analyzers-smartcn 在解压后 \solr-8.11\solr-8.11.0\contrib\analysis-extras\lucene-libs 目录下 lucene-analyzers-smartcn.jar 这就是 Solr 自带的中文分词器，我们只需要将该文件拷贝到 Solr 服务 Jetty 或 Tomcat 的 webapp/WEB-INF/lib/ 目录下就可以了。

在你指定 Solr 核心的 conf 目录下 managed-schema 文件中添加以下内容就ok了

如果你觉得 Solr 自带的中文分词器满足不了你预期的分词效果，那你也可以添加外部的分词器。
首先我们先去下载你要添加的外部分词器IK 分词器下载（ik-analyzer-solr）。
在将该文件拷贝到 Solr 服务 Jetty 或 Tomcat 的 webapp/WEB-INF/lib/ 目录下，最后配置在     managed-schema 文件中添加以下内容就ok了

最后在 managed-schema 文件中给要分词的字段指定分词器

注意：indexed="true"，solr默认下content这个字段的indexed的值是false，需要改成true，在搜索时这个字段才能用到上面的分词器。

配置完重启 Solr 就 ok 了。
3、Solr 配置数据库

1、配置数据源

如果想要导入数据库，需要将相应的数据库驱动的 jar 包导入到 Solr 服务 Jetty 或 Tomcat 的 webapp/WEB-INF/lib/ 目录下。
然后在你自己的核心源文件夹打开 conf 文件夹，我们需要配置 solrconfig.xml，managed-schema 文件增加一个数据库配置文件。

2、配置 solrconfig.xml

数据库 Solr 的 jar 包引入，找到对应配置位置加入如下配置，在 solrconfig.xml 文件75行左右。

增加数据源配置 xml 文件，找到 name 为 /select 的 requestHandler 节点，在上面加入以下配置，其中 config 里面为数据源配置文件名字。

在 Solr 核心 conf 文件夹下新增配置数据源的 xml 文件（也就是 solrconfig.xml 文件中 name 为 /dataimport 的 requestHandler 节点中 config 指定的文件）。

    dataSource：中配置数据库数据
    type：为类型
    driver：为对应数据库的驱动类
    url：为数据库地址
    user：为数据库账户
    password：为数据库密码
    entity：为需要的查询数据源语句

其中 entity 节点下 field 为查出的数据需要向 Solr 中存储的字段已经对应存入到 Solr 中的字段名称。

最后记得修改 Solr 核心 core/conf 目录下 managed-schema 文件 <field/> 标签，新增需要索引的列。

完成所有配置后记得要重启 Solr 服务。
4、Solr 配置全量更新

完成以上第2步数据源配置后，直接在 Solr AdminUI 管理页面就行数据全量更新就行了。

5、Solr 配置增量更新

在做数据增量更新时，需要做增量更新的数据源表几个增量必要条件必须存在。

    如果只涉及添加，与修改业务，那么数据库里只需额外有一个 timpstamp 字段就可以了，默认值为当前系统时间，CURRENT_TIMESTAMP。
    如果还涉及删除业务，那么数据里就需额外再多添加一个字段 isdelete，int 类型的用0,1来标识，此条记录是否被删除。

增量更新就是在全量更新的基础上加上一些配置：

    query：查询数据库表符合记录数据。
    deltaQuery：增量索引查询主键ID，注意这个只能返回ID字段。
    deltaImportQuery：增量索引查询导入数据。
    deletedPkQuery：增量索引删除主键ID查询。

完成配置在 Solr AdminUI 管理页面就行数据增量更新就行了

 如果以上配置还不满足你的需求，那就请看使用数据导入处理程序上传结构化数据存储数据官方文档。
三、Java API SolrJ 的使用
1、SolrJ 简介

SolrJ 是操作 Solr 的 Java 客户端，它提供了增加、修改、删除、查询 Solr 索引的 Java 接口。通过 SolrJ 提供的 API 接口来操作 Solr 服务，SolrJ 底层是通过使用 httpClient 中的方法来完成 Solr的操作。
2、SolrJ 核心类 SolrClient

SolrClient 有一些具体的实现，每个实现都针对不同的使用模式或弹性模型：

    HttpSolrClient- 面向以查询为中心的工作负载，但也是一个很好的通用客户端。直接与单个 Solr 节点通信。

    Http2SolrClient- 利用 HTTP/2 的异步、非阻塞和通用客户端。这个类是实验性的，因此它的 API 可能会在 SolrJ 的次要版本中更改或删除。

    LBHttpSolrClient- 在 Solr 节点列表之间平衡请求负载。根据节点健康状况调整“服务中”节点列表。

    LBHttp2SolrClient- 就像 LBHttpSolrClient 而是使用 Http2SolrClient。这个类是实验性的，因此它的 API 可能会在 SolrJ 的次要版本中更改或删除。

    CloudSolrClient- 面向与 SolrCloud 部署通信。使用已经记录的 ZooKeeper 状态来发现请求并将其路由到健康的 Solr 节点。

    ConcurrentUpdateSolrClient- 面向以索引为中心的工作负载。在将更大的批次发送到 Solr 之前在内部缓冲文档。

    ConcurrentUpdateHttp2SolrClient- 就像 ConcurrentUpdateSolrClient 而是使用 Http2SolrClient。这个类是实验性的，因此它的 API 可能会在 SolrJ 的次要版本中更改或删除。

SolrJ 所有 API 接口Solr 8.11.0 solr-solrj API。
3、SolrClient 类的简单使用（增删改查）

在使用前先引入 SolrJ 依赖

1、添加文档

2、更新文档(其实更新的内容不存在则是新增)

3、查询单个

4、多条件查询带分页

5、删除文档
4、SolrJ 整合 Spring Boot

1、引入 Maven 依赖

2、配置 yml 文件

持续更新中。。。。。。（有时间了就写一点）