Package io.milvus.client

Interface MilvusClient

All Known Implementing Classes:

MilvusGrpcClient

public interface MilvusClient

The Milvus Client Interface

Field Summary

Fields

Modifier and Type	Field	Description
static String	clientVersion

Method Summary

Modifier and Type	Method	Description
Response	connect(ConnectParam connectParam)	Connects to Milvus server
Response	createIndex(CreateIndexParam createIndexParam)	Creates index specified by indexParam
Response	createTable(TableSchemaParam tableSchemaParam)	Creates table specified by tableSchemaParam
Response	deleteByRange(DeleteByRangeParam deleteByRangeParam)	Deletes vectors by date range, specified by deleteByRangeParam
DescribeIndexResponse	describeIndex(TableParam tableParam)	Describes table index specified by tableParam
DescribeTableResponse	describeTable(TableParam tableParam)	Describes table specified by tableParam
Response	disconnect()	Disconnects from Milvus server
Response	dropIndex(TableParam tableParam)	Drops table index specified by tableParam
Response	dropTable(TableParam tableParam)	Drops the table specified by tableParam
default String	getClientVersion()
Response	getServerStatus()	Prints server status
Response	getServerVersion()	Prints server version
GetTableRowCountResponse	getTableRowCount(TableParam tableParam)	Gets current row count of table specified by tableParam
HasTableResponse	hasTable(TableParam tableParam)	Check whether the table specified by tableParam exists
InsertResponse	insert(InsertParam insertParam)	Inserts data specified by insertParam
boolean	isConnected()
Response	preloadTable(TableParam tableParam)	Pre-loads table to memory
SearchResponse	search(SearchParam searchParam)	Searches vectors specified by searchParam
SearchResponse	searchInFiles(SearchInFilesParam searchInFilesParam)	Searches vectors in specific files specified by searchInFilesParam
ShowTablesResponse	showTables()	Shows current tables

Field Detail

clientVersion

static final String clientVersion

See Also:

Constant Field Values

Method Detail

getClientVersion

default String getClientVersion()

Returns:

the current Milvus client version

connect

Response connect(ConnectParam connectParam)
          throws ConnectFailedException

Connects to Milvus server

Parameters:

connectParam - the ConnectParam object

 example usage:
 
 ConnectParam connectParam = new ConnectParam.Builder()
                                             .withHost("localhost")
                                             .withPort("19530")
                                             .build();
 
 

Returns:

Response

Throws:

ConnectFailedException - if client failed to connect

See Also:

ConnectParam, Response, ConnectFailedException

isConnected

boolean isConnected()

Returns:

true if the client is connected to Milvus server

disconnect

Response disconnect()
             throws InterruptedException

Disconnects from Milvus server

Returns:

Response

Throws:

InterruptedException

See Also:

Response

createTable

Response createTable(TableSchemaParam tableSchemaParam)

Creates table specified by tableSchemaParam

Parameters:

tableSchemaParam - the TableSchemaParam object

 example usage:
 
 TableSchema tableSchema = new TableSchema.Builder(tableName, dimension)
                                          .withIndexFileSize(1024)
                                          .withMetricType(MetricType.IP)
                                          .build();
 TableSchemaParam tableSchemaParam = new TableSchemaParam.Builder(tableSchema)
                                                         .withTimeout(timeout)
                                                         .build();
 
 

Returns:

Response

See Also:

TableSchema, TableSchemaParam, MetricType, Response

hasTable

HasTableResponse hasTable(TableParam tableParam)

Check whether the table specified by tableParam exists

Parameters:

tableParam - the TableParam object

 example usage:
 
 TableParam tableParam = new TableParam.Builder(tableName)
                                       .withTimeout(timeout)
                                       .build();
 
 

Returns:

HasTableResponse

See Also:

TableParam, HasTableResponse, Response

dropTable

Response dropTable(TableParam tableParam)

Drops the table specified by tableParam

Parameters:

tableParam - the TableParam object

 example usage:
 
 TableParam tableParam = new TableParam.Builder(tableName)
                                       .withTimeout(timeout)
                                       .build();
 
 

Returns:

Response

See Also:

TableParam, Response

createIndex

Response createIndex(CreateIndexParam createIndexParam)

Creates index specified by indexParam

Parameters:

createIndexParam - the CreateIndexParam object

 example usage:
 
 Index index = new Index.Builder()
                        .withIndexType(IndexType.IVF_SQ8)
                        .withNList(16384)
                        .build();
 CreateIndexParam createIndexParam = new CreateIndexParam.Builder(tableName)
                                                         .withIndex(index)
                                                         .withTimeout(timeout)
                                                         .build();
 
 

Returns:

Response

See Also:

Index, CreateIndexParam, IndexType, Response

insert

InsertResponse insert(InsertParam insertParam)

Inserts data specified by insertParam

Parameters:

insertParam - the InsertParam object

 example usage:
 
 InsertParam insertParam = new InsertParam.Builder(tableName, vectors)
                                          .withVectorIds(vectorIds)
                                          .withTimeout(timeout)
                                          .build();
 
 

Returns:

InsertResponse

See Also:

InsertParam, InsertResponse, Response

search

SearchResponse search(SearchParam searchParam)

Searches vectors specified by searchParam

Parameters:

searchParam - the SearchParam object

 example usage:
 
 SearchParam searchParam = new SearchParam.Builder(tableName, vectorsToSearch)
                                          .withTopK(topK)
                                          .withNProbe(nProbe)
                                          .withDateRanges(dateRanges)
                                          .withTimeout(timeout)
                                          .build();
 
 

Returns:

SearchResponse

See Also:

SearchParam, DateRange, SearchResponse, SearchResponse.QueryResult, Response

searchInFiles

SearchResponse searchInFiles(SearchInFilesParam searchInFilesParam)

Searches vectors in specific files specified by searchInFilesParam

Parameters:

searchInFilesParam - the SearchInFilesParam object

 example usage:
 
 SearchParam searchParam = new SearchParam.Builder(tableName, vectorsToSearch)
                                          .withTopK(topK)
                                          .withNProbe(nProbe)
                                          .withDateRanges(dateRanges)
                                          .build();
 SearchInFilesParam searchInFilesParam = new SearchInFilesParam.Builder(fileIds, searchParam)
                                                               .withTimeout(timeout)
                                                               .build();
 
 

Returns:

SearchResponse

See Also:

SearchInFilesParam, SearchParam, DateRange, SearchResponse, SearchResponse.QueryResult, Response

describeTable

DescribeTableResponse describeTable(TableParam tableParam)

Describes table specified by tableParam

Parameters:

tableParam - the TableParam object

 example usage:
 
 TableParam tableParam = new TableParam.Builder(tableName)
                                       .withTimeout(timeout)
                                       .build();
 
 

Returns:

DescribeTableResponse

See Also:

TableParam, DescribeTableResponse, Response

showTables

ShowTablesResponse showTables()

Shows current tables

Returns:

ShowTablesResponse

See Also:

ShowTablesResponse, Response

getTableRowCount

GetTableRowCountResponse getTableRowCount(TableParam tableParam)

Gets current row count of table specified by tableParam

Parameters:

tableParam - the TableParam object

 example usage:
 
 TableParam tableParam = new TableParam.Builder(tableName)
                                       .withTimeout(timeout)
                                       .build();
 
 

Returns:

GetTableRowCountResponse

See Also:

GetTableRowCountResponse, Response

getServerStatus

Response getServerStatus()

Prints server status

Returns:

Response

See Also:

Response

getServerVersion

Response getServerVersion()

Prints server version

Returns:

Response

See Also:

Response

deleteByRange

Response deleteByRange(DeleteByRangeParam deleteByRangeParam)

Deletes vectors by date range, specified by deleteByRangeParam

Parameters:

deleteByRangeParam - the DeleteByRangeParam object

 example usage:
 
 DeleteByRangeParam deleteByRangeParam = new DeleteByRangeParam.Builder(dateRange, tableName)
                                                               .withTimeout(timeout)
                                                               .build();
 
 

Returns:

Response

See Also:

DeleteByRangeParam, DateRange, Response

preloadTable

Response preloadTable(TableParam tableParam)

Pre-loads table to memory

Parameters:

tableParam - the TableParam object

 example usage:
 
 TableParam tableParam = new TableParam.Builder(tableName)
                                       .withTimeout(timeout)
                                       .build();
 
 

Returns:

Response

See Also:

TableParam, Response

describeIndex

DescribeIndexResponse describeIndex(TableParam tableParam)

Describes table index specified by tableParam

Parameters:

tableParam - the TableParam object

 example usage:
 
 TableParam tableParam = new TableParam.Builder(tableName)
                                       .withTimeout(timeout)
                                       .build();
 
 

Returns:

DescribeIndexResponse

See Also:

TableParam, DescribeIndexResponse, Index, Response

dropIndex

Response dropIndex(TableParam tableParam)

Drops table index specified by tableParam

Parameters:

tableParam - the TableParam object

 example usage:
 
 TableParam tableParam = new TableParam.Builder(tableName)
                                       .withTimeout(timeout)
                                       .build();
 
 

Returns:

dropIndex

See Also:

TableParam, Response