RunAnalyzer()

This operation dry-runs an analyzer.

Status RunAnalyzer(const RunAnalyzerRequest& request, RunAnalyzerResponse& response)

Request Syntax

auto request = RunAnalyzerRequest()
    .WithDatabaseName(db_name)
    .WithCollectionName(collection_name)
    .WithFieldName(field_name)
    .WithTexts(texts)
    .WithAnalyzerParams(params)
    .WithDetail(with_detail)
    .WithHash(with_hash);

REQUEST METHODS:

• WithDatabaseName(const std::string& db_name)

  Sets the target database name. The default database applies if it is empty.

• WithCollectionName(std::string collection_name)

  Sets the name of the collection.

• WithFieldName(std::string field_name)

  Sets the name of the target field, which cannot be empty.

• WithTexts(const std::vector<std::string>& texts)

  Sets the texts to be analyzed.

• AddText(std::string text)

  Adds the text for analyze.

• AddAnalyzerName(std::string name)

  Sets the name of the analyzer to run.

• WithAnalyzerParams(const nlohmann::json& params)

  Sets the analyzer parameters.

• WithDetail(bool with_detail)

  Whether to include the details in the returned results.

• WithHash(bool with_hash)

  Whether to include the hashed values in the returned results.

RETURNS:

Status with RunAnalyzerResponse

Check status.IsOk() to confirm success.

EXCEPTIONS:

• StatusCode

  Check status.Code() and status.Message() for error details.

Example

#include "milvus/MilvusClientV2.h"
auto client = milvus::MilvusClientV2::Create();

milvus::ConnectParam connect_param{"http://localhost:19530", "root:Milvus"};
auto status = client->Connect(connect_param);
if (!status.IsOk()) {
    std::cout << status.Message() << std::endl;
}

// Define analyzer parameters (stop-word filter example)
nlohmann::json analyzer_params = {
    {"tokenizer", "standard"},
    {"filter", {{{"type", "stop"}, {"stop_words", {"and", "for"}}}}},
};
std::string text = "Milvus supports L2 distance and IP similarity for float vector.";

// Build and execute the RunAnalyzer request
auto request =
    milvus::RunAnalyzerRequest().AddText(text).WithAnalyzerParams(analyzer_params).WithDetail(true).WithHash(true);

milvus::RunAnalyzerResponse response;
status = client->RunAnalyzer(request, response);
if (!status.IsOk()) {
    std::cout << status.Message() << std::endl;
}

// Process analyzer results
for (const auto& result : response.Results()) {
    for (const auto& token : result.Tokens()) {
        std::cout << "{token: " << token.token_
                  << ", start: " << token.start_offset_
                  << ", end: " << token.end_offset_
                  << "}" << std::endl;
    }
}