# qdrantcluster-shard-manage

**Repository Path**: ma-qingfeng/qdrantcluster-shard-manage

## Basic Information

- **Project Name**: qdrantcluster-shard-manage
- **Description**: 为了解决本地化QdrantCluster集群，只能手动迁移分片和副本丢失后需要手动恢复的问题。
1 通过自动检查shard分布情况，自行规划shard迁移（并轮询分布在即有节点上)。
2 节点异常丢失并无法恢复时，自动检查指定collection缺失的副本，并恢复到既有节点上。
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-01-26
- **Last Updated**: 2025-01-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# qdrantcluster-shard-manage

#### 介绍
为了解决本地化QdrantCluster集群，只能手动迁移分片和副本丢失后需要手动恢复的问题。
1 通过自动检查shard分布情况，自行规划shard迁移（并轮询分布在即有节点上)。
2 节点异常丢失并无法恢复时，自动检查指定collection缺失的副本，并恢复到既有节点上。

####主要参数： 

-  --collection: 要迁移的collection名称（必选） 
-  --from_peer: 源peer ID（必选） 
-  --target-peers: 目标peer ID列表（可选） 
-  --shard-ids: 要迁移的shard ID列表（可选） 
-  --dry-run: 启用dry-run模式（可选） 
-  --api-url: Qdrant API地址（可选，默认http://192.168.67.23:6333） 
-  --replicate: 执行副本恢复而非迁移（可选） 


####使用示例： 

1. 这里是列表文本.  迁移shard:
python qdrant_shard_migration.py my_collection 12345 --target-peers 67890 54321 --shard-ids 1 2 3  
2. 这里是列表文本恢复shard副本:
python qdrant_shard_migration.py my_collection 12345 --replicate  
3. 这里是列表文本查看帮助:
python qdrant_shard_migration.py -h