Java SDK删除Partition实战教程
使用Java SDK从Collection中删除Partition,是向量数据库日常管理中的关键操作。下面通过详细步骤演示具体实现方法。
操作前必须明确:删除Partition会永久清除该分区内的全部数据,且不可恢复。若仅需临时禁用分区,建议先确认删除必要性——数据丢失后无法还原。
前提条件
- 已完成Cluster创建:详见“创建Cluster”文档。
- 已获取API-KEY:通过“API-KEY管理”获取。
- 已安装最新DashVector SDK:参照“安装DashVector SDK”完成。
接口定义
先了解Java SDK中该接口的定义:
// class DashVectorCollection
public Response deletePartition(String name); 该方法接收Partition名称作为参数,返回类型为Response。用法简洁直观。
使用示例
注意事项
- 请将示例中的
YOUR_API_KEY替换为实际API-KEY,YOUR_CLUSTER_ENDPOINT替换为Cluster的Endpoint,否则代码无法运行。 - 需提前创建名为
quickstart的Collection(参见“新建Collection”)。 - 同时在该Collection中预先创建名为
shoes的Partition(参见“新建Partition”)。
参考代码示例:
import com.aliyun.dashvector.DashVectorClient;
import com.aliyun.dashvector.DashVectorCollection;
import com.aliyun.dashvector.common.DashVectorException;
import com.aliyun.dashvector.models.responses.Response;
public class Main {
public static void main(String[] args) throws DashVectorException {
DashVectorClient client = new DashVectorClient("YOUR_API_KEY", "YOUR_CLUSTER_ENDPOINT");
DashVectorCollection collection = client.get("quickstart");
// 删除名为shoes的Partition
Response response = collection.deletePartition("shoes");
// 判断请求是否成功
// assert response.isSuccess();
}
} 流程清晰:初始化客户端后获取Collection实例,调用deletePartition方法即可。末尾注释演示了通过Response判断操作成败的方式,实际开发中可据此处理异常。
入参描述
| 参数 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
| name | String | 是 | - | 要删除的Partition名称 |
仅一个参数,名称需唯一标识且大小写敏感,必须与创建时完全相同。
出参描述
返回参数说明
Response对象封装了操作结果,常用方法见下表:
| 方法 | 类型 | 描述 | 示例 |
|---|---|---|---|
| getCode() | int | 返回状态码,参考状态码说明 | 0 |
| getMessage() | String | 返回消息内容 | success |
| getRequestId() | String | 请求唯一标识 | 19215409-ea66-4db9-8764-26ce2eb5bb99 |
| isSuccess() | Boolean | 判断请求是否执行成功 | true |
通常通过isSuccess()返回true判定删除成功。若返回false,可借助getCode()和getMessage()排查具体错误原因。
删除Partition的API调用十分简洁,但数据不可逆的特性要求操作前务必确认。建议先对非关键数据测试,验证流程无误后再投入生产环境。
