Macrometa GDN | Search

Introduction to Search

Macrometa GDN Search offers a full-text search engine that supports all of the data models available on our platform. This Includes Key/Value, Document, GraphEdge, and DynamoDB collections. You can use the GDN Console to create Search Views and use Analyzers to increase the efficiency of your search queries. Search is also integrated C8QL with the SEARCH operation to make building your search queries even easier.

This article will walk you through using Search in the GDN Console. You can review our Search documentation here to learn more, https://macrometa.com/docs/search/Overview/.

Search

Log in to the Macrometa GDN and navigate to the SEARCH section in the sidebar menu.

Click to open the image in a new tab.

This window contains all of the Search Views that have been created on your account. In this case, we have a view named "testView".

Click to open the image in a new tab.

1. Name:
   The names of created views set by the user.
   
   
2. Type:
   Type of view will be shown under the TYPE column. “Search” is the only type by default.
   
   
3. ID:
   An auto-generated unique ID created by the system for each view.

Click to open the image in a new tab.

1. Filter:
   A search bar to filter views from the list.
   
   
2. Sorting:
   Sort the list of views in ascending or descending order.
   
   
3. New View:
   Click to create a New View using this button.

View:

A View is a representation of all documents accessible in a given set of source collections. Each View is an abstraction based on the View definition. We will guide you through creating a new Search View in the GDN Console.

Creating a New View:

Click on the New View button to open the window shown below. 

Click to open the image in a new tab.

1. Name:
   Set a name for the new View. The name must be unique for each View created.
   
   
2. Type:
   Type of View being created. Only “Search” type is available by default.
   
   

   Mapping Definition:

   Under Mapping Definition, users can choose one or more collections and fields from those collections. The indexes for the Search View will be created from the specified collections and fields. Multiple Collection/Field/Analyzer combinations can be added by pressing the "Plus Icon" to select a Collection, Field, and Analyzer.
   
   

3. Collection:
   Select from a dropdown menu of collections.
   
   
4. Field:
   Enter the field name for the selected collection.
   
   
5. Analyzer:
   Users can use built-in analyzers to divide search inputs into groups of sub-values for better searching and sorting. Macrometa currently offers two types of Analyzers, an Identity Analyzer, and multiple Text Analyzers. You can read more about the Built-In Analyzers here, https://macrometa.com/docs/search/Analyzers/#built-in-analyzers. 
   
   

   
   Click to open the image in a new tab.
   

   Identity Analyzer:
   An identity Analyzer returns the input unmodified and supports no properties.
   
   Text Analyzer:
   Text Analyzers break strings into individual words. Optionally, you can filter out stop-words, extract word stems, and apply case conversion and accent removal.
   
   

   Primary Sort:

   Primary sort enables a user to sort the order with more than one attribute for instance text, date, ascending or descending order, etc., for better optimization of queries. When a user creates a Search View, they can choose a primary sort order for each uniquely named attribute. Primary sort order, once a View is created, cannot be modified.

6. Field:
   Specify the sorting of View according to collections and fields in the mapping definition.
   
   
7. Direction:
   Set the sorting order to either ascending or descending. Ascending order is set as default by the system.

Rename/ Delete:

After the View is created, it appears in the main search window. On the right-hand side, you will see Rename and Delete options.

1. Delete:
   Delete an existing View.
   
   Click to open the image in a new tab.
   
   
2. Rename:
   Rename an existing Search View.
   
   Click to open the image in a new tab.

Edit View:

Users can edit a View after it is created. By clicking on the View name user can edit the View. This option allows a user to edit the name and Mapping Definitions of View. Primary Sort as described, cannot be edited once a View is created.

Click to open the image in a new tab.

Conclusion:

Macrometa Search is an easy way to improve the performance of your search queries. The ability to search across multiple data models and a range of advanced features enables complex use cases. For more in-depth information please visit the documentation resources below.

Documentation Resources:

Search Overview

C8QL Search Operation

Search Views