renameCollection()
A MilvusClient interface. This method renames the specified collection.
R<RpcStatus> renameCollection(RenameCollectionParam requestParam)
RenameCollectionParam
Use the RenameCollectionParam.Builder
to construct a RenameCollectionParam
object.
import io.milvus.param.RenameCollectionParam;
RenameCollectionParam.Builder builder = RenameCollectionParam.newBuilder();
Methods of RenameCollectionParam.Builder
:
Method |
Description |
Parameters |
---|---|---|
withOldCollectionName(String oldCollectionName) |
Sets the old collection name. Old collection name cannot be empty or null. |
oldCollectionName: The old name of the collection to rename. |
withNewCollectionName(String newCollectionName) |
Sets the new collection name. New collection name cannot be empty or null. |
newCollectionName: The new name of the collection to rename. |
withOldDatabaseName(String databaseName) |
Sets the database name of the old collection. database name can be null for default database. |
databaseName: The database name. |
withNewDatabaseName(String databaseName) |
Sets the database name of the new collection. database name can be null for default database. |
databaseName: The database name. |
build() |
Constructs a RenameCollectionParam object. |
N/A |
The RenameCollectionParam.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<RpcStatus>
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 the error message of the exception.If the API succeeds, it returns
R.Status.Success
.
Example
import io.milvus.param.*;
RenameCollectionParam param = RenameCollectionParam.newBuilder()
.withOldCollectionName(OLD_COLLECTION_NAME)
.withNewCollectionName(NEW_COLLECTION_NAME)
.build();
R<Boolean> response = client.renameCollection(param);
if (response.getStatus() != R.Status.Success.getCode()) {
System.out.println(response.getMessage());
}