has_collection()

此操作用于检查特定 Collection 是否存在。

Notes

此方法适用于 Dedicated serving 集群和按需计算。

• 对于 serving 集群中的 Collection，请使用集群 Endpoint 创建 MilvusClient。

  • Free & Serverless

    https://{cluster-id}.serverless.{region}.vectordb.zillizcloud.com

  • Dedicated

    https://{cluster-id}.{region}.vectordb.zillizcloud.com:19530

• 对于按需计算中的 Collection，请使用项目 Endpoint 创建 MilvusClient。

  https://{project-id}.{region}.api.zillizcloud.com

请求语法

python

has_collection(
    collection_name: str,
    timeout: Optional[float] = None
) -> Bool

参数：

• collection_name (str) -

  [必需]

  Collection 的名称。

• timeout (float | None) -

  此操作的超时时长。

  将其设置为 None 表示当返回任意响应或发生错误时，此操作超时。

返回类型：

bool

返回：

一个布尔值，用于指示指定的 Collection 是否存在。

异常：

• MilvusException

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

示例

python

from pymilvus import MilvusClient

# 1. Set up a milvus client
client = MilvusClient(
    uri="https://inxx-xxxxxxxxxxxx.api.gcp-us-west1.zillizcloud.com:19530",
    token="user:password"
)

# 2. Create a collection
client.create_collection(collection_name="test_collection", dimension=5)

# 3. Check whether a collection named `test_collection` exists
client.has_collection(collection_name="test_collection") 

# True

# 4. Check whether a collection named `test_collection_2` exists
client.has_collection(collection_name="test_collection_2") 

# False