本練習(xí)將介紹如何將 Solr 作為雙節(jié)點(diǎn)群集 (同一計(jì)算機(jī)上的兩個(gè)節(jié)點(diǎn)) 啟動(dòng)，并在啟動(dòng)過(guò)程中創(chuàng)建一個(gè)集合。然后，您將索引一些 Solr 附帶的一些示例數(shù)據(jù)并進(jìn)行一些基本搜索。

在 SolrCloud 模式下啟動(dòng) Solr

要啟動(dòng) Solr，請(qǐng)?jiān)?Unix 或 MacOS 上運(yùn)行：bin/solr start -e cloud；在 Windows 上運(yùn)行：bin\solr.cmd start -e cloud。

這將啟動(dòng)一個(gè)交互式會(huì)話，在您的計(jì)算機(jī)上啟動(dòng)兩個(gè) Solr 服務(wù)器。這個(gè)命令有一個(gè)選項(xiàng)可以在不提示輸入（-noprompt）的情況下運(yùn)行，但是我們要修改兩個(gè)默認(rèn)值，所以我們現(xiàn)在不會(huì)使用這個(gè)選項(xiàng)。

solr-7.0.0:$ ./bin/solr start -e cloud

Welcome to the SolrCloud example!

This interactive session will help you launch a SolrCloud cluster on your local workstation.
To begin, how many Solr nodes would you like to run in your local cluster? (specify 1-4 nodes) [2]:

其中第一個(gè)提示問(wèn)我們要運(yùn)行的節(jié)點(diǎn)數(shù)。注意最后一行末尾的 [2]；這是默認(rèn)的節(jié)點(diǎn)數(shù)量。兩個(gè)是我們想要的這個(gè)例子，所以你可以簡(jiǎn)單地按下 enter。

Ok, let's start up 2 Solr nodes for your example SolrCloud cluster.
Please enter the port for node1 [8983]:

這將是第一個(gè)節(jié)點(diǎn)運(yùn)行的端口。除非您知道機(jī)器上的端口8983上還有其他東西在運(yùn)行，否則請(qǐng)通過(guò)按 enter 來(lái)接受此默認(rèn)選項(xiàng)。如果有東西已經(jīng)在使用該端口，則會(huì)要求您選擇另一個(gè)端口。

Please enter the port for node2 [7574]:

這是第二個(gè)節(jié)點(diǎn)將運(yùn)行的端口。同樣，除非您知道您的計(jì)算機(jī)上的端口7574上還有其他東西在運(yùn)行，否則請(qǐng)通過(guò)按 enter 來(lái)接受此默認(rèn)選項(xiàng)。如果有東西已經(jīng)在使用該端口，則會(huì)要求您選擇另一個(gè)端口。

Solr 現(xiàn)在將自行初始化，并開(kāi)始在這兩個(gè)節(jié)點(diǎn)上運(yùn)行。該腳本將打印它用來(lái)供您參考的命令。

Starting up 2 Solr nodes for your example SolrCloud cluster.

Creating Solr home directory /solr-7.0.0/example/cloud/node1/solr
Cloning /solr-7.0.0/example/cloud/node1 into
   /solr-7.0.0/example/cloud/node2

Starting up Solr on port 8983 using command:
"bin/solr" start -cloud -p 8983 -s "example/cloud/node1/solr"

Waiting up to 180 seconds to see Solr running on port 8983 []
Started Solr server on port 8983 (pid=34942). Happy searching!

Starting up Solr on port 7574 using command:
"bin/solr" start -cloud -p 7574 -s "example/cloud/node2/solr" -z localhost:9983

Waiting up to 180 seconds to see Solr running on port 7574 []
Started Solr server on port 7574 (pid=35036). Happy searching!

INFO  - 2017-07-27 12:28:02.835; org.apache.solr.client.solrj.impl.ZkClientClusterStateProvider; Cluster at localhost:9983 ready

請(qǐng)注意，Solr 的兩個(gè)實(shí)例已經(jīng)在兩個(gè)節(jié)點(diǎn)上啟動(dòng)。因?yàn)槲覀儚?SolrCloud 模式開(kāi)始，并且沒(méi)有定義任何有關(guān)外部 ZooKeeper 集群的細(xì)節(jié)，所以 Solr 啟動(dòng)它自己的ZooKeeper 并將兩個(gè)節(jié)點(diǎn)連接到它。

啟動(dòng)完成后，系統(tǒng)會(huì)提示您創(chuàng)建一個(gè)用于索引數(shù)據(jù)的集合。

Now let's create a new collection for indexing documents in your 2-node cluster.
Please provide a name for your new collection: [gettingstarted]

這里的第一個(gè)地方，我們將偏離默認(rèn)選項(xiàng)。本教程將要求您對(duì) Solr 中包含的一些示例數(shù)據(jù)進(jìn)行索引，稱為 “techproducts” 數(shù)據(jù)。讓我們將我們的收藏命名為“techproducts”，這樣就很容易區(qū)分我們稍后創(chuàng)建的其他收藏。在 "提示" 和 "命中" 中輸入 techproducts 并點(diǎn)擊 enter。

How many shards would you like to split techproducts into? [2]

這是詢問(wèn)您想要將索引拆分到兩個(gè)節(jié)點(diǎn)中的碎片數(shù)。選擇“2”（默認(rèn)值）意味著我們將在兩個(gè)節(jié)點(diǎn)上相對(duì)均勻地拆分索引，這是一個(gè)很好的開(kāi)始。通過(guò)點(diǎn)擊 enter 接受默認(rèn)值。

How many replicas per shard would you like to create? [2]

副本是用于故障轉(zhuǎn)移的索引的副本（另請(qǐng)參閱 Solr 詞匯表定義）。同樣，默認(rèn)的“2”也可以從這里開(kāi)始，所以通過(guò)點(diǎn)擊 enter 來(lái)接受默認(rèn)值。

Please choose a configuration for the techproducts collection, available options are:
_default or sample_techproducts_configs [_default]

我們已經(jīng)達(dá)到了另一個(gè)我們將偏離默認(rèn)選項(xiàng)的點(diǎn)。Solr 有兩套可用的配置文件（稱為 configSet）。

一個(gè)集合必須有一個(gè) configSet，它至少包含 Solr 的兩個(gè)主要配置文件：模式文件（命名為 managed-schemaor 或 schema.xml）和 solrconfig.xml。這里的問(wèn)題是你想從哪個(gè) configSet 開(kāi)始。_default 是一個(gè)簡(jiǎn)單的選擇，但請(qǐng)注意，有一個(gè)名稱中包含“techproducts”，就像我們命名我們的收藏一樣。這個(gè) configSet 是專門為支持我們想要使用的示例數(shù)據(jù)而設(shè)計(jì)的，所以在提示符下輸入 sample_techproducts_configs 并點(diǎn)擊 enter。

此時(shí)，Solr 將創(chuàng)建集合，并再次將其發(fā)出的命令輸出到屏幕。

Uploading /solr-7.0.0/server/solr/configsets/_default/conf for config techproducts to ZooKeeper at localhost:9983

Connecting to ZooKeeper at localhost:9983 ...
INFO  - 2017-07-27 12:48:59.289; org.apache.solr.client.solrj.impl.ZkClientClusterStateProvider; Cluster at localhost:9983 ready
Uploading /solr-7.0.0/server/solr/configsets/sample_techproducts_configs/conf for config techproducts to ZooKeeper at localhost:9983

Creating new collection 'techproducts' using command:
http://localhost:8983/solr/admin/collections?action=CREATE&name=techproducts&numShards=2&replicationFactor=2&maxShardsPerNode=2&collection.configName=techproducts

{
  "responseHeader":{
    "status":0,
    "QTime":5460},
  "success":{
    "192.168.0.110:7574_solr":{
      "responseHeader":{
        "status":0,
        "QTime":4056},
      "core":"techproducts_shard1_replica_n1"},
    "192.168.0.110:8983_solr":{
      "responseHeader":{
        "status":0,
        "QTime":4056},
      "core":"techproducts_shard2_replica_n2"}}}

Enabling auto soft-commits with maxTime 3 secs using the Config API

POSTing request to Config API: http://localhost:8983/solr/techproducts/config
{"set-property":{"updateHandler.autoSoftCommit.maxTime":"3000"}}
Successfully set-property updateHandler.autoSoftCommit.maxTime to 3000

SolrCloud example running, please visit: http://localhost:8983/solr

完成上述過(guò)程后，Solr 就準(zhǔn)備好了數(shù)據(jù)！

您可以通過(guò)在 Web 瀏覽器中啟動(dòng) Solr Admin UI （http：// localhost：8983 / solr /）來(lái)看到 Solr 正在運(yùn)行。這是管理 Solr 的主要起點(diǎn)。

Solr 現(xiàn)在將運(yùn)行兩個(gè)“節(jié)點(diǎn)”，一個(gè)在端口7574上，一個(gè)在端口8983上。它將自動(dòng)創(chuàng)建一個(gè)集合 techproducts，一個(gè)兩個(gè)分片集合，每個(gè)集合有兩個(gè)副本。

管理用戶界面中的 Cloud 選項(xiàng)卡很好地顯示了收集：

索引 Techproducts 數(shù)據(jù)

您的 Solr 服務(wù)器已啟動(dòng)并正在運(yùn)行，但尚未包含任何數(shù)據(jù)，因此我們無(wú)法進(jìn)行任何查詢。

Solr 包含 bin/post 工具以便于索引各種類型的文檔。我們將在下面的索引示例中使用這個(gè)工具。

您將需要一個(gè) shell 命令來(lái)運(yùn)行以下的一些示例，這些示例源于 Solr 安裝目錄；從你推出的 Solr 的 shell 工作得很好。

Tip：目前該bin/post工具沒(méi)有可比較的 Windows 腳本，但所調(diào)用的底層 Java 程序是可用的。我們將在下面顯示 Windows 示例，但是您也可以看到 Post Tool 文檔的 Windows 部分以獲取更多詳細(xì)信息

我們將索引的數(shù)據(jù)在 example/exampledocs 目錄中。這些文檔混合使用了文檔格式（JSON，CSV 等），幸運(yùn)的是，我們可以同時(shí)對(duì)它們進(jìn)行索引：

對(duì)于 Linux/Mac 系統(tǒng)：

solr-7.0.0:$ bin/post -c techproducts example/exampledocs/

對(duì)于 Windows 系統(tǒng)：

C:\solr-7.0.0> java -jar -Dc=techproducts -Dauto example\exampledocs\post.jar example\exampledocs\

您應(yīng)該看到類似于以下內(nèi)容的輸出：

SimplePostTool version 5.0.0
Posting files to [base] url http://localhost:8983/solr/techproducts/update...
Entering auto mode. File endings considered are xml,json,jsonl,csv,pdf,doc,docx,ppt,pptx,xls,xlsx,odt,odp,ods,ott,otp,ots,rtf,htm,html,txt,log
POSTing file books.csv (text/csv) to [base]
POSTing file books.json (application/json) to [base]/json/docs
POSTing file gb18030-example.xml (application/xml) to [base]
POSTing file hd.xml (application/xml) to [base]
POSTing file ipod_other.xml (application/xml) to [base]
POSTing file ipod_video.xml (application/xml) to [base]
POSTing file manufacturers.xml (application/xml) to [base]
POSTing file mem.xml (application/xml) to [base]
POSTing file money.xml (application/xml) to [base]
POSTing file monitor.xml (application/xml) to [base]
POSTing file monitor2.xml (application/xml) to [base]
POSTing file more_books.jsonl (application/json) to [base]/json/docs
POSTing file mp500.xml (application/xml) to [base]
POSTing file post.jar (application/octet-stream) to [base]/extract
POSTing file sample.html (text/html) to [base]/extract
POSTing file sd500.xml (application/xml) to [base]
POSTing file solr-word.pdf (application/pdf) to [base]/extract
POSTing file solr.xml (application/xml) to [base]
POSTing file test_utf8.sh (application/octet-stream) to [base]/extract
POSTing file utf8-example.xml (application/xml) to [base]
POSTing file vidcard.xml (application/xml) to [base]
21 files indexed.
COMMITting Solr index changes to http://localhost:8983/solr/techproducts/update...
Time spent: 0:00:00.822

執(zhí)行完上述過(guò)程，您的 Solr 中現(xiàn)在有數(shù)據(jù)了！

現(xiàn)在我們準(zhǔn)備開(kāi)始搜索。

基本搜索

可以通過(guò) REST 客戶端、curl、wget、Chrome POSTMAN 等，以及通過(guò)許多編程語(yǔ)言提供的本機(jī)客戶端來(lái)查詢Solr。

Solr Admin UI 通過(guò) techproducts 集合的查詢選項(xiàng)卡 (在 http://localhost:8983/solr/#/techproducts/query) 中包含一個(gè)查詢生成器接口。如果單擊“執(zhí)行查詢”按鈕而不更改表單中的任何內(nèi)容，則會(huì)以 JSON 格式獲得10個(gè)文檔：

由 Admin UI 發(fā)送到 Solr 的 URL 在上面的屏幕截圖的右上方以淺灰色顯示。如果你點(diǎn)擊它，你的瀏覽器會(huì)顯示你的原始響應(yīng)。

要使用 curl，請(qǐng)使用命令行中的引號(hào)在瀏覽器中顯示相同的 URL：

curl "http://localhost:8983/solr/techproducts/select?indent=on&q=:"

這里發(fā)生的事情是，我們正在使用 Solr 的查詢參數(shù)（q）以特殊的語(yǔ)法來(lái)請(qǐng)求索引（:）中的所有文檔。所有的文件都不會(huì)返回給我們，因?yàn)楸环Q為行的參數(shù)是默認(rèn)的，您可以在表單中看到10。如果您愿意，可以在 UI 或默認(rèn)值中更改參數(shù)。

Solr 有非常強(qiáng)大的搜索選項(xiàng)，本教程將無(wú)法涵蓋所有??這些選項(xiàng)。但是我們可以涵蓋一些最常見(jiàn)的查詢類型。

搜索單個(gè)詞條

要搜索一個(gè)術(shù)語(yǔ)，請(qǐng)?jiān)?Solr Admin UI 查詢屏幕中將其作為 q 參數(shù)值輸入，使用:替換為要查找的術(shù)語(yǔ)。

輸入“foundation”，然后再次執(zhí)行查詢。

如果你喜歡 curl，請(qǐng)輸入這樣的內(nèi)容：

curl "http://localhost:8983/solr/techproducts/select?q=foundation"

你會(huì)看到這樣的東西：

{
  "responseHeader":{
    "zkConnected":true,
    "status":0,
    "QTime":8,
    "params":{
      "q":"foundation"}},
  "response":{"numFound":4,"start":0,"maxScore":2.7879646,"docs":[
      {
        "id":"0553293354",
        "cat":["book"],
        "name":"Foundation",
        "price":7.99,
        "price_c":"7.99,USD",
        "inStock":true,
        "author":"Isaac Asimov",
        "author_s":"Isaac Asimov",
        "series_t":"Foundation Novels",
        "sequence_i":1,
        "genre_s":"scifi",
        "version":1574100232473411586,
        "price_cl_ns":799}]
}}

響應(yīng)表明有4個(gè)命中（"numFound":4）。我們?cè)谏厦娴氖纠敵鲋兄话艘粋€(gè)文檔，但是由于4個(gè)命中次數(shù)低于 rows 要返回的參數(shù)默認(rèn)值10，所以應(yīng)該看到它們?nèi)?個(gè)。

請(qǐng)注意文檔前的 responseHeader。此標(biāo)題將包含您為搜索設(shè)置的參數(shù)。默認(rèn)情況下，它僅顯示您為此查詢?cè)O(shè)置的參數(shù)，在本例中僅為查詢術(shù)語(yǔ)。

我們得到的文件包括每個(gè)索引的文件的所有字段。這也是默認(rèn)行為。如果要限制響應(yīng)中的字段，可以使用 fl 參數(shù)，它使用逗號(hào)分隔的字段名稱列表。這是管理界面中查詢表單上的可用字段之一。

在 “fl” 框中輸入“id”（不含引號(hào)），然后再次執(zhí)行查詢?；蛘?，用 curl 指定它：

curl "http://localhost:8983/solr/techproducts/select?q=foundation&fl=id"

您應(yīng)該只能看到返回的匹配記錄的 ID。

字段搜索

所有 Solr 查詢都使用某個(gè)字段查找文檔。通常，您希望同時(shí)在多個(gè)字段中進(jìn)行查詢，而這就是我們?cè)?"基礎(chǔ)" 查詢中所做的工作。這可以通過(guò)使用已經(jīng)在這組配置中設(shè)置的復(fù)制字段來(lái)實(shí)現(xiàn)。我們將在練習(xí)2中更詳細(xì)地介紹復(fù)制字段。

但是，有時(shí)候，您想要將查詢限制在單個(gè)字段中。這可以使您的查詢效率更高，結(jié)果更符合用戶的需求。

我們的小樣本數(shù)據(jù)集中的大部分?jǐn)?shù)據(jù)都與產(chǎn)品有關(guān)。假設(shè)我們想要找到索引中的所有“電子”產(chǎn)品。在查詢屏幕中，在 q 框中輸入“electronics”（不帶引號(hào)），然后點(diǎn)擊執(zhí)行查詢。你應(yīng)該得到14個(gè)結(jié)果，例如：

{
  "responseHeader":{
    "zkConnected":true,
    "status":0,
    "QTime":6,
    "params":{
      "q":"electronics"}},
  "response":{"numFound":14,"start":0,"maxScore":1.5579545,"docs":[
      {
        "id":"IW-02",
        "name":"iPod & iPod Mini USB 2.0 Cable",
        "manu":"Belkin",
        "manu_id_s":"belkin",
        "cat":["electronics",
          "connector"],
        "features":["car power adapter for iPod, white"],
        "weight":2.0,
        "price":11.5,
        "price_c":"11.50,USD",
        "popularity":1,
        "inStock":false,
        "store":"37.7752,-122.4232",
        "manufacturedate_dt":"2006-02-14T23:55:59Z",
        "version":1574100232554151936,
        "price_cl_ns":1150}]
}}

此搜索查找在索引字段中任何位置包含術(shù)語(yǔ)“電子”的所有文檔。但從上面我們可以看到有一個(gè) cat 領(lǐng)域（“范疇”）。如果我們限制只搜索具有“電子”類別的文檔，結(jié)果將會(huì)更精確。

在管理界面的 q 字段中更新您的查詢 cat:electronics?，F(xiàn)在你得到12個(gè)結(jié)果：

{
  "responseHeader":{
    "zkConnected":true,
    "status":0,
    "QTime":6,
    "params":{
      "q":"cat:electronics"}},
  "response":{"numFound":12,"start":0,"maxScore":0.9614112,"docs":[
      {
        "id":"SP2514N",
        "name":"Samsung SpinPoint P120 SP2514N - hard drive - 250 GB - ATA-133",
        "manu":"Samsung Electronics Co. Ltd.",
        "manu_id_s":"samsung",
        "cat":["electronics",
          "hard drive"],
        "features":["7200RPM, 8MB cache, IDE Ultra ATA-133",
          "NoiseGuard, SilentSeek technology, Fluid Dynamic Bearing (FDB) motor"],
        "price":92.0,
        "price_c":"92.0,USD",
        "popularity":6,
        "inStock":true,
        "manufacturedate_dt":"2006-02-13T15:26:37Z",
        "store":"35.0752,-97.032",
        "version":1574100232511160320,
        "price_cl_ns":9200}]
     }}

使用 curl，這個(gè)查詢看起來(lái)像這樣：

curl "http://localhost:8983/solr/techproducts/select?q=cat:electronics"

短語(yǔ)搜索

要搜索 multi-term 短語(yǔ)，請(qǐng)用雙引號(hào)將其括起來(lái)：q="multiple terms here（這里的多個(gè)術(shù)語(yǔ)）"。例如，通過(guò)在管理用戶界面的 "q" 框中輸入引號(hào)來(lái)搜索 "CAS 滯后時(shí)間"。

如果你跟隨 curl，請(qǐng)注意，術(shù)語(yǔ)之間的空間必須在 URL 中轉(zhuǎn)換為“+”，如下所示：

curl "http://localhost:8983/solr/techproducts/select?q=\"CAS+latency\""

我們得到2個(gè)結(jié)果：

{
  "responseHeader":{
    "zkConnected":true,
    "status":0,
    "QTime":7,
    "params":{
      "q":"\"CAS latency\""}},
  "response":{"numFound":2,"start":0,"maxScore":5.937691,"docs":[
      {
        "id":"VDBDB1A16",
        "name":"A-DATA V-Series 1GB 184-Pin DDR SDRAM Unbuffered DDR 400 (PC 3200) System Memory - OEM",
        "manu":"A-DATA Technology Inc.",
        "manu_id_s":"corsair",
        "cat":["electronics",
          "memory"],
        "features":["CAS latency 3,   2.7v"],
        "popularity":0,
        "inStock":true,
        "store":"45.18414,-93.88141",
        "manufacturedate_dt":"2006-02-13T15:26:37Z",
        "payloads":"electronics|0.9 memory|0.1",
        "version":1574100232590852096},
      {
        "id":"TWINX2048-3200PRO",
        "name":"CORSAIR  XMS 2GB (2 x 1GB) 184-Pin DDR SDRAM Unbuffered DDR 400 (PC 3200) Dual Channel Kit System Memory - Retail",
        "manu":"Corsair Microsystems Inc.",
        "manu_id_s":"corsair",
        "cat":["electronics",
          "memory"],
        "features":["CAS latency 2,  2-3-3-6 timing, 2.75v, unbuffered, heat-spreader"],
        "price":185.0,
        "price_c":"185.00,USD",
        "popularity":5,
        "inStock":true,
        "store":"37.7752,-122.4232",
        "manufacturedate_dt":"2006-02-13T15:26:37Z",
        "payloads":"electronics|6.0 memory|3.0",
        "version":1574100232584560640,
        "price_cl_ns":18500}]
  }}

結(jié)合搜索

默認(rèn)情況下，當(dāng)您在單個(gè)查詢中搜索多個(gè)術(shù)語(yǔ)和短語(yǔ)時(shí)，Solr 只會(huì)要求其中一個(gè)存在以便文檔匹配。包含更多詞匯的文檔將在結(jié)果列表中排序更高。

你可以要求用一個(gè) + 來(lái)表示一個(gè)詞或短語(yǔ)；相反，為了不允許出現(xiàn)一個(gè)詞或短語(yǔ)，用一個(gè)前綴 -。

要查找包含“電子”和“音樂(lè)”兩個(gè)術(shù)語(yǔ)的文檔，請(qǐng)?jiān)诠芾斫缑娌樵冞x項(xiàng)卡的 q 框中輸入：+electronics +music。

如果使用 curl，則必須對(duì) + 字符進(jìn)行編碼，因?yàn)樗?URL 中具有保留的用途（對(duì)空格字符進(jìn)行編碼）。對(duì)于編碼 + 是 %2B 如下所示：

curl "http://localhost:8983/solr/techproducts/select?q=%2Belectronics%20%2Bmusic"

你只應(yīng)得到一個(gè)結(jié)果。

要搜索包含術(shù)語(yǔ)“電子”但不包含“音樂(lè)” 一詞的文檔，請(qǐng)?jiān)诠芾斫缑娴?q 框中輸入：+electronics -music。對(duì)于 curl，再一次，對(duì) URL 編碼 + 是 %2B 如下所示：

curl "http://localhost:8983/solr/techproducts/select?q=%2Belectronics+-music"

這一次你得到13個(gè)結(jié)果。

有關(guān)搜索的更多信息

我們只是提供了 Solr 中搜索選項(xiàng)的表面。有關(guān)更多 Solr 搜索選項(xiàng)，請(qǐng)參閱搜索部分。

本節(jié)練習(xí)總結(jié)

現(xiàn)在，您已經(jīng)看到了 Solr 如何索引數(shù)據(jù)并做了一些基本的查詢。您現(xiàn)在可以選擇繼續(xù)執(zhí)行下一個(gè)示例，它將引入更多的 Solr 概念，例如分割結(jié)果和管理您的模式，或者您可以自行完成。

如果您決定不繼續(xù)本教程，那么到目前為止我們索引的數(shù)據(jù)對(duì)您來(lái)說(shuō)可能沒(méi)什么價(jià)值。您可以刪除您的安裝并重新開(kāi)始，也可以使用我們開(kāi)始的 bin/solr 腳本刪除此集合：

bin/solr delete -c techproducts

然后創(chuàng)建一個(gè)新的集合：

bin/solr create -c  -s 2 -rf 2

要停止我們啟動(dòng)的兩個(gè) Solr 節(jié)點(diǎn)，發(fā)出命令：

bin/solr stop -all

有關(guān)使用 bin/solr 的開(kāi)始/停止和收集選項(xiàng)的詳細(xì)信息，請(qǐng)參閱 Solr 控制腳本參考。