ManticoreSearch.Provider 1.3.1

ManticoreProvider

Manticore Search – easy-to-use open-source fast database for search

Initial release of ManticoreSearch.Provider providing API integration with ManticoreSearch for .NET applications. This version includes features for full-text search, autocomplete, fuzzy search, basic CRUD operations, support for custom queries and filters, and flexible indexing and query expansion options. Designed to simplify ManticoreSearch integration in .NET projects.

Note: If you find errors or bugs in the library, please write in the issues section

Usage

Creating an Instance

Create an instance of ManticoreProvider, specifying the base address of Manticore Search. If the address is not specified, http://localhost:9308 will be used by default.

var provider = new ManticoreProvider(); // defaults to http://localhost:9308
// or
var provider = new ManticoreProvider("http://your-manticore-address");

Executing SQL Queries

To execute an SQL query, use the Sql method or its asynchronous variant SqlAsync:

string result = provider.Sql("SELECT * FROM your_index");
// or
string resultAsync = await provider.SqlAsync("SELECT * FROM your_index");

Inserting Documents

To insert documents into the index, use the Insert method or InsertAsync:

var request = new ModificationRequest<TestIndex>
{
    Index = "test_index",
    Id = 10,
    Document = new TestIndex
    {
        Title = "Test Document",
        Content = "This is a test content" ,
        Price = 19.99f,
    }
};

var result = await provider.InsertAsync(request);

Bulking Documents

To perform bulk upload of documents use Bulk method or BulkAsync:

var bulkRequests = new List<BulkInsertRequest<TestIndex>>
{
    new (new ModificationRequest<TestIndex>
    {
        Index = "test_index",
        Id = 1001,
        Document = new TestIndex
        {
            Title = "Bulk Test Document 2",
            Content = "Content for bulk test 2",
            Price = 20.99f
        }
    }),
    new (new ModificationRequest<TestIndex>
    {
        Index = "test_index",
        Id = 1002,
        Document = new TestIndex
        {
            Title = "Bulk Test Document 3",
            Content = "Content for bulk test 3",
            Price = 30.99f
        }
    })
};

var result = await provider.BulkAsync(bulkRequests);

Replacement of Documents

To replace documents, use Replace method or ReplaceAsync:

var replaceRequest = new ModificationRequest<TestIndex>
{
    Index = "test_index",
    Id = 3000,
    Document = new TestIndex
    {
        Title = "Updated Title",
        Content = "Updated Content",
        Price = 19.99f
    }
};

var result = await provider.ReplaceAsync(replaceRequest);

Bulk Replacement of Documents

To perform a bulk document replacement, use BulkReplace method or BulkReplaceAsync:

var bulkRequests = new List<BulkReplaceRequest<TestIndex>>
{
    new (new ModificationRequest<TestIndex>
    {
        Index = "test_index",
        Id = 1,
        Document = new TestIndex
        {
            Title = "Updated Document 1",
            Content = "Updated content for document 1",
            Price = 25.99f,
            Category = "updated"
        }
    }),
    new (new ModificationRequest<TestIndex>
    {
        Index = "test_index",
        Id = 2,
        Document = new TestIndex
        {
            Title = "Updated Document 2",
            Content = "Updated content for document 2",
            Price = 35.99f,
            Category = "updated"
        }
    })
};

var result = await provider.BulkReplaceAsync(bulkRequests);

Updating Documents

To update documents, use Update method or UpdateAsync:

var doc = new UpdateRequest<Products>
{
    Index = "products",
    Document = new Products
    {
        Title = "book"
    },
    Query = new Query
    {
        Equals = new Dictionary<string, object>
        {
            { "price", 25 }
        }
    }
};

var result = provider.Update(doc);

Bulk Updating Documents

To update documents, use BulkUpdate method or BulkUpdateAsync:

var insertRequest = new ModificationRequest<TestIndex>
{
    Index = "test_index",
    Id = 13,
    Document = new TestIndex
    {
        Title = "Title",
        Content = "Content"
    }
};

await provider.InsertAsync(insertRequest);

var bulkRequests = new List<BulkUpdateRequest<TestIndex>>
{
    {
        new BulkUpdateRequest<TestIndex>
        {
            Update = new UpdateRequest<TestIndex>
            {
                Index = "test_index",
                Id = 13,
                Document = new TestIndex
                {
                    Title = "First Update",
                    Content = "First content"
                }
            }
        }
    }
};

var result = await provider.BulkUpdateAsync(bulkRequests);

Search by Documents

To search documents, use Search method or SearchAsync:

var searchRequest = new SearchRequest(
    index: "test_index",
    query: new Query
    {
        Match = new Dictionary<string, object>
        {
            { "content", new { query = "comprehensive test" } }
        }
    },
    source: new { includes = new List<string> { "id", "title", "content" } },
    profile: true,
    limit: 20,
    offset: 5,
    size: 15,
    from: 0,
    maxMatches: 100,
    sort: new List<object> { new { content = "desc" } },
    options: new OptionDetails
    {
        MaxMatches = 1000,
        Ranker = RankerOption.Bm25,
        Threads = 4
    },
    highlight: new HighlightOptions
    {
        BeforeMatch = "<b>",
        AfterMatch = "</b>",
        Limit = 3
    },
    trackScores: true
);

var result = await provider.SearchAsync(searchRequest);

Deleting Documents

To delete documents, use Delete method or DeleteAsync:

var request = new DeleteRequest
{
    Index = "products",
    Query = new Query
    {
        Equals = new Dictionary<string, object>
        {
            { "title", "book" }
        }
    }
};

var result = await provider.DeleteAsync(doc);

Bulk Deletion of Documents

To perform bulk deletion of documents use BulkDelete method or BulkDeleteAsync:

var request = new List<BulkDeleteRequest>
{
    {
        new BulkDeleteRequest
        {
            Delete = new DeleteRequest
            {
                Index = "test_index",
                Id = 1
            }
        }
    },
    {
        new BulkDeleteRequest
        {
            Delete = new DeleteRequest
            {
                Index = "test_index",
                Id = 2
            }
        }
    }
};

var result = await provider.BulkDeleteAsync(request);

Working with Percolators

To index and search using percolators, use the IndexPercolate, Percolate, GetPercolate and UpdatePercolate methods and their asynchronous versions:

var percolate = new PercolateRequest<Products>
{
    Query = new PercolateRequestQuery<Products>
    {
        Percolate = new PercolateDocument<Products>
        {
            Documents =
            [
                new Products
                {
                    Title = "chocolate"
                },
                new Products
                {
                    Title = "banana"
                }
            ]
        }
    }
};

var result = await provider.PercolateAsync(percolate, "mypq");

Autocomplete request

Retrieves autocomplete suggestions based on the provided autocomplete query. Use the Autocomplete or AutocompleteAsync methods:

var request = new AutocompleteRequest
{
    Index = "articles",
    Query = "Tr"
};

var result = await provider.AutocompleteAsync(request);

Mapping request

Defines a new table structure in Manticore search engine using the specified mapping properties, mimicking Elasticsearch-like table definitions. Use the UseMapping or UseMappingAsync methods:

var request = new MappingRequest
{
    Properties = new Dictionary<string, MappingField>
    {
        { "exercise", new MappingField { Type = MappingFieldType.Keyword } },
        { "working_weight", new MappingField { Type = MappingFieldType.Integer } },
        { "weight_limit", new MappingField { Type = MappingFieldType.Integer } }
    }
};

var result = await provider.UseMappingAsync(request, "training");

Exceptions

• AutocompleteException — on Autocomplete request error.
• BulkException — on Bulk request error.
• DeleteException — on Delete request error.
• MappingException — on Mapping request error.
• ModificationException — on Modification request error.
• PercolateException — on Percolate request error.
• SearchException — on Search request error.
• SqlException — on SQL request error.
• UpdateException — on Update request error.

Cleanup

Remember to release resources by calling the Dispose method when you are done using ManticoreProvider.

provider.Dispose();