Azure Cognitive Search Lab (refers as AzSearchLab) is a web based debugging tool for Azure Cognitive Search troubleshooting. It provides centralized interface to check the azure search documents, status and other features. It can also help engineer to analyze Search operation.
This project framework provides the following features:
- Query composer
- Index definition
- Document
- Suggestions
- Analyze text
- Auto complete
- Synonyms
- Built-in analyzer
- Web api skill
- .Net 5.0 or greater on your development machine.
- Vistual Studio 2019 or greater version.
- Windows machine.
- Download the source code and build it.
- After finish building, you can run the website locally with IIS Express.
- You can also deploy this website onto your app service.
- Download the source code.
- Build the project.
- Run the project with IIS express.
To run the demo, follow these steps:
-
Open the source code with Vistual Studio 2019 or higher version.
-
Build the source code
-
Run the source code with IIS Express.
-
Enter the search service name and its key. Then load the data.
-
There are GET and POST type query. With this tool, we don't need to check the document for each parameter and its format. We can select the parameter on UI, then test the GET or POST query and analyze its query result.
-
Update index definition
Some time, we need to update the index definition. But it is not allowed on portal and can only be changed via Rest API. We can change the index Json definition with this tool and update the index directly.
-
Query and update document
We also need to change and update the document after finish indexing. We can simply query the documents to find out the one that we want to change, then adjust it and update the changes to index.
-
Test suggestion
This tool provide a UI to simulate the suggestion scenario. So we can test the suggestion and implement similar scenario in our production environment.
-
Test analyzer behavior
We can load the search index and test its analyzers configured in the index. It will show us how the analyzer broke the texts into tokens.
-
Test autocomplete feature
We can test the auto-complete rule of the index and confirm its behavior.
-
Create, update and delete synonyms
We can create, update or delete the synonym on index fields.
We can create new synonym by specify the synonym name, its rule and its applied index fields. We can use Ctrl+Click the fields to multiple select the fields we want to apply.
We can also delete an existing synonym.
We can also update field's synonym by select or un-select them. Please notice that each field can ONLY contains 1 synonym. So if we update the field with a new synonym, the previous synonym configured on this field will be removed automatically.
-
Test built-in analyzer, tokenizer, token filter and char filter
We can also test different built-in analyzer, tokenizer, token filter and char filter to select the one that fit for our project. It will show us how analyzer, tokenizer, token filter and char filter break text into tokens.