milvus-logo
LFAI
< Docs
  • Java

describeIndex()

MilvusClient interface. This method shows the information of the specified index.

R<DescribeIndexResponse> describeIndex(DescribeIndexParam requestParam);

DescribeIndexParam

Use the DescribeIndexParam.Builder to construct a DescribeIndexParam object.

import io.milvus.param.DescribeIndexParam;
DescribeIndexParam.Builder builder = DescribeIndexParam.newBuilder();

Methods of DescribeIndexParam.Builder:

Method

Description

Parameters

withCollectionName(collectionName)

Set the collection name. Collection name cannot be empty or null.

collectionName: The target collection name.

withDatabaseName(String databaseName)

Sets the database name. database name can be null for default database.

databaseName: The database name.

withIndexName(String indexName)

Set the target index name. If no index name is specified, the default index name is empty string which means let the server determine it.

indexName: The name of the index.

withFieldName(String fieldName)

Sets the target field name. Field name can be empty or null.
If no field name is specified, then return all this collection indexes.

fieldName: The field name.

build()

Construct a DescribeIndexParam object.

N/A

The DropIndexParam.Builder.build() can throw the following exceptions:

  • ParamException: error if the parameter is invalid.

Returns

This method catches all the exceptions and returns an R<DescribeIndexResponse> object.

  • If the API fails on the server side, it returns the error code and message from the server.

  • If the API fails by RPC exception, it returns R.Status.Unknown and error message of the exception.

  • If the API succeeds, it returns a valid DescribeIndexResponse held by the R template. You can use DescIndexResponseWrapper to get index descriptions easily.

DescIndexResponseWrapper

A tool class to encapsulate the DescribeIndexResponse.

import io.milvus.response.DescIndexResponseWrapper;
DescIndexResponseWrapper wrapper = new DescIndexResponseWrapper(descIndexResponse);

Methods of DescIndexResponseWrapper:

Method

Description

Parameters

Returns

getIndexDescriptions()

Get a list of all index descriptions. (Currently only return one index information)

N/A

List<IndexDesc>

getIndexDescByFieldName(String fieldName)

Get index description by field name. Return null if the field doesn't exist.

fieldName: A field name

IndexDesc

IndexDesc

A tool class to describe an index.

Methods of DescIndexResponseWrapper.IndexDesc

Method

Description

Returns

getIndexType()

Get index type.

IndexType

getMetricType()

Get metric type.

MetricType

getExtraParam()

Get index parameters in JSON format.

String

Example

import io.milvus.param.*;
import io.milvus.response.DescIndexResponseWrapper;
import io.milvus.grpc.DescribeIndexResponse;

DescribeIndexParam param = DescribeIndexParam.newBuilder()
        .withCollectionName(COLLECTION_NAME)
        .withIndexName("index1")
        .build();
R<DescribeIndexResponse> response = client.describeIndex(param)
if (response.getStatus() != R.Status.Success.getCode()) {
    System.out.println(response.getMessage());
}

DescIndexResponseWrapper wrapper = new DescIndexResponseWrapper(response.getData());
for (DescIndexResponseWrapper.IndexDesc desc : wrapper.getIndexDescriptions()) {
    System.out.println(desc.toString());
}

Try Managed Milvus for Free

Zilliz Cloud is hassle-free, powered by Milvus and 10x faster.

Get Started
Feedback

Was this page helpful?