index.html 8.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183
  1. <html>
  2. <h1>Solr Search</h1>
  3. <p>The Solr Search application, which is based on <a href="http://lucene.apache.org/solr/">Apache Solr</a>, allows you to perform keyword searches across Hadoop data. A wizard lets you style the result snippets, specify facets to group the results, sort the results, and highlight result fields.</p>
  4. <h2 class="subhead"><a href="http://gethue.tumblr.com/post/66351828212/new-search-feature-graphical-facets">New Search feature: Graphical facets</a></h2>
  5. <p>
  6. <p>This new feature completed in <a href="http://gethue.tumblr.com/post/66661140648/hue-team-retreat-thailand">Thailand</a> lets you search interactively:</p>
  7. <p><iframe frameborder="0" height="495" src="http://player.vimeo.com/video/78887745" width="900"></iframe></p>
  8. <p>As usual feel free to comment on the <a href="https://groups.google.com/a/cloudera.org/group/hue-user/">hue-user</a> list or <a href="https://twitter.com/gethue">@gethue</a>!</p>
  9. </p>
  10. <h2>Solr Search Installation and Configuration</h2>
  11. <p>Solr Search is one of the applications installed as part of Hue. For information about installing and configuring Hue, see the Hue Installation
  12. manual.</p>
  13. <h2>Starting Solr Search</h2>
  14. <p>Click the <strong> Solr Search</strong> icon
  15. (<img alt="image" src="/search/static/art/icon_search_24.png" />) in the navigation bar at the top of
  16. the Hue browser page. <strong>Solr Search</strong> opens to the <a href="#collectionManager">Collection Manager</a>. If there are no collections, the <a href="#importCollection">Import Collections and Cores</a> dialog displays.</p>
  17. <p><a id="collectionManager"></a></p>
  18. <h2>Collection Manager</h2>
  19. <p>In Collection Manager you import, copy, and delete <a href="http://wiki.apache.org/solr/SolrCloud#A_little_about_SolrCores_and_Collections">collections</a>.</p>
  20. <h3>Displaying the Collection Manager</h3>
  21. <p>When you start Solr Search, the Collection Manager displays. You navigate to the Collection Manager by clicking <strong>Collection manager</strong> in the Search page or the Template Editor.</p>
  22. <h3>Filtering Collections</h3>
  23. <p>When you type in the Filter field, the list of collections is dynamically filtered to display only those rows
  24. containing text that matches the specified substring.</p>
  25. <p><a id="importCollection"></a></p>
  26. <h3>Importing Collections</h3>
  27. <ol>
  28. <li>If there are existing collections, click the <i class="fa fa-plus-sign"></i> <strong>Import</strong> button at the top right. The Import Collections and Cores dialog displays.</li>
  29. <li>Check the checkboxes next to the collections to import.</li>
  30. <li>Click <strong>Import Selected</strong>. The collection is added to the Collection Manager.</li>
  31. </ol>
  32. <h3>Editing Collection Properties</h3>
  33. <ol>
  34. <li>In the Collection Manager, click a collection.</li>
  35. <li>In the <strong>COLLECTION</strong> area on the left, click <strong>Properties</strong>.</li>
  36. <li>Edit a property and click <strong>Save</strong>.</li>
  37. </ol>
  38. <h3>Searching a Collection</h3>
  39. <ol>
  40. <li>In the Collection Manager, click <strong>Search page</strong> or click <strong>Search it</strong> in the Collection area on the left. The Search page displays.</li>
  41. <li>Select a collection from the <strong>Search in</strong> drop-down list.</li>
  42. <li>Type a search string in the <strong>Search...</strong> text box.</li>
  43. <li>
  44. <p>Press <strong>Enter</strong> or click the <i class="fa fa-search"></i> icon.</p>
  45. </li>
  46. <li>
  47. <p>If you have defined <a href="#facets">facets</a>, click a facet to display only those results in the group defined by the facet.</p>
  48. </li>
  49. <li>If you have defined <a href="#sorting">sorting fields</a>, select from the <strong>Sort by</strong> drop-down list to sort the results.</li>
  50. <li>Click 'X' to clear the search string.</li>
  51. </ol>
  52. <h2>Styling Search Results</h2>
  53. <p>Do one of the following:</p>
  54. <ul>
  55. <li>In the Collection Manager, click a collection.</li>
  56. <li>In the Search page, select a collection from the <strong>Search in</strong> drop-down list and click <strong> Customize this collection</strong>. The Template Editor displays.</li>
  57. </ul>
  58. <h3>Template Editor</h3>
  59. <p>The Template Editor provides four features:</p>
  60. <ul>
  61. <li><a href="#snippetEditor">Snippet editor</a> - Specify the layout of the search result snippet, which fields appear in the snippet, and style the results.</li>
  62. <li><a href="#facetEditor">Facet editor</a> - Define buckets in which to group results.</li>
  63. <li><a href="#sortEditor">Sort editor</a> - Specify on which fields and order the results are sorted. </li>
  64. <li><a href="#highlightingEditor">Highlighting editor</a> - Enable highlighting of search fields. </li>
  65. </ul>
  66. <p><a id="snippetEditor"></a></p>
  67. <h4>Snippet Editor</h4>
  68. <ol>
  69. <li>In the Snippet Editor, click a tab to choose the method for editing the search snippet fields and styling:</li>
  70. <li>
  71. <ul>
  72. <li><strong>Visual editor</strong> - Click <img alt="image" src="images/layoutChooser.png" /> to choose an overall layout for the snippet.</li>
  73. </ul>
  74. </li>
  75. <li>
  76. <ul>
  77. <li>
  78. <ul>
  79. <li>Select the fields and functions from the drop-down lists on the right and click <img alt="image" src="images/add.png" />. </li>
  80. </ul>
  81. </li>
  82. </ul>
  83. </li>
  84. <li>
  85. <ul>
  86. <li>
  87. <ul>
  88. <li>Select fields, right-click, and select <strong>Cut</strong> and <strong>Paste</strong> to place the fields on the canvas. </li>
  89. </ul>
  90. </li>
  91. </ul>
  92. </li>
  93. <li>
  94. <ul>
  95. <li>
  96. <ul>
  97. <li>Select fields and apply styling using the buttons on top.</li>
  98. </ul>
  99. </li>
  100. </ul>
  101. </li>
  102. <li>
  103. <ul>
  104. <li><strong>Source</strong> - </li>
  105. </ul>
  106. </li>
  107. <li>
  108. <ul>
  109. <li>
  110. <ul>
  111. <li>Select the data fields and functions from the drop-down lists on the right.</li>
  112. </ul>
  113. </li>
  114. </ul>
  115. </li>
  116. <li>
  117. <ul>
  118. <li>
  119. <ul>
  120. <li>Specify layout and styling using HTML tags.</li>
  121. </ul>
  122. </li>
  123. </ul>
  124. </li>
  125. <li>
  126. <ul>
  127. <li><strong>Preview</strong> - Preview the snippet.</li>
  128. </ul>
  129. </li>
  130. <li>
  131. <ul>
  132. <li><strong>Advanced</strong> - Specify styles for CSS classes specified in the Source tab.</li>
  133. </ul>
  134. </li>
  135. <li>Click <strong>Save</strong>.</li>
  136. </ol>
  137. <p><a id="facetEditor"></a></p>
  138. <h4>Facet Editor</h4>
  139. <p>By default, faceting search result fields is disabled. Click <strong>Enabled</strong> to enable faceting.</p>
  140. <ol>
  141. <li>In the Template Editor, click <strong>2. Facets</strong>. You can move between the facet tabs by clicking each <strong>Step</strong> tab, or by clicking <strong>Back</strong> and <strong>Next</strong>.</li>
  142. <li>In the General tab, specify </li>
  143. <li>
  144. <ul>
  145. <li><strong>Limit</strong> - the maximum number of values for each facet.</li>
  146. </ul>
  147. </li>
  148. <li>
  149. <ul>
  150. <li><strong>Mincount</strong> - the minimum number of search results that fall into a group for the facet to display on the Search page.</li>
  151. </ul>
  152. </li>
  153. <li>In the Field, Range, and Date Facet tabs, specify the facet properties and click <img alt="image" src="images/add.png" /> <strong>Add</strong>.</li>
  154. <li>In the Facets Order tab, drag and drop the facet to specify the order in they appear in the Search page.</li>
  155. <li>Click <strong>Save</strong>. When you display the Search page, the facets display on the left.</li>
  156. </ol>
  157. <p><a id="sortEditor"></a></p>
  158. <h4>Sorting Editor</h4>
  159. <p>By default, sorting on search result fields is disabled. Click <strong>Enabled</strong> to enable sorting.</p>
  160. <ol>
  161. <li>In the Template Editor, click <strong>3. Sorting</strong>. </li>
  162. <li>In the Field drop-down, select a field. Optionally specify a label for the field. </li>
  163. <li>The default order is ascending. Click the arrows to change the order.</li>
  164. <li>Click <img alt="image" src="images/add.png" /> <strong>Add</strong>.</li>
  165. <li>Click <strong>Save</strong>. When you display search results, the results are sorted by the fields in the order that they appear left to right. </li>
  166. </ol>
  167. <p><a id="highlightingEditor"></a></p>
  168. <h4>Highlighting Editor</h4>
  169. <p>By default,highlighting search result fields is disabled. Click <strong>Enabled</strong> to enable highlighting.</p>
  170. <ol>
  171. <li>In the Template Editor, click <strong>3. Highlighting</strong>. </li>
  172. <li>Select the fields to be highlighted.</li>
  173. <li>Click <strong>Save</strong>. When you display search results, the selected fields are displayed with the style of the <strong>em</strong> class defined in the Advanced tab of the <a href="#snippetEditor">Snippet editor</a>. </li>
  174. </ol>
  175. </html>