get_replicas()

Near Deprecation

此操作获取当前已加载副本的信息。

请求语法

python

get_replicas(
    timeout: float | None
)

参数：

• timeout (float | None)

  此操作的超时时长。将其设置为 None 表示当收到任意响应或发生任意错误时，此操作即超时。

返回类型：

Replica

返回值：

一个 Replica 对象，包含以下字段：

• groups (list)

  副本组列表。每个 Group 对象包含以下字段：

  • id (int)

    组 ID。

  • group_nodes (tuple)

    一个元组，包含所涉及查询节点的 ID

  • resource_group (str)

    上述查询节点所属资源组的名称

  • shards (list)

    Shard 对象列表，包含以下字段：

    • channel_name (str)

    • shard_leader (int)

    • shard_nodes (set)

Note

什么是副本？

借助副本，Zilliz Cloud 可以在多个查询节点上加载相同的 Segment。如果某个查询节点发生故障，或在另一条搜索请求到达时正忙于处理当前搜索请求，系统可以将新请求发送到具有相同 Segment 副本的空闲查询节点。

副本按副本组进行组织。每个副本组包含 shard 副本。每个 shard 副本都具有一个流式副本和一个历史副本，分别对应该 shard 中正在增长的和已封存的 Segment。

Shard 可视为多个节点之间进行分布式数据写入操作的 DML 通道，从而最大限度发挥 Zilliz Cloud 集群的并行计算能力。

异常：

• MilvusException

  当此操作期间发生任意错误时，将引发此异常。

示例

python

from pymilvus import Collection, CollectionSchema, FieldSchema, DataType

schema = CollectionSchema([
    FieldSchema("id", DataType.INT64, is_primary=True),
    FieldSchema("vector", DataType.FLOAT_VECTOR, dim=5)
])

# Create a collection
collection = Collection(
    name="test_collection",
    schema=schema
)

# Get the currently loaded replicas
collection.get_replicas()

相关操作

以下操作与 get_replicas() 相关：

• describe()

• drop()

• flush()

• set_properties()