Solr Join(加入)示例
本文英文版地址：https://examples.javacodegeeks.com/enterprise-java/apache-solr/solr-join-example/
在Solr Join示例的示例中，我们将讨论如何在Apache Solr中实现文档之间的连接。我们将向您展示如何实现{！join}指定的连接查询解析器插件。 在Solr文档中使用连接，其中反标准化数据是耗时或昂贵的。
为了演示Solr Join用法，我们将使用与Solr安装一起提供的基本配置和索引示例文件在Solr中创建一个核心。
这个例子的首选环境是solr-5.0.0。在开始Solr安装之前，请确保已安装JDK并已正确设置Java_Home。
1.安装Apache Solr
首先，让我们从以下位置下载最新版本的Apache Solr：
http://lucene.apache.org/solr/downloads.html
Apache Solr已经经历了从4.xx到5.0.0的各种更改，因此如果您有不同版本的Solr，则需要下载5.xx版本以遵循此示例。
下载Solr zip文件后，将其解压缩到文件夹中。 提取的文件夹将如下所示：
Solr文件夹
bin文件夹包含用于启动和停止服务器的脚本。 example文件夹包含几个示例文件。 我们将使用其中一个来演示Solr如何对数据进行索引。server文件夹包含用于写入所有Solr日志的logs文件夹。在索引期间检查日志中的任何错误将有所帮助。 服务器下的solr文件夹包含不同的集合或核心。 每个核/集合的配置和数据存储在相应的核/集合文件夹中。
Apache Solr附带了一个内置的Jetty服务器。 但在我们启动solr实例之前，我们必须验证JAVA_HOME是否在机器上设置。
我们可以使用命令行脚本启动服务器。 让我们从命令提示符转到bin目录并发出以下命令：
solr start
这将在默认端口8983下启动Solr服务器。
我们现在可以在浏览器中打开以下URL，并验证我们的Solr实例正在运行。 solr管理工具的具体细节超出了示例的范围。
http://localhost:8983/solr/
Solr管理控制台
2.配置Apache Solr
在本节中，我们将向您展示如何配置solr实例的核心/集合以及如何定义字段。 Apache Solr附带一个名为Schemaless模式的选项。 此选项允许用户构建有效的模式，而无需手动编辑模式文件。但是对于这个例子，我们将使用Schema配置来理解Solr的内部。
2.1创建核心
当Solr服务器在独立模式下启动时，配置称为核心，当在SolrCloud模式下启动时，配置称为集合。在这个例子中，我们将讨论独立的服务器和核心。 我们将暂停SolrCloud讨论以供日后使用。
首先，我们需要创建一个用于索引数据的Core。 Solr create命令有以下选项：
- -c
- 要创建的核心或集合的名称（必需）。 - -d
- 配置目录，在SolrCloud模式下有用。 - -n
- 配置名称。 此默认值与核心或集合的名称相同。 - -p
- 要向其发送create命令的本地Solr实例的端口;默认情况下，脚本尝试通过查找正在运行的Solr实例来检测端口。 - -s
- 将集合拆分为的分片数，默认值为1。 - -rf
- 集合中每个文档的副本数。默认值为1。
在本例中，我们将使用-c参数作为核心名称，使用-d参数作为配置目录。 对于所有其他参数，我们使用默认设置。
现在在命令窗口中导航solr-5.0.0\bin文件夹，并发出以下命令：
solr create -c jcg -d basic_configs
我们可以在命令窗口中看到以下输出。
1 |
|
2 |
|
3 |
4 |
|
5 |
|
6 |
|
7 |
|
8 |
|
现在我们导航到以下URL，我们可以看到jcg core被填充在核心选择器中。 您还可以查看核心的统计信息。
http://localhost:8983/solr
Solr jcg core
2.2修改schema.xml文件
我们需要修改文件夹server\solr\jcg\conf下的schema.xml文件，以包含字段。我们将使用随Solr安装提供的示例文件“vidcard.xml”和“vendors.xml”进行索引。这些文件位于文件夹solr-5.0.0\example\exampledocs.
现在我们导航到文件夹server\solr目录。 您将看到一个名为jcg的文件夹。 子文件夹即conf和data分别具有核心的配置和索引数据。
现在编辑\server\solr\jcg\conf文件夹中的schema.xml文件，并在uniqueKey元素后面添加以下内容。
schema.xml
01 |
<spanclass="notranslate"onmouseover="_tipon(this)"onmouseout="_tipoff()"><spanclass="google-src-text"style="direction: ltr; text-align: left"><uniqueKey>id |
02 |
<spanclass="notranslate"onmouseover="_tipon(this)"onmouseout="_tipoff()"><spanclass="google-src-text"style="direction: ltr; text-align: left"><fieldname="name"type="text_general"indexed="true"stored="true"/> |
03 |
<spanclass="notranslate"onmouseover="_tipon(this)"onmouseout="_tipoff()"><spanclass="google-src-text"style="direction: ltr; text-align: left"><fieldname="manu"type="text_general"indexed="true"stored="true"/> |
04 |
<spanclass="notranslate"onmouseover="_tipon(this)"onmouseout="_tipoff()"><spanclass="google-src-text"style="direction: ltr; text-align: left"><fieldname="manu_id_s"type="text_general"indexed="true"stored="true"/> |
05 |
<spanclass="notranslate"onmouseover="_tipon(this)"onmouseout="_tipoff()"><spanclass="google-src-text"style="direction: ltr; text-align: left"><fieldname="cat"type="text_general"indexed="true"stored="true"multiValued="true"/> |
06 |
<spanclass="notranslate"onmouseover="_tipon(this)"onmouseout="_tipoff()"><spanclass="google-src-text"style="direction: ltr; text-align: left"><fieldname="features"type="text_general"indexed="true"stored="true"multiValued="true"/> |
07 |
<spanclass="notranslate"onmouseover="_tipon(this)"onmouseout="_tipoff()"><spanclass="google-src-text"style="direction: ltr; text-align: left"><fieldname="weight"type="tdouble"indexed="true"stored="true"/> |
08 |
<spanclass="notranslate"onmouseover="_tipon(this)"onmouseout="_tipoff()"><spanclass="google-src-text"style="direction: ltr; text-align: left"><fieldname="price"type="tdouble"indexed="true"stored="true"/> |
09 |
<spanclass="notranslate"onmouseover="_tipon(this)"onmouseout="_tipoff()"><spanclass="google-src-text"style="direction: ltr; text-align: left"><fieldname="popularity"type="tdouble"indexed="true"stored="true"/> |
10 |
<spanclass="notranslate"onmouseover="_tipon(this)"onmouseout="_tipoff()"><spanclass="google-src-text"style="direction: ltr; text-align: left"><fieldname="store"type="text_general"indexed="true"stored="true"/> |
11 |
<spanclass="notranslate"onmouseover="_tipon(this)"onmouseout="_tipoff()"><spanclass="google-src-text"style="direction: ltr; text-align: left"><fieldname="inStock"type="boolean"indexed="true"stored="true"/> |
12 |
<spanclass="notranslate"onmouseover="_tipon(this)"onmouseout="_tipoff()"><spanclass="google-src-text"style="direction: ltr; text-align: left"><fieldname="manufacturedate_dt"type="text_general"indexed="true"stored="true"/> |
我们已将indexed的属性设置为true。 这指定了用于索引的字段，并且可以使用索引检索记录。 将值设置为false将使该字段只存储，但不能查询。
还要注意，我们有另一个属性叫stored并设置为true。 这指定字段存储并可以在输出中返回。 将此字段设置为false将使该字段仅编入索引，并且无法在输出中检索。
由于我们已经修改了配置，我们必须停止和启动服务器。 为此，我们需要通过命令行从bin目录发出以下命令：
solr stop -all
服务器将立即停止。 现在启动服务器通过命令行从bin目录发出以下命令：
solr start
3.索引数据
Apache Solr附带一个名为SimplePostTool的独立Java程序。 该程序打包到JAR中，安装在example\exampledocs文件夹下。
现在，我们导航到命令提示符中的example\exampledocs文件夹，并键入以下命令。您将看到一堆使用该工具的选项。
java -jar post.jar -h
使用格式一般如下：
Usage: java [SystemProperties] -jar post.jar [-h|-] [
[
正如我们前面所说的，我们将索引在Solr安装附带的“vidcard.xml”和“vendors.xml”文件中的数据。我们将在命令提示符中导航到solr-5.0.0\example\exampledocs并发出以下命令。
java -Dtype=application/xml -Durl=http://localhost:8983/solr/jcg/update -jar post.jar vidcard.xml
这里使用的SystemProperties是：
- -Dtype - 数据文件的类型。
- -Durl - jcg核心的URL。
现在将对文件“vidcard.xml”进行索引，并且命令提示符将显示以下输出。
1 |
|
2 |
|
3 |
|
4 |
|
5 |
|
6 |
|
7 |
|
现在，我们将使用以下命令为“vendors.xml”文件中存在的文档创建索引：
java -Dtype=application/xml -Durl=http://localhost:8983/solr/jcg/update -jar post.jar manufacturers.xml
现在将对文件“vendors.xml”进行索引，并且命令提示符将显示以下输出：
1 |
|
2 |
|
3 |
|
4 |
|
5 |
|
6 |
|
7 |
|
4.使用join查询
现在，我们将联接查询来了解graphics card制造商的详细信息。为此，我们需要使用由{!join}语法指定的连接QueryParser（Plugin）。连接使用Solr的LocalParam语法进行处理。
您可以观察到，Solr中的连接并不真正等同于SQL连接，因为没有关于正在连接的表“from”的信息被转发到最终结果中。Solr中的连接与SQL的“内部查询”更紧密相关。
以下连接Query将找到具有类别“graphics card”的所有文档，然后将它们（制造商）文档合并，并返回制造这些产品的制造商的列表。
http://localhost:8983/solr/jcg/select?q={!join+from=manu_id_s+to=id}cat:"graphics card"
Solr联接输出
5.下载配置
这是Solr连接的示例。
您可以在这里下载配置文件： schema.xml