You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@lucene.apache.org by bu...@apache.org on 2016/09/22 00:53:48 UTC
svn commit: r997962 [2/2] - in /websites/staging/lucene/trunk/content: ./
solr/assets/images/quickstart-admin-ui-facet-options.png
solr/assets/images/quickstart-query-screen.png solr/quickstart.html
Modified: websites/staging/lucene/trunk/content/solr/quickstart.html
==============================================================================
--- websites/staging/lucene/trunk/content/solr/quickstart.html (original)
+++ websites/staging/lucene/trunk/content/solr/quickstart.html Thu Sep 22 00:53:48 2016
@@ -199,7 +199,7 @@ and getting a feel for the Solr administ
<p>To follow along with this tutorial, you will need...</p>
<ol>
<li>To meet the <a href="/solr/api/SYSTEM_REQUIREMENTS.html">system requirements</a></li>
-<li>An Apache Solr release. This tutorial was written using Apache Solr 5.3.1.</li>
+<li>An Apache Solr release (<a href="http://lucene.apache.org/solr/downloads.html">download</a>). This tutorial was written using Apache Solr 6.2.0.</li>
</ol>
<h2 id="getting-started">Getting Started<a class="headerlink" href="#getting-started" title="Permanent link">¶</a></h2>
<p>Please run the browser showing this tutorial and the Solr server on the same machine so tutorial links will correctly
@@ -208,18 +208,17 @@ point to your Solr server.</p>
Note that the base directory name may vary with the version of Solr downloaded. For example, with a shell in UNIX,
Cygwin, or MacOS:</p>
<div class="codehilite"><pre><span class="o">/</span><span class="p">:</span>$ <span class="n">ls</span> <span class="n">solr</span><span class="o">*</span>
-<span class="n">solr</span><span class="o">-</span>5<span class="p">.</span>3<span class="p">.</span>1<span class="p">.</span><span class="n">zip</span>
-<span class="o">/</span><span class="p">:</span>$ <span class="n">unzip</span> <span class="o">-</span><span class="n">q</span> <span class="n">solr</span><span class="o">-</span>5<span class="p">.</span>3<span class="p">.</span>1<span class="p">.</span><span class="n">zip</span>
-<span class="o">/</span><span class="p">:</span>$ <span class="n">cd</span> <span class="n">solr</span><span class="o">-</span>5<span class="p">.</span>3<span class="p">.</span>1<span class="o">/</span>
+<span class="n">solr</span><span class="o">-</span>6<span class="p">.</span>2<span class="p">.</span>0<span class="p">.</span><span class="n">zip</span>
+<span class="o">/</span><span class="p">:</span>$ <span class="n">unzip</span> <span class="o">-</span><span class="n">q</span> <span class="n">solr</span><span class="o">-</span>6<span class="p">.</span>2<span class="p">.</span>0<span class="p">.</span><span class="n">zip</span>
+<span class="o">/</span><span class="p">:</span>$ <span class="n">cd</span> <span class="n">solr</span><span class="o">-</span>6<span class="p">.</span>2<span class="p">.</span>0<span class="o">/</span>
</pre></div>
<p>To launch Solr, run: <code>bin/solr start -e cloud -noprompt</code></p>
-<div class="codehilite"><pre><span class="o">/</span><span class="n">solr</span><span class="o">-</span>5<span class="p">.</span>3<span class="p">.</span>1<span class="p">:</span>$ <span class="n">bin</span><span class="o">/</span><span class="n">solr</span> <span class="n">start</span> <span class="o">-</span><span class="n">e</span> <span class="n">cloud</span> <span class="o">-</span><span class="n">noprompt</span>
+<div class="codehilite"><pre><span class="o">/</span><span class="n">solr</span><span class="o">-</span>6<span class="p">.</span>2<span class="p">.</span>0<span class="p">:</span>$ <span class="n">bin</span><span class="o">/</span><span class="n">solr</span> <span class="n">start</span> <span class="o">-</span><span class="n">e</span> <span class="n">cloud</span> <span class="o">-</span><span class="n">noprompt</span>
<span class="n">Welcome</span> <span class="n">to</span> <span class="n">the</span> <span class="n">SolrCloud</span> <span class="n">example</span>!
-
<span class="n">Starting</span> <span class="n">up</span> 2 <span class="n">Solr</span> <span class="n">nodes</span> <span class="k">for</span> <span class="n">your</span> <span class="n">example</span> <span class="n">SolrCloud</span> <span class="n">cluster</span><span class="p">.</span>
<span class="p">...</span>
@@ -231,7 +230,7 @@ Cygwin, or MacOS:</p>
<span class="n">SolrCloud</span> <span class="n">example</span> <span class="n">running</span><span class="p">,</span> <span class="n">please</span> <span class="n">visit</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span>
-<span class="o">/</span><span class="n">solr</span><span class="o">-</span>5<span class="p">.</span>3<span class="p">.</span>1<span class="p">:</span>$ <span class="n">_</span>
+<span class="o">/</span><span class="n">solr</span><span class="o">-</span>6<span class="p">.</span>2<span class="p">.</span>0<span class="p">:</span>$ <span class="n">_</span>
</pre></div>
@@ -240,16 +239,17 @@ This is the main starting point for admi
<p>Solr will now be running two "nodes", one on port 7574 and one on port 8983. There is one collection created
automatically, <code>gettingstarted</code>, a two shard collection, each with two replicas.
The <a href="http://localhost:8983/solr/#/~cloud">Cloud tab</a> in the Admin UI diagrams the collection nicely:</p>
-<p><img alt="Solr Quick Start: SolrCloud diagram" src="/solr/assets/images/quickstart-solrcloud.png" /></p>
+<p><img alt="Solr Quick Start: SolrCloud diagram" style="width:800px" src="/solr/assets/images/quickstart-solrcloud.png" /></p>
<h2 id="indexing-data">Indexing Data<a class="headerlink" href="#indexing-data" title="Permanent link">¶</a></h2>
-<p>Your Solr server is up and running, but it doesn't contain any data. The Solr install includes the <code>bin/post</code>* tool in
+<p>Your Solr server is up and running, but it doesn't contain any data. The Solr install includes the <code>bin/post</code> tool in
order to facilitate getting various types of documents easily into Solr from the start. We'll be
using this tool for the indexing examples below.</p>
<p>You'll need a command shell to run these examples, rooted in the Solr install directory; the shell from where you
launched Solr works just fine.</p>
<ul>
<li>NOTE: Currently the <code>bin/post</code> tool does not have a comparable Windows script, but the underlying Java program invoked
-is available. See the <a href="https://cwiki.apache.org/confluence/display/solr/Post+Tool#PostTool-Windows">Post Tool, Windows section</a>
+is available. See the
+<a href="https://cwiki.apache.org/confluence/display/solr/Post+Tool#PostTool-Windows">Post Tool, Windows section</a>
for details.</li>
</ul>
<h3 id="indexing-a-directory-of-rich-files">Indexing a directory of "rich" files<a class="headerlink" href="#indexing-a-directory-of-rich-files" title="Permanent link">¶</a></h3>
@@ -262,11 +262,11 @@ subdirectory, so that makes a convenient
<p>Here's what it'll look like:</p>
-<div class="codehilite"><pre><span class="o">/</span><span class="n">solr</span><span class="o">-</span>5<span class="p">.</span>3<span class="p">.</span>1<span class="p">:</span>$ <span class="n">bin</span><span class="o">/</span><span class="n">post</span> <span class="o">-</span><span class="n">c</span> <span class="n">gettingstarted</span> <span class="n">docs</span><span class="o">/</span>
-<span class="n">java</span> <span class="o">-</span><span class="n">classpath</span> <span class="o">/</span><span class="n">solr</span><span class="o">-</span>5<span class="p">.</span>3<span class="p">.</span>1<span class="o">/</span><span class="n">dist</span><span class="o">/</span><span class="n">solr</span><span class="o">-</span><span class="n">core</span><span class="o">-</span>5<span class="p">.</span>3<span class="p">.</span>1<span class="p">.</span><span class="n">jar</span> <span class="o">-</span><span class="n">Dauto</span><span class="p">=</span><span class="n">yes</span> <span class="o">-</span><span class="n">Dc</span><span class="p">=</span><span class="n">gettingstarted</span> <span class="o">-</span><span class="n">Ddata</span><span class="p">=</span><span class="n">files</span> <span class="o">-</span><span class="n">Drecursive</span><span class="p">=</span><span class="n">yes</span> <span class="n">org</span><span class="p">.</span><span class="n">apache</span><
span class="p">.</span><span class="n">solr</span><span class="p">.</span><span class="n">util</span><span class="p">.</span><span class="n">SimplePostTool</span> <span class="n">docs</span><span class="o">/</span>
-<span class="n">SimplePostTool</span> <span class="n">version</span> 5<span class="p">.</span>3<span class="p">.</span>1
+<div class="codehilite"><pre><span class="o">/</span><span class="n">solr</span><span class="o">-</span>6<span class="p">.</span>2<span class="p">.</span>0<span class="p">:</span>$ <span class="n">bin</span><span class="o">/</span><span class="n">post</span> <span class="o">-</span><span class="n">c</span> <span class="n">gettingstarted</span> <span class="n">docs</span><span class="o">/</span>
+<span class="n">java</span> <span class="o">-</span><span class="n">classpath</span> <span class="o">/</span><span class="n">solr</span><span class="o">-</span>6<span class="p">.</span>2<span class="p">.</span>0<span class="o">/</span><span class="n">dist</span><span class="o">/</span><span class="n">solr</span><span class="o">-</span><span class="n">core</span><span class="o">-</span>6<span class="p">.</span>2<span class="p">.</span>0<span class="p">.</span><span class="n">jar</span> <span class="o">-</span><span class="n">Dauto</span><span class="p">=</span><span class="n">yes</span> <span class="o">-</span><span class="n">Dc</span><span class="p">=</span><span class="n">gettingstarted</span> <span class="o">-</span><span class="n">Ddata</span><span class="p">=</span><span class="n">files</span> <span class="o">-</span><span class="n">Drecursive</span><span class="p">=</span><span class="n">yes</span> <span class="n">org</span><span class="p">.</span><span class="n">apache</span><
span class="p">.</span><span class="n">solr</span><span class="p">.</span><span class="n">util</span><span class="p">.</span><span class="n">SimplePostTool</span> <span class="n">docs</span><span class="o">/</span>
+<span class="n">SimplePostTool</span> <span class="n">version</span> 5<span class="p">.</span>0<span class="p">.</span>0
<span class="n">Posting</span> <span class="n">files</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span> <span class="n">url</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">update</span><span class="p">...</span>
-<span class="n">Entering</span> <span class="n">auto</span> <span class="n">mode</span><span class="p">.</span> <span class="n">File</span> <span class="n">endings</span> <span class="n">considered</span> <span class="n">are</span> <span class="n">xml</span><span class="p">,</span><span class="n">json</span><span class="p">,</span><span class="n">csv</span><span class="p">,</span><span class="n">pdf</span><span class="p">,</span><span class="n">doc</span><span class="p">,</span><span class="n">docx</span><span class="p">,</span><span class="n">ppt</span><span class="p">,</span><span class="n">pptx</span><span class="p">,</span><span class="n">xls</span><span class="p">,</span><span class="n">xlsx</span><span class="p">,</span><span class="n">odt</span><span class="p">,</span><span class="n">odp</span><span class="p">,</span><span class="n">ods</span><span class="p">,</span><span class="n">ott</span><span class="p">,</span><span class="n">otp</span><span class="p">,</span><span class
="n">ots</span><span class="p">,</span><span class="n">rtf</span><span class="p">,</span><span class="n">htm</span><span class="p">,</span><span class="n">html</span><span class="p">,</span><span class="n">txt</span><span class="p">,</span><span class="nb">log</span>
+<span class="n">Entering</span> <span class="n">auto</span> <span class="n">mode</span><span class="p">.</span> <span class="n">File</span> <span class="n">endings</span> <span class="n">considered</span> <span class="n">are</span> <span class="n">xml</span><span class="p">,</span><span class="n">json</span><span class="p">,</span><span class="n">jsonl</span><span class="p">,</span><span class="n">csv</span><span class="p">,</span><span class="n">pdf</span><span class="p">,</span><span class="n">doc</span><span class="p">,</span><span class="n">docx</span><span class="p">,</span><span class="n">ppt</span><span class="p">,</span><span class="n">pptx</span><span class="p">,</span><span class="n">xls</span><span class="p">,</span><span class="n">xlsx</span><span class="p">,</span><span class="n">odt</span><span class="p">,</span><span class="n">odp</span><span class="p">,</span><span class="n">ods</span><span class="p">,</span><span class="n">ott</span><span class="p">,</span><span cla
ss="n">otp</span><span class="p">,</span><span class="n">ots</span><span class="p">,</span><span class="n">rtf</span><span class="p">,</span><span class="n">htm</span><span class="p">,</span><span class="n">html</span><span class="p">,</span><span class="n">txt</span><span class="p">,</span><span class="nb">log</span>
<span class="n">Entering</span> <span class="n">recursive</span> <span class="n">mode</span><span class="p">,</span> <span class="n">max</span> <span class="n">depth</span><span class="p">=</span>999<span class="p">,</span> <span class="n">delay</span><span class="p">=</span>0<span class="n">s</span>
<span class="n">Indexing</span> <span class="n">directory</span> <span class="n">docs</span> <span class="p">(</span>3 <span class="n">files</span><span class="p">,</span> <span class="n">depth</span><span class="p">=</span>0<span class="p">)</span>
<span class="n">POSTing</span> <span class="n">file</span> <span class="n">index</span><span class="p">.</span><span class="n">html</span> <span class="p">(</span><span class="n">text</span><span class="o">/</span><span class="n">html</span><span class="p">)</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span><span class="o">/</span><span class="n">extract</span>
@@ -275,9 +275,9 @@ subdirectory, so that makes a convenient
<span class="n">Indexing</span> <span class="n">directory</span> <span class="n">docs</span><span class="o">/</span><span class="n">changes</span> <span class="p">(</span>1 <span class="n">files</span><span class="p">,</span> <span class="n">depth</span><span class="p">=</span>1<span class="p">)</span>
<span class="n">POSTing</span> <span class="n">file</span> <span class="n">Changes</span><span class="p">.</span><span class="n">html</span> <span class="p">(</span><span class="n">text</span><span class="o">/</span><span class="n">html</span><span class="p">)</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span><span class="o">/</span><span class="n">extract</span>
<span class="p">...</span>
-3248 <span class="n">files</span> <span class="n">indexed</span><span class="p">.</span>
+4329 <span class="n">files</span> <span class="n">indexed</span><span class="p">.</span>
<span class="n">COMMITting</span> <span class="n">Solr</span> <span class="n">index</span> <span class="n">changes</span> <span class="n">to</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">update</span><span class="p">...</span>
-<span class="n">Time</span> <span class="n">spent</span><span class="p">:</span> 0<span class="p">:</span>00<span class="p">:</span>41<span class="p">.</span>660
+<span class="n">Time</span> <span class="n">spent</span><span class="p">:</span> 0<span class="p">:</span>01<span class="p">:</span>16<span class="p">.</span>252
</pre></div>
@@ -287,16 +287,17 @@ subdirectory, so that makes a convenient
<li><code>docs/</code>: a relative path of the Solr install <code>docs/</code> directory</li>
</ul>
<p>You have now indexed thousands of documents into the <code>gettingstarted</code> collection in Solr and committed these changes.
-You can search for "solr" by loading the Admin UI <a href="#admin-collection">Query tab</a>, enter "solr" in the <code>q</code> param
-(replacing <code>*:*</code>, which matches all documents), and "Execute Query". See the <a href="#searching">Searching</a>
-section below for more information.</p>
+You can search for "solr" by loading the Admin UI <a href="http://localhost:8983/solr/#/gettingstarted/query">Query tab</a>,
+enter "solr" in the <code>q</code> param (replacing <code>*:*</code>, which matches all documents), and "Execute Query".
+See the <a href="#searching">Searching</a> section below for more information.</p>
<p>To index your own data, re-run the directory indexing command pointed to your own directory of documents. For example,
on a Mac instead of <code>docs/</code> try <code>~/Documents/</code> or <code>~/Desktop/</code>! You may want to start from a clean, empty system
again rather than have your content in addition to the Solr <code>docs/</code> directory; see the Cleanup section <a href="#cleanup">below</a>
for how to get back to a clean starting point.</p>
<h3 id="indexing-solr-xml">Indexing Solr XML<a class="headerlink" href="#indexing-solr-xml" title="Permanent link">¶</a></h3>
<p>Solr supports indexing structured content in a variety of incoming formats. The historically predominant format for
-getting structured content into Solr has been <a href="https://cwiki.apache.org/confluence/display/solr/Uploading+Data+with+Index+Handlers#UploadingDatawithIndexHandlers-XMLFormattedIndexUpdates">Solr XML</a>.
+getting structured content into Solr has been
+<a href="https://cwiki.apache.org/confluence/display/solr/Uploading+Data+with+Index+Handlers#UploadingDatawithIndexHandlers-XMLFormattedIndexUpdates">Solr XML</a>.
Many Solr indexers have been coded to process domain content into Solr XML output, generally HTTP POSTed directly to
Solr's <code>/update</code> endpoint.</p>
<p><a name="techproducts"></a>
@@ -312,11 +313,11 @@ on this page, and thus the collection us
<p>Here's what you'll see:</p>
-<div class="codehilite"><pre><span class="o">/</span><span class="n">solr</span><span class="o">-</span>5<span class="p">.</span>3<span class="p">.</span>1<span class="p">:</span>$ <span class="n">bin</span><span class="o">/</span><span class="n">post</span> <span class="o">-</span><span class="n">c</span> <span class="n">gettingstarted</span> <span class="n">example</span><span class="o">/</span><span class="n">exampledocs</span><span class="o">/*</span><span class="p">.</span><span class="n">xml</span>
-<span class="n">java</span> <span class="o">-</span><span class="n">classpath</span> <span class="o">/</span><span class="n">solr</span><span class="o">-</span>5<span class="p">.</span>3<span class="p">.</span>1<span class="o">/</span><span class="n">dist</span><span class="o">/</span><span class="n">solr</span><span class="o">-</span><span class="n">core</span><span class="o">-</span>5<span class="p">.</span>3<span class="p">.</span>1<span class="o">-</span><span class="n">SNAPSHOT</span><span class="p">.</span><span class="n">jar</span> <span class="o">-</span><span class="n">Dauto</span><span class="p">=</span><span class="n">yes</span> <span class="o">-</span><span class="n">Dc</span><span class="p">=</span><span class="n">gettingstarted</span> <span class="o">-</span><span class="n">Ddata</span><span class="p">=</span><span class="n">files</span> <span class="n">org</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">solr</span><sp
an class="p">.</span><span class="n">util</span><span class="p">.</span><span class="n">SimplePostTool</span> <span class="n">example</span><span class="o">/</span><span class="n">exampledocs</span><span class="o">/</span><span class="n">gb18030</span><span class="o">-</span><span class="n">example</span><span class="p">.</span><span class="n">xml</span> <span class="p">...</span>
-<span class="n">SimplePostTool</span> <span class="n">version</span> 5<span class="p">.</span>3<span class="p">.</span>1
+<div class="codehilite"><pre><span class="o">/</span><span class="n">solr</span><span class="o">-</span>6<span class="p">.</span>2<span class="p">.</span>0<span class="p">:</span>$ <span class="n">bin</span><span class="o">/</span><span class="n">post</span> <span class="o">-</span><span class="n">c</span> <span class="n">gettingstarted</span> <span class="n">example</span><span class="o">/</span><span class="n">exampledocs</span><span class="o">/*</span><span class="p">.</span><span class="n">xml</span>
+<span class="n">java</span> <span class="o">-</span><span class="n">classpath</span> <span class="o">/</span><span class="n">solr</span><span class="o">-</span>6<span class="p">.</span>2<span class="p">.</span>0<span class="o">/</span><span class="n">dist</span><span class="o">/</span><span class="n">solr</span><span class="o">-</span><span class="n">core</span><span class="o">-</span>6<span class="p">.</span>2<span class="p">.</span>0<span class="p">.</span><span class="n">jar</span> <span class="o">-</span><span class="n">Dauto</span><span class="p">=</span><span class="n">yes</span> <span class="o">-</span><span class="n">Dc</span><span class="p">=</span><span class="n">gettingstarted</span> <span class="o">-</span><span class="n">Ddata</span><span class="p">=</span><span class="n">files</span> <span class="n">org</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">solr</span><span class="p">.</span><span class="n">util</span><span c
lass="p">.</span><span class="n">SimplePostTool</span> <span class="n">example</span><span class="o">/</span><span class="n">exampledocs</span><span class="o">/</span><span class="n">gb18030</span><span class="o">-</span><span class="n">example</span><span class="p">.</span><span class="n">xml</span> <span class="p">...</span>
+<span class="n">SimplePostTool</span> <span class="n">version</span> 5<span class="p">.</span>0<span class="p">.</span>0
<span class="n">Posting</span> <span class="n">files</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span> <span class="n">url</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">update</span><span class="p">...</span>
-<span class="n">Entering</span> <span class="n">auto</span> <span class="n">mode</span><span class="p">.</span> <span class="n">File</span> <span class="n">endings</span> <span class="n">considered</span> <span class="n">are</span> <span class="n">xml</span><span class="p">,</span><span class="n">json</span><span class="p">,</span><span class="n">csv</span><span class="p">,</span><span class="n">pdf</span><span class="p">,</span><span class="n">doc</span><span class="p">,</span><span class="n">docx</span><span class="p">,</span><span class="n">ppt</span><span class="p">,</span><span class="n">pptx</span><span class="p">,</span><span class="n">xls</span><span class="p">,</span><span class="n">xlsx</span><span class="p">,</span><span class="n">odt</span><span class="p">,</span><span class="n">odp</span><span class="p">,</span><span class="n">ods</span><span class="p">,</span><span class="n">ott</span><span class="p">,</span><span class="n">otp</span><span class="p">,</span><span class
="n">ots</span><span class="p">,</span><span class="n">rtf</span><span class="p">,</span><span class="n">htm</span><span class="p">,</span><span class="n">html</span><span class="p">,</span><span class="n">txt</span><span class="p">,</span><span class="nb">log</span>
+<span class="n">Entering</span> <span class="n">auto</span> <span class="n">mode</span><span class="p">.</span> <span class="n">File</span> <span class="n">endings</span> <span class="n">considered</span> <span class="n">are</span> <span class="n">xml</span><span class="p">,</span><span class="n">json</span><span class="p">,</span><span class="n">jsonl</span><span class="p">,</span><span class="n">csv</span><span class="p">,</span><span class="n">pdf</span><span class="p">,</span><span class="n">doc</span><span class="p">,</span><span class="n">docx</span><span class="p">,</span><span class="n">ppt</span><span class="p">,</span><span class="n">pptx</span><span class="p">,</span><span class="n">xls</span><span class="p">,</span><span class="n">xlsx</span><span class="p">,</span><span class="n">odt</span><span class="p">,</span><span class="n">odp</span><span class="p">,</span><span class="n">ods</span><span class="p">,</span><span class="n">ott</span><span class="p">,</span><span cla
ss="n">otp</span><span class="p">,</span><span class="n">ots</span><span class="p">,</span><span class="n">rtf</span><span class="p">,</span><span class="n">htm</span><span class="p">,</span><span class="n">html</span><span class="p">,</span><span class="n">txt</span><span class="p">,</span><span class="nb">log</span>
<span class="n">POSTing</span> <span class="n">file</span> <span class="n">gb18030</span><span class="o">-</span><span class="n">example</span><span class="p">.</span><span class="n">xml</span> <span class="p">(</span><span class="n">application</span><span class="o">/</span><span class="n">xml</span><span class="p">)</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span>
<span class="n">POSTing</span> <span class="n">file</span> <span class="n">hd</span><span class="p">.</span><span class="n">xml</span> <span class="p">(</span><span class="n">application</span><span class="o">/</span><span class="n">xml</span><span class="p">)</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span>
<span class="n">POSTing</span> <span class="n">file</span> <span class="n">ipod_other</span><span class="p">.</span><span class="n">xml</span> <span class="p">(</span><span class="n">application</span><span class="o">/</span><span class="n">xml</span><span class="p">)</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span>
@@ -333,18 +334,19 @@ on this page, and thus the collection us
<span class="n">POSTing</span> <span class="n">file</span> <span class="n">vidcard</span><span class="p">.</span><span class="n">xml</span> <span class="p">(</span><span class="n">application</span><span class="o">/</span><span class="n">xml</span><span class="p">)</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span>
14 <span class="n">files</span> <span class="n">indexed</span><span class="p">.</span>
<span class="n">COMMITting</span> <span class="n">Solr</span> <span class="n">index</span> <span class="n">changes</span> <span class="n">to</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">update</span><span class="p">...</span>
-<span class="n">Time</span> <span class="n">spent</span><span class="p">:</span> 0<span class="p">:</span>00<span class="p">:</span>01<span class="p">.</span>857
+<span class="n">Time</span> <span class="n">spent</span><span class="p">:</span> 0<span class="p">:</span>00<span class="p">:</span>02<span class="p">.</span>077
</pre></div>
-<p>...and now you can search for all sorts of things using the default <a href="https://cwiki.apache.org/confluence/display/solr/The+Standard+Query+Parser#TheStandardQueryParser-SpecifyingTermsfortheStandardQueryParser">Solr Query Syntax</a>
+<p>...and now you can search for all sorts of things using the default
+<a href="https://cwiki.apache.org/confluence/display/solr/The+Standard+Query+Parser#TheStandardQueryParser-SpecifyingTermsfortheStandardQueryParser">Solr Query Syntax</a>
(a superset of the Lucene query syntax)...</p>
<p>NOTE:
-You can browse the documents indexed at <a href="http://localhost:8983/solr/gettingstarted/browse">http://localhost:8983/solr/gettingstarted/browse</a>. The <code>/browse</code> UI allows getting
-a feel for how Solr's technical capabilities can be worked with in a familiar, though a bit rough and prototypical,
-interactive HTML view. (The <code>/browse</code> view defaults to assuming the <code>gettingstarted</code> schema and data are a catch-all mix
-of structured XML, JSON, CSV example data, and unstructured rich documents. Your own data may not look ideal at first,
-though the <code>/browse</code> templates are customizable.)</p>
+You can browse the documents indexed at <a href="http://localhost:8983/solr/gettingstarted/browse">http://localhost:8983/solr/gettingstarted/browse</a>. The <code>/browse</code> UI allows
+getting a feel for how Solr's technical capabilities can be worked with in a familiar, though a bit rough and
+prototypical, interactive HTML view. (The <code>/browse</code> view defaults to assuming the <code>gettingstarted</code> schema and data
+are a catch-all mix of structured XML, JSON, CSV example data, and unstructured rich documents. Your own data may not
+look ideal at first, though the <code>/browse</code> templates are customizable.)</p>
<h3 id="indexing-json">Indexing JSON<a class="headerlink" href="#indexing-json" title="Permanent link">¶</a></h3>
<p>Solr supports indexing JSON, either arbitrary structured JSON or "Solr JSON" (which is similar to Solr XML).</p>
<p>Solr includes a small sample Solr JSON file to illustrate this capability. Again using <code>bin/post</code>, index the
@@ -354,20 +356,22 @@ sample JSON file:</p>
<p>You'll see:</p>
-<div class="codehilite"><pre><span class="o">/</span><span class="n">solr</span><span class="o">-</span>5<span class="p">.</span>3<span class="p">.</span>1<span class="p">:</span>$ <span class="n">bin</span><span class="o">/</span><span class="n">post</span> <span class="o">-</span><span class="n">c</span> <span class="n">gettingstarted</span> <span class="n">example</span><span class="o">/</span><span class="n">exampledocs</span><span class="o">/</span><span class="n">books</span><span class="p">.</span><span class="n">json</span>
-<span class="n">java</span> <span class="o">-</span><span class="n">classpath</span> <span class="o">/</span><span class="n">solr</span><span class="o">-</span>5<span class="p">.</span>3<span class="p">.</span>1<span class="o">/</span><span class="n">dist</span><span class="o">/</span><span class="n">solr</span><span class="o">-</span><span class="n">core</span><span class="o">-</span>5<span class="p">.</span>3<span class="p">.</span>1<span class="o">-</span><span class="n">SNAPSHOT</span><span class="p">.</span><span class="n">jar</span> <span class="o">-</span><span class="n">Dauto</span><span class="p">=</span><span class="n">yes</span> <span class="o">-</span><span class="n">Dc</span><span class="p">=</span><span class="n">gettingstarted</span> <span class="o">-</span><span class="n">Ddata</span><span class="p">=</span><span class="n">files</span> <span class="n">org</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">solr</span><sp
an class="p">.</span><span class="n">util</span><span class="p">.</span><span class="n">SimplePostTool</span> <span class="n">example</span><span class="o">/</span><span class="n">exampledocs</span><span class="o">/</span><span class="n">books</span><span class="p">.</span><span class="n">json</span>
-<span class="n">SimplePostTool</span> <span class="n">version</span> 5<span class="p">.</span>3<span class="p">.</span>1
+<div class="codehilite"><pre><span class="o">/</span><span class="n">solr</span><span class="o">-</span>6<span class="p">.</span>2<span class="p">.</span>0<span class="p">:</span>$ <span class="n">bin</span><span class="o">/</span><span class="n">post</span> <span class="o">-</span><span class="n">c</span> <span class="n">gettingstarted</span> <span class="n">example</span><span class="o">/</span><span class="n">exampledocs</span><span class="o">/</span><span class="n">books</span><span class="p">.</span><span class="n">json</span>
+<span class="n">java</span> <span class="o">-</span><span class="n">classpath</span> <span class="o">/</span><span class="n">solr</span><span class="o">-</span>6<span class="p">.</span>2<span class="p">.</span>0<span class="o">/</span><span class="n">dist</span><span class="o">/</span><span class="n">solr</span><span class="o">-</span><span class="n">core</span><span class="o">-</span>6<span class="p">.</span>2<span class="p">.</span>0<span class="p">.</span><span class="n">jar</span> <span class="o">-</span><span class="n">Dauto</span><span class="p">=</span><span class="n">yes</span> <span class="o">-</span><span class="n">Dc</span><span class="p">=</span><span class="n">gettingstarted</span> <span class="o">-</span><span class="n">Ddata</span><span class="p">=</span><span class="n">files</span> <span class="n">org</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">solr</span><span class="p">.</span><span class="n">util</span><span c
lass="p">.</span><span class="n">SimplePostTool</span> <span class="n">example</span><span class="o">/</span><span class="n">exampledocs</span><span class="o">/</span><span class="n">books</span><span class="p">.</span><span class="n">json</span>
+<span class="n">SimplePostTool</span> <span class="n">version</span> 5<span class="p">.</span>0<span class="p">.</span>0
<span class="n">Posting</span> <span class="n">files</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span> <span class="n">url</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">update</span><span class="p">...</span>
-<span class="n">Entering</span> <span class="n">auto</span> <span class="n">mode</span><span class="p">.</span> <span class="n">File</span> <span class="n">endings</span> <span class="n">considered</span> <span class="n">are</span> <span class="n">xml</span><span class="p">,</span><span class="n">json</span><span class="p">,</span><span class="n">csv</span><span class="p">,</span><span class="n">pdf</span><span class="p">,</span><span class="n">doc</span><span class="p">,</span><span class="n">docx</span><span class="p">,</span><span class="n">ppt</span><span class="p">,</span><span class="n">pptx</span><span class="p">,</span><span class="n">xls</span><span class="p">,</span><span class="n">xlsx</span><span class="p">,</span><span class="n">odt</span><span class="p">,</span><span class="n">odp</span><span class="p">,</span><span class="n">ods</span><span class="p">,</span><span class="n">ott</span><span class="p">,</span><span class="n">otp</span><span class="p">,</span><span class
="n">ots</span><span class="p">,</span><span class="n">rtf</span><span class="p">,</span><span class="n">htm</span><span class="p">,</span><span class="n">html</span><span class="p">,</span><span class="n">txt</span><span class="p">,</span><span class="nb">log</span>
-<span class="n">POSTing</span> <span class="n">file</span> <span class="n">books</span><span class="p">.</span><span class="n">json</span> <span class="p">(</span><span class="n">application</span><span class="o">/</span><span class="n">json</span><span class="p">)</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span>
+<span class="n">Entering</span> <span class="n">auto</span> <span class="n">mode</span><span class="p">.</span> <span class="n">File</span> <span class="n">endings</span> <span class="n">considered</span> <span class="n">are</span> <span class="n">xml</span><span class="p">,</span><span class="n">json</span><span class="p">,</span><span class="n">jsonl</span><span class="p">,</span><span class="n">csv</span><span class="p">,</span><span class="n">pdf</span><span class="p">,</span><span class="n">doc</span><span class="p">,</span><span class="n">docx</span><span class="p">,</span><span class="n">ppt</span><span class="p">,</span><span class="n">pptx</span><span class="p">,</span><span class="n">xls</span><span class="p">,</span><span class="n">xlsx</span><span class="p">,</span><span class="n">odt</span><span class="p">,</span><span class="n">odp</span><span class="p">,</span><span class="n">ods</span><span class="p">,</span><span class="n">ott</span><span class="p">,</span><span cla
ss="n">otp</span><span class="p">,</span><span class="n">ots</span><span class="p">,</span><span class="n">rtf</span><span class="p">,</span><span class="n">htm</span><span class="p">,</span><span class="n">html</span><span class="p">,</span><span class="n">txt</span><span class="p">,</span><span class="nb">log</span>
+<span class="n">POSTing</span> <span class="n">file</span> <span class="n">books</span><span class="p">.</span><span class="n">json</span> <span class="p">(</span><span class="n">application</span><span class="o">/</span><span class="n">json</span><span class="p">)</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span><span class="o">/</span><span class="n">json</span><span class="o">/</span><span class="n">docs</span>
1 <span class="n">files</span> <span class="n">indexed</span><span class="p">.</span>
<span class="n">COMMITting</span> <span class="n">Solr</span> <span class="n">index</span> <span class="n">changes</span> <span class="n">to</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">update</span><span class="p">...</span>
-<span class="n">Time</span> <span class="n">spent</span><span class="p">:</span> 0<span class="p">:</span>00<span class="p">:</span>00<span class="p">.</span>377
+<span class="n">Time</span> <span class="n">spent</span><span class="p">:</span> 0<span class="p">:</span>00<span class="p">:</span>00<span class="p">.</span>493
</pre></div>
+<p>For more information on indexing Solr JSON, see the Solr Reference Guide section
+<a href="https://cwiki.apache.org/confluence/display/solr/Uploading+Data+with+Index+Handlers#UploadingDatawithIndexHandlers-Solr-StyleJSON">Solr-Style JSON</a></p>
<p>To flatten (and/or split) and index arbitrary structured JSON, a topic beyond this quick start guide, check out
-<a href="https://cwiki.apache.org/confluence/display/solr/Uploading+Data+with+Index+Handlers#UploadingDatawithIndexHandlers-TransformingandIndexingcustomJSONdata">Transforming and Indexing Custom JSON data</a>.</p>
+<a href="https://cwiki.apache.org/confluence/display/solr/Uploading+Data+with+Index+Handlers#UploadingDatawithIndexHandlers-TransformingandIndexingCustomJSON">Transforming and Indexing Custom JSON data</a>.</p>
<h3 id="indexing-csv-commacolumn-separated-values">Indexing CSV (Comma/Column Separated Values)<a class="headerlink" href="#indexing-csv-commacolumn-separated-values" title="Permanent link">¶</a></h3>
<p>A great conduit of data into Solr is via CSV, especially when the documents are homogeneous by all having the
same set of fields. CSV can be conveniently exported from a spreadsheet such as Excel, or exported from databases such
@@ -379,30 +383,33 @@ index that into Solr rather than a more
<p>In your terminal you'll see:</p>
-<div class="codehilite"><pre><span class="o">/</span><span class="n">solr</span><span class="o">-</span>5<span class="p">.</span>3<span class="p">.</span>1<span class="p">:</span>$ <span class="n">bin</span><span class="o">/</span><span class="n">post</span> <span class="o">-</span><span class="n">c</span> <span class="n">gettingstarted</span> <span class="n">example</span><span class="o">/</span><span class="n">exampledocs</span><span class="o">/</span><span class="n">books</span><span class="p">.</span><span class="n">csv</span>
-<span class="n">java</span> <span class="o">-</span><span class="n">classpath</span> <span class="o">/</span><span class="n">solr</span><span class="o">-</span>5<span class="p">.</span>3<span class="p">.</span>1<span class="o">/</span><span class="n">dist</span><span class="o">/</span><span class="n">solr</span><span class="o">-</span><span class="n">core</span><span class="o">-</span>5<span class="p">.</span>3<span class="p">.</span>1<span class="p">.</span><span class="n">jar</span> <span class="o">-</span><span class="n">Dauto</span><span class="p">=</span><span class="n">yes</span> <span class="o">-</span><span class="n">Dc</span><span class="p">=</span><span class="n">gettingstarted</span> <span class="o">-</span><span class="n">Ddata</span><span class="p">=</span><span class="n">files</span> <span class="n">org</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">solr</span><span class="p">.</span><span class="n">util</span><span c
lass="p">.</span><span class="n">SimplePostTool</span> <span class="n">example</span><span class="o">/</span><span class="n">exampledocs</span><span class="o">/</span><span class="n">books</span><span class="p">.</span><span class="n">csv</span>
-<span class="n">SimplePostTool</span> <span class="n">version</span> 5<span class="p">.</span>3<span class="p">.</span>1
+<div class="codehilite"><pre><span class="o">/</span><span class="n">solr</span><span class="o">-</span>6<span class="p">.</span>2<span class="p">.</span>0<span class="p">:</span>$ <span class="n">bin</span><span class="o">/</span><span class="n">post</span> <span class="o">-</span><span class="n">c</span> <span class="n">gettingstarted</span> <span class="n">example</span><span class="o">/</span><span class="n">exampledocs</span><span class="o">/</span><span class="n">books</span><span class="p">.</span><span class="n">csv</span>
+<span class="n">java</span> <span class="o">-</span><span class="n">classpath</span> <span class="o">/</span><span class="n">solr</span><span class="o">-</span>6<span class="p">.</span>2<span class="p">.</span>0<span class="o">/</span><span class="n">dist</span><span class="o">/</span><span class="n">solr</span><span class="o">-</span><span class="n">core</span><span class="o">-</span>6<span class="p">.</span>2<span class="p">.</span>0<span class="p">.</span><span class="n">jar</span> <span class="o">-</span><span class="n">Dauto</span><span class="p">=</span><span class="n">yes</span> <span class="o">-</span><span class="n">Dc</span><span class="p">=</span><span class="n">gettingstarted</span> <span class="o">-</span><span class="n">Ddata</span><span class="p">=</span><span class="n">files</span> <span class="n">org</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">solr</span><span class="p">.</span><span class="n">util</span><span c
lass="p">.</span><span class="n">SimplePostTool</span> <span class="n">example</span><span class="o">/</span><span class="n">exampledocs</span><span class="o">/</span><span class="n">books</span><span class="p">.</span><span class="n">csv</span>
+<span class="n">SimplePostTool</span> <span class="n">version</span> 5<span class="p">.</span>0<span class="p">.</span>0
<span class="n">Posting</span> <span class="n">files</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span> <span class="n">url</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">update</span><span class="p">...</span>
-<span class="n">Entering</span> <span class="n">auto</span> <span class="n">mode</span><span class="p">.</span> <span class="n">File</span> <span class="n">endings</span> <span class="n">considered</span> <span class="n">are</span> <span class="n">xml</span><span class="p">,</span><span class="n">json</span><span class="p">,</span><span class="n">csv</span><span class="p">,</span><span class="n">pdf</span><span class="p">,</span><span class="n">doc</span><span class="p">,</span><span class="n">docx</span><span class="p">,</span><span class="n">ppt</span><span class="p">,</span><span class="n">pptx</span><span class="p">,</span><span class="n">xls</span><span class="p">,</span><span class="n">xlsx</span><span class="p">,</span><span class="n">odt</span><span class="p">,</span><span class="n">odp</span><span class="p">,</span><span class="n">ods</span><span class="p">,</span><span class="n">ott</span><span class="p">,</span><span class="n">otp</span><span class="p">,</span><span class
="n">ots</span><span class="p">,</span><span class="n">rtf</span><span class="p">,</span><span class="n">htm</span><span class="p">,</span><span class="n">html</span><span class="p">,</span><span class="n">txt</span><span class="p">,</span><span class="nb">log</span>
+<span class="n">Entering</span> <span class="n">auto</span> <span class="n">mode</span><span class="p">.</span> <span class="n">File</span> <span class="n">endings</span> <span class="n">considered</span> <span class="n">are</span> <span class="n">xml</span><span class="p">,</span><span class="n">json</span><span class="p">,</span><span class="n">jsonl</span><span class="p">,</span><span class="n">csv</span><span class="p">,</span><span class="n">pdf</span><span class="p">,</span><span class="n">doc</span><span class="p">,</span><span class="n">docx</span><span class="p">,</span><span class="n">ppt</span><span class="p">,</span><span class="n">pptx</span><span class="p">,</span><span class="n">xls</span><span class="p">,</span><span class="n">xlsx</span><span class="p">,</span><span class="n">odt</span><span class="p">,</span><span class="n">odp</span><span class="p">,</span><span class="n">ods</span><span class="p">,</span><span class="n">ott</span><span class="p">,</span><span cla
ss="n">otp</span><span class="p">,</span><span class="n">ots</span><span class="p">,</span><span class="n">rtf</span><span class="p">,</span><span class="n">htm</span><span class="p">,</span><span class="n">html</span><span class="p">,</span><span class="n">txt</span><span class="p">,</span><span class="nb">log</span>
<span class="n">POSTing</span> <span class="n">file</span> <span class="n">books</span><span class="p">.</span><span class="n">csv</span> <span class="p">(</span><span class="n">text</span><span class="o">/</span><span class="n">csv</span><span class="p">)</span> <span class="n">to</span> <span class="p">[</span><span class="n">base</span><span class="p">]</span>
1 <span class="n">files</span> <span class="n">indexed</span><span class="p">.</span>
<span class="n">COMMITting</span> <span class="n">Solr</span> <span class="n">index</span> <span class="n">changes</span> <span class="n">to</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">update</span><span class="p">...</span>
-<span class="n">Time</span> <span class="n">spent</span><span class="p">:</span> 0<span class="p">:</span>00<span class="p">:</span>00<span class="p">.</span>099
+<span class="n">Time</span> <span class="n">spent</span><span class="p">:</span> 0<span class="p">:</span>00<span class="p">:</span>00<span class="p">.</span>109
</pre></div>
+<p>For more information, see the Solr Reference Guide section
+<a href="https://cwiki.apache.org/confluence/display/solr/Uploading+Data+with+Index+Handlers#UploadingDatawithIndexHandlers-CSVFormattedIndexUpdates">CSV Formatted Index Updates</a></p>
<h3 id="other-indexing-techniques">Other indexing techniques<a class="headerlink" href="#other-indexing-techniques" title="Permanent link">¶</a></h3>
<ul>
<li>
-<p>Import records from a database using the <a href="https://cwiki.apache.org/confluence/display/solr/Uploading+Structured+Data+Store+Data+with+the+Data+Import+Handler">Data Import Handler (DIH)</a>.</p>
+<p>Import records from a database using the
+<a href="https://cwiki.apache.org/confluence/display/solr/Uploading+Structured+Data+Store+Data+with+the+Data+Import+Handler">Data Import Handler (DIH)</a>.</p>
</li>
<li>
<p>Use <a href="https://cwiki.apache.org/confluence/display/solr/Using+SolrJ">SolrJ</a> from JVM-based languages or
-other <a href="https://cwiki.apache.org/confluence/display/solr/Client+APIs">Solr clients</a> to programatically create documents
+other <a href="https://cwiki.apache.org/confluence/display/solr/Client+APIs">Solr clients</a> to programmatically create documents
to send to Solr.</p>
</li>
<li>
-<p>Use the Admin UI core-specific Documents tab to paste in a document to be
+<p>Use the Admin UI <a href="http://localhost:8983/solr/#/gettingstarted/documents">Documents tab</a> to paste in a document to be
indexed, or select <code>Document Builder</code> from the <code>Document Type</code> dropdown to build a document one field at a time.
Click on the <code>Submit Document</code> button below the form to index your document.</p>
</li>
@@ -416,11 +423,11 @@ for you. You can see that that has happe
Overview section of the Solr Admin UI.</p>
<p><code>numDocs</code> represents the number of searchable documents in the index (and will be larger than the number of XML, JSON,
or CSV files since some files contained more than one document). The maxDoc value may be larger as the maxDoc count
-includes logically deleted documents that have not yet been physically removed from the index. You can re-post the sample files
-over and over again as much as you want and <code>numDocs</code> will never increase, because the new documents will constantly be
-replacing the old.</p>
-<p>Go ahead and edit any of the existing example data files, change some of the data, and re-run the SimplePostTool command.
-You'll see your changes reflected in subsequent searches.</p>
+includes logically deleted documents that have not yet been physically removed from the index. You can re-post the
+sample files over and over again as much as you want and <code>numDocs</code> will never increase, because the new documents will
+constantly be replacing the old.</p>
+<p>Go ahead and edit any of the existing example data files, change some of the data, and re-run the SimplePostTool
+command. You'll see your changes reflected in subsequent searches.</p>
<h2 id="deleting-data">Deleting Data<a class="headerlink" href="#deleting-data" title="Permanent link">¶</a></h2>
<p>You can delete data by POSTing a delete command to the update URL and specifying the value of the document's unique key
field, or a query that matches multiple documents (be careful with that one!). Since these commands are smaller, we
@@ -433,19 +440,13 @@ specify them right on the command line r
<h2 id="searching">Searching<a class="headerlink" href="#searching" title="Permanent link">¶</a></h2>
<p>Solr can be queried via REST clients, cURL, wget, Chrome POSTMAN, etc., as well as via the native clients available for
many programming languages.</p>
-<p>The Solr Admin UI includes a query builder interface - see the <code>gettingstarted</code> query tab at <a href="http://localhost:8983/solr/#/gettingstarted_shard1_replica1/query">http://localhost:8983/solr/#/gettingstarted_shard1_replica1/query</a>.
-If you click the <code>Execute Query</code> button without changing anything in the form, you'll get 10 documents in JSON
-format (<code>*:*</code> in the <code>q</code> param matches all documents):</p>
-<p><img style="border:1px solid #ccc" src="/solr/assets/images/quickstart-query-screen.png" alt="Solr Quick Start: gettingstarted Query tab"/></p>
+<p>The Solr Admin UI includes a query builder interface - see the <code>gettingstarted</code> query tab at
+<a href="http://localhost:8983/solr/#/gettingstarted/query">http://localhost:8983/solr/#/gettingstarted/query</a>. If you click the <code>Execute Query</code> button without changing anything
+in the form, you'll get 10 documents in JSON format (<code>*:*</code> in the <code>q</code> param matches all documents):</p>
+<p><img style="border:1px solid #ccc; width:800px" src="/solr/assets/images/quickstart-query-screen.png" alt="Solr Quick Start: gettingstarted Query tab"/></p>
<p>The URL sent by the Admin UI to Solr is shown in light grey near the top right of the above screenshot - if you click on
it, your browser will show you the raw response. To use cURL, give the same URL in quotes on the <code>curl</code> command line:</p>
-<div class="codehilite"><pre><span class="n">curl</span> "<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">select</span>?<span class="n">q</span><span class="p">=</span><span class="o">*</span><span class="c">%3A*&wt=json&indent=true"</span>
-</pre></div>
-
-
-<p>In the above URL, the "<code>:</code>" in "<code>q=*:*</code>" has been URL-encoded as "<code>%3A</code>", but since "<code>:</code>" has no reserved purpose in the
-query component of the URL (after the "<code>?</code>"), you don't need to URL encode it. So the following also works:</p>
-<div class="codehilite"><pre><span class="n">curl</span> "<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">select</span>?<span class="n">q</span><span class="p">=</span><span class="o">*</span><span class="p">:</span><span class="o">*&</span><span class="n">wt</span><span class="p">=</span><span class="n">json</span><span class="o">&</span><span class="n">indent</span><span class="p">=</span><span class="n">true</span>"
+<div class="codehilite"><pre><span class="n">curl</span> "<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">select</span>?<span class="n">indent</span><span class="p">=</span><span class="n">on</span><span class="o">&</span><span class="n">q</span><span class="p">=</span><span class="o">*</span><span class="p">:</span><span class="o">*&</span><span class="n">wt</span><span class="p">=</span><span class="n">json</span>"
</pre></div>
@@ -458,25 +459,26 @@ with the term you want to find. To sear
<p>You'll see:</p>
-<div class="codehilite"><pre><span class="o">/</span><span class="n">solr</span><span class="o">-</span>5<span class="p">.</span>3<span class="p">.</span>1$ <span class="n">curl</span> "<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">select</span>?<span class="n">wt</span><span class="p">=</span><span class="n">json</span><span class="o">&</span><span class="n">indent</span><span class="p">=</span><span class="n">true</span><span class="o">&</span><span class="n">q</span><span class="p">=</span><span class="n">foundation</span>"
+<div class="codehilite"><pre><span class="o">/</span><span class="n">solr</span><span class="o">-</span>6<span class="p">.</span>2<span class="p">.</span>0$ <span class="n">curl</span> "<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">select</span>?<span class="n">wt</span><span class="p">=</span><span class="n">json</span><span class="o">&</span><span class="n">indent</span><span class="p">=</span><span class="n">true</span><span class="o">&</span><span class="n">q</span><span class="p">=</span><span class="n">foundation</span>"
<span class="p">{</span>
"<span class="n">responseHeader</span>"<span class="p">:{</span>
+ "<span class="n">zkConnected</span>"<span class="p">:</span><span class="n">true</span><span class="p">,</span>
"<span class="n">status</span>"<span class="p">:</span>0<span class="p">,</span>
- "<span class="n">QTime</span>"<span class="p">:</span>0<span class="p">,</span>
+ "<span class="n">QTime</span>"<span class="p">:</span>527<span class="p">,</span>
"<span class="n">params</span>"<span class="p">:{</span>
- "<span class="n">indent</span>"<span class="p">:</span>"<span class="n">true</span>"<span class="p">,</span>
"<span class="n">q</span>"<span class="p">:</span>"<span class="n">foundation</span>"<span class="p">,</span>
+ "<span class="n">indent</span>"<span class="p">:</span>"<span class="n">true</span>"<span class="p">,</span>
"<span class="n">wt</span>"<span class="p">:</span>"<span class="n">json</span>"<span class="p">}},</span>
- "<span class="n">response</span>"<span class="p">:{</span>"<span class="n">numFound</span>"<span class="p">:</span>2812<span class="p">,</span>"<span class="n">start</span>"<span class="p">:</span>0<span class="p">,</span>"<span class="n">docs</span>"<span class="p">:[</span>
+ "<span class="n">response</span>"<span class="p">:{</span>"<span class="n">numFound</span>"<span class="p">:</span>4156<span class="p">,</span>"<span class="n">start</span>"<span class="p">:</span>0<span class="p">,</span>"<span class="n">maxScore</span>"<span class="p">:</span>0<span class="p">.</span>10203234<span class="p">,</span>"<span class="n">docs</span>"<span class="p">:[</span>
<span class="p">{</span>
"<span class="n">id</span>"<span class="p">:</span>"0553293354"<span class="p">,</span>
"<span class="nb">cat</span>"<span class="p">:[</span>"<span class="n">book</span>"<span class="p">],</span>
- "<span class="n">name</span>"<span class="p">:</span>"<span class="n">Foundation</span>"<span class="p">,</span>
+ "<span class="n">name</span>"<span class="p">:[</span>"<span class="n">Foundation</span>"<span class="p">],</span>
<span class="p">...</span>
</pre></div>
-<p>The response indicates that there are 2,812 hits (<code>"numFound":2812</code>), of which the first 10 were returned, since by
+<p>The response indicates that there are 4,156 hits (<code>"numFound":4156</code>), of which the first 10 were returned, since by
default <code>start=0</code> and <code>rows=10</code>. You can specify these params to page through results, where <code>start</code> is the
(zero-based) position of the first result to return, and <code>rows</code> is the page size.</p>
<p>To restrict fields returned in the response, use the <code>fl</code> param, which takes a comma-separated list of field names.
@@ -487,18 +489,18 @@ E.g. to only return the <code>id</code>
<p><code>q=foundation</code> matches nearly all of the docs we've indexed, since most of the files under <code>docs/</code> contain
"The Apache Software Foundation". To restrict search to a particular field, use the syntax "<code>q=field:value</code>",
-e.g. to search for <code>foundation</code> only in the <code>name</code> field:</p>
-<div class="codehilite"><pre><span class="n">curl</span> "<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">select</span>?<span class="n">wt</span><span class="p">=</span><span class="n">json</span><span class="o">&</span><span class="n">indent</span><span class="p">=</span><span class="n">true</span><span class="o">&</span><span class="n">q</span><span class="p">=</span><span class="n">name</span><span class="p">:</span><span class="n">foundation</span>"
+e.g. to search for <code>Foundation</code> only in the <code>name</code> field:</p>
+<div class="codehilite"><pre><span class="n">curl</span> "<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">select</span>?<span class="n">wt</span><span class="p">=</span><span class="n">json</span><span class="o">&</span><span class="n">indent</span><span class="p">=</span><span class="n">true</span><span class="o">&</span><span class="n">q</span><span class="p">=</span><span class="n">name</span><span class="p">:</span><span class="n">Foundation</span>"
</pre></div>
<p>The above request returns only one document (<code>"numFound":1</code>) - from the response:</p>
<div class="codehilite"><pre><span class="p">...</span>
- "<span class="n">response</span>"<span class="p">:{</span>"<span class="n">numFound</span>"<span class="p">:</span>1<span class="p">,</span>"<span class="n">start</span>"<span class="p">:</span>0<span class="p">,</span>"<span class="n">docs</span>"<span class="p">:[</span>
+ "<span class="n">response</span>"<span class="p">:{</span>"<span class="n">numFound</span>"<span class="p">:</span>1<span class="p">,</span>"<span class="n">start</span>"<span class="p">:</span>0<span class="p">,</span>"<span class="n">maxScore</span>"<span class="p">:</span>2<span class="p">.</span>5902672<span class="p">,</span>"<span class="n">docs</span>"<span class="p">:[</span>
<span class="p">{</span>
"<span class="n">id</span>"<span class="p">:</span>"0553293354"<span class="p">,</span>
"<span class="nb">cat</span>"<span class="p">:[</span>"<span class="n">book</span>"<span class="p">],</span>
- "<span class="n">name</span>"<span class="p">:</span>"<span class="n">Foundation</span>"<span class="p">,</span>
+ "<span class="n">name</span>"<span class="p">:[</span>"<span class="n">Foundation</span>"<span class="p">],</span>
<span class="p">...</span>
</pre></div>
@@ -514,20 +516,21 @@ encoding for you automatically):</p>
<p>You'll get back:</p>
<div class="codehilite"><pre><span class="p">{</span>
"<span class="n">responseHeader</span>"<span class="p">:{</span>
+ "<span class="n">zkConnected</span>"<span class="p">:</span><span class="n">true</span><span class="p">,</span>
"<span class="n">status</span>"<span class="p">:</span>0<span class="p">,</span>
- "<span class="n">QTime</span>"<span class="p">:</span>0<span class="p">,</span>
+ "<span class="n">QTime</span>"<span class="p">:</span>391<span class="p">,</span>
"<span class="n">params</span>"<span class="p">:{</span>
- "<span class="n">indent</span>"<span class="p">:</span>"<span class="n">true</span>"<span class="p">,</span>
"<span class="n">q</span>"<span class="p">:</span>"<span class="o">\</span>"<span class="n">CAS</span> <span class="n">latency</span><span class="o">\</span>""<span class="p">,</span>
+ "<span class="n">indent</span>"<span class="p">:</span>"<span class="n">true</span>"<span class="p">,</span>
"<span class="n">wt</span>"<span class="p">:</span>"<span class="n">json</span>"<span class="p">}},</span>
- "<span class="n">response</span>"<span class="p">:{</span>"<span class="n">numFound</span>"<span class="p">:</span>2<span class="p">,</span>"<span class="n">start</span>"<span class="p">:</span>0<span class="p">,</span>"<span class="n">docs</span>"<span class="p">:[</span>
+ "<span class="n">response</span>"<span class="p">:{</span>"<span class="n">numFound</span>"<span class="p">:</span>3<span class="p">,</span>"<span class="n">start</span>"<span class="p">:</span>0<span class="p">,</span>"<span class="n">maxScore</span>"<span class="p">:</span>22<span class="p">.</span>027056<span class="p">,</span>"<span class="n">docs</span>"<span class="p">:[</span>
<span class="p">{</span>
- "<span class="n">id</span>"<span class="p">:</span>"<span class="n">VDBDB1A16</span>"<span class="p">,</span>
- "<span class="n">name</span>"<span class="p">:</span>"<span class="n">A</span><span class="o">-</span><span class="n">DATA</span> <span class="n">V</span><span class="o">-</span><span class="n">Series</span> 1<span class="n">GB</span> 184<span class="o">-</span><span class="n">Pin</span> <span class="n">DDR</span> <span class="n">SDRAM</span> <span class="n">Unbuffered</span> <span class="n">DDR</span> 400 <span class="p">(</span><span class="n">PC</span> 3200<span class="p">)</span> <span class="n">System</span> <span class="n">Memory</span> <span class="o">-</span> <span class="n">OEM</span>"<span class="p">,</span>
- "<span class="n">manu</span>"<span class="p">:</span>"<span class="n">A</span><span class="o">-</span><span class="n">DATA</span> <span class="n">Technology</span> <span class="n">Inc</span><span class="p">.</span>"<span class="p">,</span>
+ "<span class="n">id</span>"<span class="p">:</span>"<span class="n">TWINX2048</span><span class="o">-</span>3200<span class="n">PRO</span>"<span class="p">,</span>
+ "<span class="n">name</span>"<span class="p">:[</span>"<span class="n">CORSAIR</span> <span class="n">XMS</span> 2<span class="n">GB</span> <span class="p">(</span>2 <span class="n">x</span> 1<span class="n">GB</span><span class="p">)</span> 184<span class="o">-</span><span class="n">Pin</span> <span class="n">DDR</span> <span class="n">SDRAM</span> <span class="n">Unbuffered</span> <span class="n">DDR</span> 400 <span class="p">(</span><span class="n">PC</span> 3200<span class="p">)</span> <span class="n">Dual</span> <span class="n">Channel</span> <span class="n">Kit</span> <span class="n">System</span> <span class="n">Memory</span> <span class="o">-</span> <span class="n">Retail</span>"<span class="p">],</span>
+ "<span class="n">manu</span>"<span class="p">:[</span>"<span class="n">Corsair</span> <span class="n">Microsystems</span> <span class="n">Inc</span><span class="p">.</span>"<span class="p">],</span>
"<span class="n">manu_id_s</span>"<span class="p">:</span>"<span class="n">corsair</span>"<span class="p">,</span>
"<span class="nb">cat</span>"<span class="p">:[</span>"<span class="n">electronics</span>"<span class="p">,</span> "<span class="n">memory</span>"<span class="p">],</span>
- "<span class="n">features</span>"<span class="p">:[</span>"<span class="n">CAS</span> <span class="n">latency</span> 3<span class="p">,</span><span class="o">\</span><span class="n">t</span> 2<span class="p">.</span>7<span class="n">v</span>"<span class="p">],</span>
+ "<span class="n">features</span>"<span class="p">:[</span>"<span class="n">CAS</span> <span class="n">latency</span> 2<span class="p">,</span> 2<span class="o">-</span>3<span class="o">-</span>3<span class="o">-</span>6 <span class="n">timing</span><span class="p">,</span> 2<span class="p">.</span>75<span class="n">v</span><span class="p">,</span> <span class="n">unbuffered</span><span class="p">,</span> <span class="n">heat</span><span class="o">-</span><span class="n">spreader</span>"<span class="p">],</span>
<span class="p">...</span>
</pre></div>
@@ -538,8 +541,8 @@ is present in order for a document to ma
<p>You can require that a term or phrase is present by prefixing it with a "<code>+</code>"; conversely, to disallow the presence of a
term or phrase, prefix it with a "<code>-</code>".</p>
<p>To find documents that contain both terms "<code>one</code>" and "<code>three</code>", enter <code>+one +three</code> in the <code>q</code> param in the
-core-specific Admin UI Query tab. Because the "<code>+</code>" character has a reserved purpose in URLs
-(encoding the space character), you must URL encode it for <code>curl</code> as "<code>%2B</code>":</p>
+Admin UI Query tab. Because the "<code>+</code>" character has a reserved purpose in URLs (encoding the space character),
+you must URL encode it for <code>curl</code> as "<code>%2B</code>":</p>
<div class="codehilite"><pre><span class="n">curl</span> "<span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">select</span>?<span class="n">wt</span><span class="p">=</span><span class="n">json</span><span class="o">&</span><span class="n">indent</span><span class="p">=</span><span class="n">true</span><span class="o">&</span><span class="n">q</span><span class="p">=</span><span class="c">%2Bone+%2Bthree"</span>
</pre></div>
@@ -551,8 +554,8 @@ core-specific Admin UI Query tab. Becau
<h4 id="in-depth">In depth<a class="headerlink" href="#in-depth" title="Permanent link">¶</a></h4>
-<p>For more Solr search options, see the Solr Reference Guide's <a href="https://cwiki.apache.org/confluence/display/solr/Searching">Searching</a>
-section.</p>
+<p>For more Solr search options, see the Solr Reference Guide's
+<a href="https://cwiki.apache.org/confluence/display/solr/Searching">Searching</a> section.</p>
<h3 id="faceting">Faceting<a class="headerlink" href="#faceting" title="Permanent link">¶</a></h3>
<p>One of Solr's most popular features is faceting. Faceting allows the search results to be arranged into subsets (or
buckets or categories), providing a count for each subset. There are several types of faceting: field values, numeric
@@ -566,24 +569,25 @@ appear:</p>
<p>To see facet counts from all documents (<code>q=*:*</code>): turn on faceting (<code>facet=true</code>), and specify the field to facet on via
the <code>facet.field</code> param. If you only want facets, and no document contents, specify <code>rows=0</code>. The <code>curl</code> command below
will return facet counts for the <code>manu_id_s</code> field:</p>
-<div class="codehilite"><pre><span class="n">curl</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">select</span>?<span class="n">wt</span><span class="p">=</span><span class="n">json</span><span class="o">&</span><span class="n">indent</span><span class="p">=</span><span class="n">true</span><span class="o">&</span><span class="n">q</span><span class="p">=</span><span class="o">*</span><span class="p">:</span><span class="o">*&</span><span class="n">rows</span><span class="p">=</span>0 <span class="o">\</span>
- <span class="o">&</span><span class="n">facet</span><span class="p">=</span><span class="n">true</span><span class="o">&</span><span class="n">facet</span><span class="p">.</span><span class="n">field</span><span class="p">=</span><span class="n">manu_id_s</span>
+<div class="codehilite"><pre><span class="n">curl</span> <span class="s">'http://localhost:8983/solr/gettingstarted/select?wt=json&indent=true&q=*:*&rows=0'</span><span class="o">\</span>
+<span class="s">'&facet=true&facet.field=manu_id_s'</span>
</pre></div>
<p>In your terminal, you'll see:</p>
<div class="codehilite"><pre><span class="p">{</span>
"<span class="n">responseHeader</span>"<span class="p">:{</span>
+ "<span class="n">zkConnected</span>"<span class="p">:</span><span class="n">true</span><span class="p">,</span>
"<span class="n">status</span>"<span class="p">:</span>0<span class="p">,</span>
- "<span class="n">QTime</span>"<span class="p">:</span>3<span class="p">,</span>
+ "<span class="n">QTime</span>"<span class="p">:</span>201<span class="p">,</span>
"<span class="n">params</span>"<span class="p">:{</span>
- "<span class="n">facet</span>"<span class="p">:</span>"<span class="n">true</span>"<span class="p">,</span>
- "<span class="n">indent</span>"<span class="p">:</span>"<span class="n">true</span>"<span class="p">,</span>
"<span class="n">q</span>"<span class="p">:</span>"<span class="o">*</span><span class="p">:</span><span class="o">*</span>"<span class="p">,</span>
"<span class="n">facet</span><span class="p">.</span><span class="n">field</span>"<span class="p">:</span>"<span class="n">manu_id_s</span>"<span class="p">,</span>
+ "<span class="n">indent</span>"<span class="p">:</span>"<span class="n">true</span>"<span class="p">,</span>
+ "<span class="n">rows</span>"<span class="p">:</span>"0"<span class="p">,</span>
"<span class="n">wt</span>"<span class="p">:</span>"<span class="n">json</span>"<span class="p">,</span>
- "<span class="n">rows</span>"<span class="p">:</span>"0"<span class="p">}},</span>
- "<span class="n">response</span>"<span class="p">:{</span>"<span class="n">numFound</span>"<span class="p">:</span>2990<span class="p">,</span>"<span class="n">start</span>"<span class="p">:</span>0<span class="p">,</span>"<span class="n">docs</span>"<span class="p">:[]</span>
+ "<span class="n">facet</span>"<span class="p">:</span>"<span class="n">true</span>"<span class="p">}},</span>
+ "<span class="n">response</span>"<span class="p">:{</span>"<span class="n">numFound</span>"<span class="p">:</span>4374<span class="p">,</span>"<span class="n">start</span>"<span class="p">:</span>0<span class="p">,</span>"<span class="n">maxScore</span>"<span class="p">:</span>1<span class="p">.</span>0<span class="p">,</span>"<span class="n">docs</span>"<span class="p">:[]</span>
<span class="p">},</span>
"<span class="n">facet_counts</span>"<span class="p">:{</span>
"<span class="n">facet_queries</span>"<span class="p">:{},</span>
@@ -603,9 +607,9 @@ will return facet counts for the <code>m
"<span class="n">uk</span>"<span class="p">,</span>1<span class="p">,</span>
"<span class="n">viewsonic</span>"<span class="p">,</span>1<span class="p">,</span>
"<span class="n">samsung</span>"<span class="p">,</span>0<span class="p">]},</span>
- "<span class="n">facet_dates</span>"<span class="p">:{},</span>
"<span class="n">facet_ranges</span>"<span class="p">:{},</span>
- "<span class="n">facet_intervals</span>"<span class="p">:{}}}</span>
+ "<span class="n">facet_intervals</span>"<span class="p">:{},</span>
+ "<span class="n">facet_heatmaps</span>"<span class="p">:{}}}</span>
</pre></div>
@@ -615,38 +619,38 @@ A prime example of numeric range facetin
like this:</p>
<p><img style="border:1px solid #ccc" src="/solr/assets/images/quickstart-range-facet.png" alt="Solr Quick Start: Range facets"/></p>
<p>The data for these price range facets can be seen in JSON format with this command:</p>
-<div class="codehilite"><pre><span class="n">curl</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">select</span>?<span class="n">q</span><span class="p">=</span><span class="o">*</span><span class="p">:</span><span class="o">*&</span><span class="n">wt</span><span class="p">=</span><span class="n">json</span><span class="o">&</span><span class="n">indent</span><span class="p">=</span><span class="n">on</span><span class="o">&</span><span class="n">rows</span><span class="p">=</span>0 <span class="o">\</span>
- <span class="o">&</span><span class="n">facet</span><span class="p">=</span><span class="n">true</span> <span class="o">\</span>
- <span class="o">&</span><span class="n">facet</span><span class="p">.</span><span class="n">range</span><span class="p">=</span><span class="n">price</span> <span class="o">\</span>
- <span class="o">&</span><span class="n">f</span><span class="p">.</span><span class="n">price</span><span class="p">.</span><span class="n">facet</span><span class="p">.</span><span class="n">range</span><span class="p">.</span><span class="n">start</span><span class="p">=</span>0 <span class="o">\</span>
- <span class="o">&</span><span class="n">f</span><span class="p">.</span><span class="n">price</span><span class="p">.</span><span class="n">facet</span><span class="p">.</span><span class="n">range</span><span class="p">.</span><span class="k">end</span><span class="p">=</span>600 <span class="o">\</span>
- <span class="o">&</span><span class="n">f</span><span class="p">.</span><span class="n">price</span><span class="p">.</span><span class="n">facet</span><span class="p">.</span><span class="n">range</span><span class="p">.</span><span class="n">gap</span><span class="p">=</span>50 <span class="o">\</span>
- <span class="o">&</span><span class="n">facet</span><span class="p">.</span><span class="n">range</span><span class="p">.</span><span class="n">other</span><span class="p">=</span><span class="n">after</span>
+<div class="codehilite"><pre><span class="n">curl</span> <span class="s">'http://localhost:8983/solr/gettingstarted/select?q=*:*&wt=json&indent=on&rows=0'</span><span class="o">\</span>
+<span class="s">'&facet=true'</span><span class="o">\</span>
+<span class="s">'&facet.range=price'</span><span class="o">\</span>
+<span class="s">'&f.price.facet.range.start=0'</span><span class="o">\</span>
+<span class="s">'&f.price.facet.range.end=600'</span><span class="o">\</span>
+<span class="s">'&f.price.facet.range.gap=50'</span><span class="o">\</span>
+<span class="s">'&facet.range.other=after'</span>
</pre></div>
<p>In your terminal you will see:</p>
<div class="codehilite"><pre><span class="p">{</span>
"<span class="n">responseHeader</span>"<span class="p">:{</span>
+ "<span class="n">zkConnected</span>"<span class="p">:</span><span class="n">true</span><span class="p">,</span>
"<span class="n">status</span>"<span class="p">:</span>0<span class="p">,</span>
- "<span class="n">QTime</span>"<span class="p">:</span>1<span class="p">,</span>
+ "<span class="n">QTime</span>"<span class="p">:</span>248<span class="p">,</span>
"<span class="n">params</span>"<span class="p">:{</span>
+ "<span class="n">facet</span><span class="p">.</span><span class="n">range</span>"<span class="p">:</span>"<span class="n">price</span>"<span class="p">,</span>
+ "<span class="n">q</span>"<span class="p">:</span>"<span class="o">*</span><span class="p">:</span><span class="o">*</span>"<span class="p">,</span>
+ "<span class="n">f</span><span class="p">.</span><span class="n">price</span><span class="p">.</span><span class="n">facet</span><span class="p">.</span><span class="n">range</span><span class="p">.</span><span class="n">start</span>"<span class="p">:</span>"0"<span class="p">,</span>
"<span class="n">facet</span><span class="p">.</span><span class="n">range</span><span class="p">.</span><span class="n">other</span>"<span class="p">:</span>"<span class="n">after</span>"<span class="p">,</span>
- "<span class="n">facet</span>"<span class="p">:</span>"<span class="n">true</span>"<span class="p">,</span>
"<span class="n">indent</span>"<span class="p">:</span>"<span class="n">on</span>"<span class="p">,</span>
- "<span class="n">q</span>"<span class="p">:</span>"<span class="o">*</span><span class="p">:</span><span class="o">*</span>"<span class="p">,</span>
"<span class="n">f</span><span class="p">.</span><span class="n">price</span><span class="p">.</span><span class="n">facet</span><span class="p">.</span><span class="n">range</span><span class="p">.</span><span class="n">gap</span>"<span class="p">:</span>"50"<span class="p">,</span>
- "<span class="n">facet</span><span class="p">.</span><span class="n">range</span>"<span class="p">:</span>"<span class="n">price</span>"<span class="p">,</span>
- "<span class="n">f</span><span class="p">.</span><span class="n">price</span><span class="p">.</span><span class="n">facet</span><span class="p">.</span><span class="n">range</span><span class="p">.</span><span class="k">end</span>"<span class="p">:</span>"600"<span class="p">,</span>
+ "<span class="n">rows</span>"<span class="p">:</span>"0"<span class="p">,</span>
"<span class="n">wt</span>"<span class="p">:</span>"<span class="n">json</span>"<span class="p">,</span>
- "<span class="n">f</span><span class="p">.</span><span class="n">price</span><span class="p">.</span><span class="n">facet</span><span class="p">.</span><span class="n">range</span><span class="p">.</span><span class="n">start</span>"<span class="p">:</span>"0"<span class="p">,</span>
- "<span class="n">rows</span>"<span class="p">:</span>"0"<span class="p">}},</span>
- "<span class="n">response</span>"<span class="p">:{</span>"<span class="n">numFound</span>"<span class="p">:</span>2990<span class="p">,</span>"<span class="n">start</span>"<span class="p">:</span>0<span class="p">,</span>"<span class="n">docs</span>"<span class="p">:[]</span>
+ "<span class="n">facet</span>"<span class="p">:</span>"<span class="n">true</span>"<span class="p">,</span>
+ "<span class="n">f</span><span class="p">.</span><span class="n">price</span><span class="p">.</span><span class="n">facet</span><span class="p">.</span><span class="n">range</span><span class="p">.</span><span class="k">end</span>"<span class="p">:</span>"600"<span class="p">}},</span>
+ "<span class="n">response</span>"<span class="p">:{</span>"<span class="n">numFound</span>"<span class="p">:</span>4374<span class="p">,</span>"<span class="n">start</span>"<span class="p">:</span>0<span class="p">,</span>"<span class="n">maxScore</span>"<span class="p">:</span>1<span class="p">.</span>0<span class="p">,</span>"<span class="n">docs</span>"<span class="p">:[]</span>
<span class="p">},</span>
"<span class="n">facet_counts</span>"<span class="p">:{</span>
"<span class="n">facet_queries</span>"<span class="p">:{},</span>
"<span class="n">facet_fields</span>"<span class="p">:{},</span>
- "<span class="n">facet_dates</span>"<span class="p">:{},</span>
"<span class="n">facet_ranges</span>"<span class="p">:{</span>
"<span class="n">price</span>"<span class="p">:{</span>
"<span class="n">counts</span>"<span class="p">:[</span>
@@ -663,20 +667,21 @@ like this:</p>
"500<span class="p">.</span>0"<span class="p">,</span>0<span class="p">,</span>
"550<span class="p">.</span>0"<span class="p">,</span>0<span class="p">],</span>
"<span class="n">gap</span>"<span class="p">:</span>50<span class="p">.</span>0<span class="p">,</span>
+ "<span class="n">after</span>"<span class="p">:</span>2<span class="p">,</span>
"<span class="n">start</span>"<span class="p">:</span>0<span class="p">.</span>0<span class="p">,</span>
- "<span class="k">end</span>"<span class="p">:</span>600<span class="p">.</span>0<span class="p">,</span>
- "<span class="n">after</span>"<span class="p">:</span>2<span class="p">}},</span>
- "<span class="n">facet_intervals</span>"<span class="p">:{}}}</span>
+ "<span class="k">end</span>"<span class="p">:</span>600<span class="p">.</span>0<span class="p">}},</span>
+ "<span class="n">facet_intervals</span>"<span class="p">:{},</span>
+ "<span class="n">facet_heatmaps</span>"<span class="p">:{}}}</span>
</pre></div>
<h4 id="pivot-facets">Pivot facets<a class="headerlink" href="#pivot-facets" title="Permanent link">¶</a></h4>
-<p>Another faceting type is pivot facets, also known as "decison trees", allowing two or more fields to be nested for all
+<p>Another faceting type is pivot facets, also known as "decision trees", allowing two or more fields to be nested for all
the various possible combinations. Using the example technical product data, pivot facets can be used to see how many
of the products in the "book" category (the <code>cat</code> field) are in stock or not in stock. Here's how to get at the raw
data for this scenario:</p>
-<div class="codehilite"><pre><span class="n">curl</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">localhost</span><span class="p">:</span>8983<span class="o">/</span><span class="n">solr</span><span class="o">/</span><span class="n">gettingstarted</span><span class="o">/</span><span class="n">select</span>?<span class="n">q</span><span class="p">=</span><span class="o">*</span><span class="p">:</span><span class="o">*&</span><span class="n">rows</span><span class="p">=</span>0<span class="o">&</span><span class="n">wt</span><span class="p">=</span><span class="n">json</span><span class="o">&</span><span class="n">indent</span><span class="p">=</span><span class="n">on</span> <span class="o">\</span>
- <span class="o">&</span><span class="n">facet</span><span class="p">=</span><span class="n">on</span><span class="o">&</span><span class="n">facet</span><span class="p">.</span><span class="n">pivot</span><span class="p">=</span><span class="nb">cat</span><span class="p">,</span><span class="n">inStock</span>
+<div class="codehilite"><pre><span class="n">curl</span> <span class="s">'http://localhost:8983/solr/gettingstarted/select?q=*:*&rows=0&wt=json&indent=on'</span><span class="o">\</span>
+<span class="s">'&facet=on&facet.pivot=cat,inStock'</span>
</pre></div>
[... 72 lines stripped ...]