Set the Type Identifier for a Search Index
- how-to
Use a type identifier with a type mapping to add an extra filter to the documents you want to include in a Search index.
For more information about type identifiers and type mappings, see Customize a Search Index with the Web Console.
Prerequisites
-
You’ve created an index. For more information, see Create a Basic Search Index with the Web Console.
-
You’ve created at least one type mapping in your Search index. For more information, see Create a Type Mapping.
-
You’ve logged in to the Couchbase Server Web Console.
Procedure
To set a type identifier for a Search index with the Couchbase Server Web Console:
-
Go to Search.
-
Click the index where you want to set a type identifier.
-
Click Edit.
-
Do one of the following:
Create a JSON Type Field Type Identifier
To only add documents to your Search index that contain a specific field with a specified string value:
-
Select JSON type field.
-
In the JSON Type Field field, enter the name of the field in your documents that you want to use to filter documents in your Search index.
For example, if your documents include a
type
field, you could entertype
in the JSON Type Field field.You can’t use a field as a type identifier if the field name contains a period (.). -
Under Type Mappings, next to the type mapping where you want to add the type identifier, click Edit.
-
In the # field, add a period (.) to the end of the current type mapping name.
-
After the period, add the exact string from the document field that you want to use as a filter.
For example, if you wanted your Search index to only return documents that had a
type
value ofhotel
, you could enterscope.collection.hotel
in the type mapping # field. -
Click OK.
-
Click Update Index.
Create a Doc ID Up To Separator Type Identifier
To only add documents to your Search index that have IDs that match a specified prefix:
-
Select Doc ID up to Separator.
-
In the Doc ID up to Separator field, enter the ID prefix, up to the separator character, that you want to use to filter documents in your Search index.
For example, if you know all of your document ID values are prefixed by a string and an underscore, enter
_
. -
Under Type Mappings, next to the type mapping where you want to add the type identifier, click Edit.
-
In the # field, add a period (.) to the end of the current type mapping name.
-
After the period, add the exact prefix from the document’s ID value that you want to use as a filter.
For example, if you wanted your Search index to only return documents that have an prefix of
landmark_
, you could enterscope.collection.landmark
in the type mapping # field. -
Click OK.
-
Click Update Index.
Create a Doc ID with Regex Type Identifier
To only add documents to your Search index that have IDs that match a specified RE2 regular expression:
-
Select Doc ID with Regex.
-
In the Doc ID with Regex field, enter the regular expression that you want to use to filter documents in your Search index.
For example, if you wanted only documents with ID values that contained
40
, you could enter[3-5]0
as your regular expression. -
Under Type Mappings, next to the type mapping where you want to add the type identifier, click Edit.
-
In the # field, add a period (.) to the end of the current type mapping name.
-
After the period, add a match for the regular expression from the document’s ID value that you want to use as a filter.
For example, if you wanted your Search index to only return documents with ID values that contained
_40
, you could enterscope.collection._40
in the type mapping # field. -
Click OK.
-
Click Update Index.
Next Steps
After you set the type identifier for your Search index, you can continue to customize your Search index:
To run a search and test the contents of your Search index, see Run A Simple Search with the Web Console or Run a Simple Search with the REST API and curl/HTTP.