跳到主要内容
版本：v2.4.x

管理 Collection

本指南将指导您使用所选的 SDK 创建和管理 Collection。

开始之前​

概述​

在 Milvus 中，您可以将 Embedding 存储在 Collection 中。一个 Collection 中的所有 Embedding 都具有相同的维度和距离度量相似性。

Milvus Collection 支持动态字段（即 Schema 中未预定义的字）和主键的自动递增。

为了适应不同的偏好，Milvus 提供了两种创建 Collection 的方法。其中一种提供快速设置，其他则允许对 Collection 模式和索引参数进行详细定制。

此外，您还可以在必要时查看、加载、释放和删除 Collection。

创建 Collection​

您可以通过以下任一方式创建 Collection：

  • 快速设置

    在这种方式下，只需给 Collection 命名并指定要存储在此 Collection 中的 Embedding 的维数，即可创建 Collection。详情请参阅快速设置。

  • 自定义设置

    与让 In Milvus 为你的 Collection 决定几乎所有事情不同，你可以自己决定 Collection 的Schema和索引参数。详情请参阅自定义设置。

快速设置​

在人工智能行业大跃进的背景下，大多数开发人员只需要一个简单而又充满活力的 Collection 就可以开始使用了。Milvus 只需三个参数就能快速设置这样的 Collection：

  • 要创建的 Collection 名称、

  • 要插入的向量 Embedding 的维度，以及

  • 用于衡量 Embedding 之间相似性的度量类型。

为了快速设置，请使用 create_collection()方法 MilvusClient类的方法创建一个具有指定名称和维度的 Collection。

如需快速设置，请使用 createCollection()方法创建一个具有指定名称和维度的 Collection。 MilvusClientV2类的方法创建一个具有指定名称和维度的 Collection。

快速设置时，使用 createCollection()方法创建一个具有指定名称和维度的 Collection。 MilvusClient类的方法创建一个具有指定名称和维度的 Collection。

如需快速设置，请使用 CreateCollection()在Client 接口的实例上使用 NewClient()方法创建一个具有指定名称和维度的 Collection。

如需快速设置，可使用 POST /v2/vectordb/collections/createAPI 端点创建具有指定名称和维度的 Collection。

from pymilvus import MilvusClient, DataType

# 1. Set up a Milvus client
client = MilvusClient(
uri="http://localhost:19530"
)

# 2. Create a collection in quick setup mode
client.create_collection(
collection_name="quick_setup",
dimension=5
)

res = client.get_load_state(
collection_name="quick_setup"
)

print(res)

# Output
#
# {
# "state": "<LoadState: Loaded>"
# }

上述代码生成的 Collection 只包含两个字段：id （作为主键）和vector （作为向量字段），默认情况下启用auto_id 和enable_dynamic_field 设置。

  • auto_id

    启用该设置可确保主键自动递增。数据插入时无需手动提供主键。

  • enable_dynamic_field

    启用后，待插入数据中除id 和vector 以外的所有字段都会被视为动态字段。这些附加字段以键值对的形式保存在一个名为$meta 的特殊字段中。此功能允许在插入数据时包含额外字段。

从提供的代码中自动索引和加载的 Collection 可以立即插入数据。

自定义设置​

与其让 Milvus 为你的 Collection 决定几乎一切，你可以自己决定 Collection 的Schema和索引参数。

第一步：设置 Schema​

Schema 定义了 Collection 的结构。在 Schema 中，您可以选择启用或禁用enable_dynamic_field 、添加预定义字段以及为每个字段设置属性。有关概念和可用数据类型的详细解释，请参阅Schema Explained。

要设置模式，请使用 create_schema()创建模式对象，并使用 add_field()为模式添加字段。

要设置模式，使用 createSchema()创建模式对象，并使用 addField()为模式添加字段。

要设置模式，使用 createCollection().

要设置模式，可使用entity.NewSchema() 创建模式对象，并使用schema.WithField() 为模式添加字段。

要设置模式，您需要定义一个 JSON 对象，该对象应遵循模式格式，如 POST /v2/vectordb/collections/createAPI 端点参考页面上显示的模式格式定义一个 JSON 对象。

# 3. Create a collection in customized setup mode

# 3.1. Create schema
schema = MilvusClient.create_schema(
auto_id=False,
enable_dynamic_field=True,
)

# 3.2. Add fields to schema
schema.add_field(field_name="my_id", datatype=DataType.INT64, is_primary=True)
schema.add_field(field_name="my_vector", datatype=DataType.FLOAT_VECTOR, dim=5)
参数参数
auto_id确定主字段是否自动递增。
设置为True 时，主字段将自动递增。在这种情况下，主字段不应包含在要插入的数据中，以免出错。自动生成的 ID 有固定长度，不能更改。
enable_dynamic_field决定如果插入到目标 Collection 的数据包括未在 Collection 模式中定义的字段，Milvus 是否将未定义字段的值保存在动态字段中。
设置为 "true"时，Milvus 将创建一个名为**$meta**的字段，用于保存插入数据中的任何未定义字段及其值。
field_name字段的名称。
datatype字段的数据类型。有关可用数据类型的列表，请参阅数据类型。
is_primary当前字段是否为 Collection 中的主字段。
每个 Collection 只有一个主字段。主字段应为DataType.INT64类型或DataType.VARCHAR类型。
dim向量 Embedding 的维数。
对于DataType.FLOAT_VECTOR、DataType.BINARY _VECTOR、DataType .FLOAT16_VECTOR 或DataType.BFLOAT16_VECTOR类型的字段，这是必填项。如果使用DataType.SPARSE_FLOAT_VECTOR，请省略此参数。
参数说明
fieldName字段的名称。
dataType字段的数据类型。有关可用数据类型的列表，请参阅DataType。
isPrimaryKey当前字段是否为 Collection 中的主字段。
每个 Collection 只有一个主字段。主字段应为DataType.Int64类型或DataType.VarChar类型。
autoID是否允许主字段自动递增。
设置为true 时，主字段将自动递增。在这种情况下，主字段不应包含在要插入的数据中，以免出错。
dimension向量 Embedding 的维数。
对于DataType.FloatVector、DataType.BinaryVector、DataType .Float16Vector 或DataType.BFloat16Vector类型的字段，此项为必填项。
参数字段名称。
name字段的名称。
data_type字段的数据类型。有关所有可用数据类型的枚举，请参阅DataType。
is_primary_key当前字段是否为 Collection 中的主字段。
每个 Collection 只有一个主字段。主字段应为DataType.INT64类型或DataType.VARCHAR类型。
auto_id主字段是否会在数据插入此 Collection 时自动递增。
默认值为 "假"。设置为True 时，主字段将自动递增。如果需要使用自定义 Schema 设置 Collection，请跳过该参数。
dim保存 Embedding 的 Collection 字段的维度。
该值应为大于 1 的整数，通常由用于生成 Embedding 的模型决定。
参数描述
WithName()字段的名称。
WithDataType()字段的数据类型。
WithIsPrimaryKey()当前字段是否为 Collection 中的主字段。
每个 Collection 只有一个主字段。主字段应为entity.FieldTypeInt64类型或entity.FieldTypeVarChar类型。
WithIsAutoID()主字段是否会在数据插入此 Collection 时自动递增。
默认值为false。设置为true 时，主字段将自动递增。如果需要使用自定义 Schema 设置 Collection，请跳过该参数。
WithDim()保存 Embedding 的 Collection 字段的维度。
该值应为大于 1 的整数，通常由用于生成 Embedding 的模型决定。
参数描述
fieldName要在目标 Collection 中创建的字段名称。
dataType字段值的数据类型。
isPrimary当前字段是否为主字段。将其设置为True 后，当前字段就是主字段。
elementTypeParams额外字段参数。
dimFloatVector 或 BinaryVector 字段的可选参数，用于确定向量维度。

第二步：设置索引参数​

索引参数决定了 Milvus 如何在 Collection 中组织数据。您可以通过调整metric_type 和index_type 来定制特定字段的索引过程。对于向量字段，您可以根据所处理的向量类型，灵活选择COSINE,L2,IP,HAMMING 或JACCARD 作为metric_type 。更多信息，请参阅 "相似度指标"。

要设置索引参数，请使用 prepare_index_params()准备索引参数，并使用 add_index()来添加索引。

要设置索引参数，请使用IndexParam。

要设置索引参数，请使用 createIndex().

要设置索引参数，请使用 CreateIndex().

要设置索引参数，您需要定义一个 JSON 对象，该对象应遵循 POST /v2/vectordb/collections/createAPI 端点参考页面上显示的索引参数格式定义一个 JSON 对象。

# 3.3. Prepare index parameters
index_params = client.prepare_index_params()

# 3.4. Add indexes
index_params.add_index(
field_name="my_id",
index_type="STL_SORT"
)

index_params.add_index(
field_name="my_vector",
index_type="IVF_FLAT",
metric_type="IP",
params={ "nlist": 128 }
)
参数说明
field_name应用此对象的目标文件名称。
index_type用于在特定字段中排列数据的算法名称。有关适用算法，请参阅内存索引和磁盘索引。
metric_type用于衡量向量间相似性的算法。可能的值有IP、L2、COSINE、JACCARD、HAMMING。只有指定字段为向量字段时才可用。更多信息，请参阅Milvus 支持的索引。
params指定索引类型的微调参数。有关可能的键和值范围的详细信息，请参阅内存索引。
参数说明
fieldName应用此 IndexParam 对象的目标字段的名称。
indexType用于在特定字段中排列数据的算法名称。有关适用算法，请参阅内存索引和磁盘索引。
metricType索引使用的距离度量。可能的值有IP、L2、COSINE、JACCARD、HAMMING。
extraParams额外的索引参数。有关详情，请参阅内存索引和磁盘索引。
参数说明
field_name要创建索引的目标字段的名称。
index_type用于在特定字段中排列数据的算法名称。有关适用算法，请参阅内存索引和磁盘索引。
metric_type用于衡量向量间相似性的算法。可能的值有IP、L2、COSINE、JACCARD、HAMMING。只有指定字段为向量字段时才可用。更多信息，请参阅Milvus 支持的索引。
params指定索引类型的微调参数。有关可能的键和值范围的详细信息，请参阅内存索引。
参数说明
index_type用于在特定字段中排列数据的算法名称。有关适用算法，请参阅内存索引和磁盘索引。
metric_type用于衡量向量间相似性的算法。可能的值有IP、L2、COSINE、JACCARD、HAMMING。只有指定字段为向量字段时才可用。更多信息，请参阅Milvus 支持的索引。
nlist簇单位数。簇单位用于 Milvus 中基于 IVF（反转文件）的索引。对于 IVF_FLAT，索引将向量数据划分为 "nlist "簇单位，然后比较目标输入向量与每个簇中心之间的距离 1。必须介于 1 和 65536 之间。
参数说明
fieldName要创建索引的目标字段的名称。
indexName要创建的索引的名称。默认值为目标字段名称。
metricType用于衡量向量间相似性的算法。可能的值有IP、L2、COSINE、JACCARD、HAMMING。只有当指定字段是向量字段时才可用。更多信息，请参阅Milvus 支持的索引。
params索引类型和相关设置。详情请参阅内存索引。
params.index_type要创建的索引类型。
params.nlist群集单元数。这适用于与 IVF 相关的索引类型。

上面的代码片段演示了如何分别为向量字段和标量字段设置索引参数。对于向量字段，同时设置度量类型和索引类型。对于标量字段，只需设置索引类型。建议为向量字段和任何经常用于筛选的标量字段创建索引。

第 3 步：创建 Collection​

你可以选择分别创建 Collection 和索引文件，或者在创建 Collection 时同时加载索引。

使用create_collection()以指定的 Schema 和索引参数创建 Collection，并使用get_load_state()检查 Collection 的加载状态。

使用createCollection()以指定的 Schema 和索引参数创建 Collection，并使用getLoadState()检查 Collection 的加载状态。

使用createCollection()以指定的 Schema 和索引参数创建 Collection，并使用getLoadState()检查 Collection 的加载状态。

  • 创建 Collection 时同时加载索引。

    # 3.5. Create a collection with the index loaded simultaneously
    client.create_collection(
        collection_name="customized_setup_1",
        schema=schema,
        index_params=index_params
    )

    time.sleep(5)

    res = client.get_load_state(
    collection_name="customized_setup_1"
    )

    print(res)

    # Output
    #
    # {
    # "state": "<LoadState: Loaded>"
    # }

    上面创建的 Collection 会自动加载。要了解加载和释放 Collection 的更多信息，请参阅加载和释放 Collection。

  • 分别创建 Collection 和索引文件。

    # 3.6. Create a collection and index it separately
    client.create_collection(
        collection_name="customized_setup_2",
        schema=schema,
    )

    res = client.get_load_state(
    collection_name="customized_setup_2"
    )

    print(res)

    # Output
    #
    # {
    # "state": "<LoadState: NotLoad>"
    # }

    上面创建的 Collection 不会自动加载。您可以按如下方式为 Collection 创建索引。以单独的方式为 Collection 创建索引不会自动加载 Collection。有关详细信息，请参阅加载和释放 Collection。

    参数说明
    collection_nameCollection 的名称。
    schema此 Collection 的 Schema。
    设置为 "**无 "**表示将使用默认设置创建此 Collection。
    要使用自定义Schema设置 Collection，需要创建一个CollectionSchema对象并在此处引用它。在这种情况下，Milvus 会忽略请求中携带的所有其他 Schema 相关设置。
    index_params在此 Collection 中建立向量字段索引的参数。要使用自定义 Schema 设置 Collection 并自动将 Collection 加载到内存中，需要创建一个 IndexParams 对象并在此处引用。
    至少应为此 Collection 中的向量字段添加一个索引。如果希望稍后再设置索引参数，也可以跳过此参数。
    参数说明
    collectionNameCollection 的名称。
    collectionSchema此 Collection 的 Schema。
    留空表示将以默认设置创建此 Collection。要使用自定义模式设置 Collection，需要创建一个CollectionSchema对象并在此处引用。
    indexParams在此 Collection 中建立向量字段索引的参数。要使用自定义 Schema 设置 Collection 并自动将 Collection 加载到内存中，需要创建一个包含 IndexParam 对象列表的IndexParams对象，并在此处引用该对象。
    参数说明
    collection_nameCollection 的名称。
    fieldsCollection 中的字段。
    index_params要创建的 Collection 的索引参数。
    参数说明
    schema.CollectionNameCollection 的名称。
    schemaCollection 的 Schema。
    index_params要创建的 Collection 的索引参数。
    参数说明
    collectionNameCollection 的名称。
    schemaSchema 负责组织目标 Collection 中的数据。一个有效的 Schema 应该有多个字段，其中必须包括一个主键、一个向量字段和几个标量字段。
    schema.autoID是否允许主字段自动递增。设置为 True 时，主字段将自动递增。在这种情况下，主字段不应包含在要插入的数据中，以免出错。在 is_primary 设置为 True 的字段中设置此参数。
    schema.enableDynamicField是否允许使用保留的 $meta 字段来保存键值对中的非 Schema 定义字段。
    fields字段对象列表。
    fields.fieldName要在目标 Collection 中创建的字段名称。
    fields.dataType字段值的数据类型。
    fields.isPrimary当前字段是否为主字段。将此设置为 True 时，当前字段就是主字段。
    fields.elementTypeParams额外字段参数。
    fields.elementTypeParams.dimFloatVector 或 BinaryVector 字段的可选参数，用于确定向量维度。

    上面创建的 Collection 不会自动加载。你可以按以下方法为 Collection 创建索引。以单独方式为 Collection 创建索引不会自动加载 Collection。有关详细信息，请参阅加载和释放 Collection。

    # 3.6 Create index
    client.create_index(
        collection_name="customized_setup_2",
        index_params=index_params
    )

    res = client.get_load_state(
    collection_name="customized_setup_2"
    )

    print(res)

    # Output
    #
    # {
    # "state": "<LoadState: NotLoad>"
    # }
    参数说明
    collection_nameCollection 的名称。
    index_paramsIndexParams对象，包含一个IndexParam对象列表。
参数说明
collectionNameCollection 名称。
indexParamsIndexParam对象列表。
参数说明
collection_nameCollection 的名称。
field_name要创建索引的字段名称。
index_type用于在特定字段中排列数据的算法名称。有关适用算法，请参阅内存索引和磁盘索引。
metric_type用于衡量向量间相似性的算法。可能的值有IP、L2、COSINE、JACCARD、HAMMING。只有指定字段为向量字段时才可用。更多信息，请参阅Milvus 支持的索引。
params指定索引类型的微调参数。有关可能的键和值范围的详细信息，请参阅内存索引。
参数说明
collNameCollection 的名称。
fieldName要创建索引的字段名称。
idx用于在特定字段中排列数据的算法名称。有关适用算法，请参阅内存索引和磁盘索引。
async此操作是否异步。
opts指定索引类型的微调参数。可以在此请求中包含多个 `entity.IndexOption`。有关可能的键和值范围的详细信息，请参阅内存索引。
参数Collection 名称。
collectionNameCollection 的名称。
indexParams要创建的 Collection 的索引参数。
indexParams.metricType用于建立索引的相似度度量类型。默认值为 COSINE。
indexParams.fieldName要创建索引的目标字段的名称。
indexParams.indexName要创建的索引的名称，默认值为目标字段名称。
indexParams.indexConfig.index_type要创建的索引类型。
indexParams.indexConfig.nlist群集单元数。这适用于与 IVF 相关的索引类型。

查看 Collection​

要查看现有 Collection 的详细信息，请使用describe_collection()。

要查看现有 Collection 的详细信息，请使用describeCollection()。

要查看现有 Collection 的详细信息，请使用describeCollection()。

要查看现有 Collection 的详细信息，请使用DescribeCollection()。

要查看 Collection 的定义，可以使用 POST /v2/vectordb/collections/describe和 POST /v2/vectordb/collections/listAPI 端点查看 Collection 的定义。

# 5. View Collections
res = client.describe_collection(
    collection_name="customized_setup_2"
)

print(res)

# Output
#
# {
# "collection_name": "customized_setup_2",
# "auto_id": false,
# "num_shards": 1,
# "description": "",
# "fields": [
# {
# "field_id": 100,
# "name": "my_id",
# "description": "",
# "type": 5,
# "params": {},
# "element_type": 0,
# "is_primary": true
# },
# {
# "field_id": 101,
# "name": "my_vector",
# "description": "",
# "type": 101,
# "params": {
# "dim": 5
# },
# "element_type": 0
# }
# ],
# "aliases": [],
# "collection_id": 448143479230158446,
# "consistency_level": 2,
# "properties": {},
# "num_partitions": 1,
# "enable_dynamic_field": true
# }

要列出所有现有的 Collection，可以按以下方式操作：

# 6. List all collection names
res = client.list_collections()

print(res)

# Output
#
# [
# "customized_setup_2",
# "quick_setup",
# "customized_setup_1"
# ]

加载和释放 Collection​

在加载 Collection 的过程中，Milvus 会将 Collection 的索引文件加载到内存中。相反，在释放 Collection 时，Milvus 会从内存中卸载索引文件。在某个 Collection 中进行搜索之前，请确保该 Collection 已加载。

加载 Collection​

要加载一个 Collection，请使用 load_collection()方法，指定 Collection 名称。还可以设置replica_number ，以确定加载 Collection 时在查询节点上创建多少个数据段内存副本。

  • Milvus Standalone：replica_number 的最大允许值为 1。
  • Milvus 群集：最大值不应超过 Milvus 配置中设置的queryNode.replicas 。有关其他详细信息，请参阅查询节点相关配置。

要加载一个 Collection，请使用 loadCollection()方法，指定 Collection 名称。

要加载 Collection，请使用 loadCollection()方法，指定 Collection 名称。

要加载 Collection，请使用 LoadCollection()方法，指定 Collection 名称。

要加载 Collection，可以使用 POST /v2/vectordb/collections/load和 POST /v2/vectordb/collections/get_load_stateAPI 端点。

# 7. Load the collection
client.load_collection(
    collection_name="customized_setup_2",
    replica_number=1 # Number of replicas to create on query nodes. Max value is 1 for Milvus Standalone, and no greater than `queryNode.replicas` for Milvus Cluster.
)

res = client.get_load_state(
collection_name="customized_setup_2"
)

print(res)

# Output
#
# {
# "state": "<LoadState: Loaded>"
# }

部分加载 Collection（公开预览版）​

说明

此功能目前处于公开预览阶段。API 和功能将来可能会更改。

收到加载请求后，Milvus 会将所有向量字段索引和所有标量字段数据加载到内存中。如果某些字段不参与搜索和查询，您可以将其排除在加载之外，以减少内存使用，提高搜索性能。

# 7. Load the collection
client.load_collection(
    collection_name="customized_setup_2",
    load_fields=["my_id", "my_vector"], # Load only the specified fields
    skip_load_dynamic_field=True # Skip loading the dynamic field
)

res = client.get_load_state(
collection_name="customized_setup_2"
)

print(res)

# Output
#
# {
# "state": "<LoadState: Loaded>"
# }

请注意，只有load_fields 中列出的字段才能用作搜索和查询的筛选条件和输出字段。在列表中应始终包含主键。不加载的字段名将不能用于筛选或输出。

可以使用skip_load_dynamic_field=True 跳过加载动态字段。Milvus 将动态字段视为单个字段，因此动态字段中的所有键将一起被包含或排除。

释放 Collection​

要释放一个 Collection，请使用 release_collection()方法，并指定 Collection 名称。

要释放 Collection，请使用 releaseCollection()方法，指定 Collection 名称。

要释放一个 Collection，请使用 releaseCollection()方法，指定 Collection 名称。

要释放 Collection，请使用 ReleaseCollection()方法，指定 Collection 名称。

要释放一个 Collection，可以使用 POST /v2/vectordb/collections/release和 POST /v2/vectordb/collections/get_load_stateAPI 端点。

# 8. Release the collection
client.release_collection(
    collection_name="customized_setup_2"
)

res = client.get_load_state(
collection_name="customized_setup_2"
)

print(res)

# Output
#
# {
# "state": "<LoadState: NotLoad>"
# }

设置别名​

您可以为 Collection 指定别名，使它们在特定上下文中更有意义。您可以为一个 Collection 指定多个别名，但多个 Collection 不能共享一个别名。

创建别名​

要创建别名，请使用 create_alias()方法，指定 Collection 名称和别名。

要创建别名，请使用 createAlias()方法，指定 Collection 名称和别名。

要创建别名，请使用 createAlias()方法，指定 Collection 名称和别名。

要为 Collection 创建别名，可以使用 POST /v2/vectordb/aliases/createAPI 端点。

# 9.1. Create aliases
client.create_alias(
    collection_name="customized_setup_2",
    alias="bob"
)

client.create_alias(
collection_name="customized_setup_2",
alias="alice"
)
参数说明
collection_name要创建别名的 Collection 名称。
aliasCollection 的别名。操作前，请确保别名不存在。如果已经存在，则会出现异常。
参数参数
collectionName要创建别名的 Collection 的名称。
aliasCollection 的别名。在进行此操作前，请确保别名不存在。如果已经存在，则会出现异常。
参数参数
collection_name要创建别名的 Collection 的名称。
aliasCollection 的别名。在进行此操作前，请确保别名不存在。如果已经存在，则会出现异常。
参数参数
collectionName要创建别名的 Collection 的名称。
aliasNameCollection 的别名。在进行此操作前，请确保别名不存在。如果已经存在，则会出现异常。

列出别名​

要列出别名，请使用 list_aliases()方法，并指定 Collection 名称。

要列出别名，请使用 listAliases()方法，并指定 Collection 名称。

要列出别名，请使用 listAliases()方法，并指定 Collection 名称。

要列出某个 Collection 的别名，可使用 POST /v2/vectordb/aliases/listAPI 端点。

# 9.2. List aliases
res = client.list_aliases(
    collection_name="customized_setup_2"
)

print(res)

# Output
#
# {
# "aliases": [
# "bob",
# "alice"
# ],
# "collection_name": "customized_setup_2",
# "db_name": "default"
# }

描述别名​

要描述别名，请使用 describe_alias()方法指定别名。

要描述别名，请使用 describeAlias()方法指定别名。

要描述别名，请使用 describeAlias()方法指定别名。

要描述 Collection 的别名，可以使用 POST /v2/vectordb/aliases/describeAPI 端点。

# 9.3. Describe aliases
res = client.describe_alias(
    alias="bob"
)

print(res)

# Output
#
# {
# "alias": "bob",
# "collection_name": "customized_setup_2",
# "db_name": "default"
# }

重新指定别名​

要将别名重新分配给其他 Collection，请使用 alter_alias()方法，指定 Collection 名称和别名。

要将别名重新指定给其他 Collection，请使用 alterAlias()方法，指定 Collection 名称和别名。

要将别名重新分配给其他 Collection，请使用 alterAlias()方法，指定 Collection 名称和别名。

要将别名重新指定给其他 Collection，可使用 POST /v2/vectordb/aliases/alterAPI 端点。

# 9.4 Reassign aliases to other collections
client.alter_alias(
    collection_name="customized_setup_1",
    alias="alice"
)

res = client.list_aliases(
collection_name="customized_setup_1"
)

print(res)

# Output
#
# {
# "aliases": [
# "alice"
# ],
# "collection_name": "customized_setup_1",
# "db_name": "default"
# }

res = client.list_aliases(
collection_name="customized_setup_2"
)

print(res)

# Output
#
# {
# "aliases": [
# "bob"
# ],
# "collection_name": "customized_setup_2",
# "db_name": "default"
# }

删除别名​

要删除别名，请使用 drop_alias()方法指定别名。

要删除别名，请使用 dropAlias()方法，指定别名。

要删除别名，请使用 dropAlias()方法，指定别名。

要为 Collection 删除别名，可使用 POST /v2/vectordb/aliases/dropAPI 端点。

# 9.5 Drop aliases
client.drop_alias(
    alias="bob"
)

client.drop_alias(
alias="alice"
)
$ curl -X POST "http://${MILVUS_URI}/v2/vectordb/aliases/drop" \
-H "Content-Type: application/json" \
-d '{
    "aliasName": "bob"
}'

# {
#     "code": 0,
#     "data": {}
# }

$ curl -X POST "http://${MILVUS_URI}/v2/vectordb/aliases/drop" \
-H "Content-Type: application/json" \
-d '{
    "aliasName": "alice"
}'

# {
#     "code": 0,
#     "data": {}
# }

设置属性​

可以为 Collection 设置属性，如ttl.seconds 和mmap.enabled 。更多信息，请参阅set_properties()。

说明

本节中的代码片段使用PyMilvus ORM 模块与 Milvus 进行交互。使用新的MilvusClient SDK的代码片段即将发布。

设置 TTL​

为 Collection 中的数据设置生存时间（TTL），指定数据在自动删除前应保留多长时间。

from pymilvus import Collection, connections

# Connect to Milvus server
connections.connect(host="localhost", port="19530") # Change to your Milvus server IP and port

# Get existing collection
collection = Collection("quick_setup")

# Set the TTL for the data in the collection
collection.set_properties(
properties={
"collection.ttl.seconds": 60
}
)

设置 MMAP​

为 Collection 配置内存映射 (MMAP) 属性，该属性决定数据是否映射到内存中以提高查询性能。有关详细信息，请参阅配置内存映射 。

说明

在设置 MMAP 属性之前，请先释放 Collection。否则会出错。

from pymilvus import Collection, connections

# Connect to Milvus server
connections.connect(host="localhost", port="19530") # Change to your Milvus server IP and port

# Get existing collection
collection = Collection("quick_setup")

# Before setting memory mapping property, we need to release the collection first.
collection.release()

# Set memory mapping property to True or Flase
collection.set_properties(
properties={
"mmap.enabled": True
}
)

删除 Collection​

如果不再需要某个 Collection，您可以放弃该 Collection。

要删除一个 Collection，请使用 drop_collection()方法，并指定 Collection 名称。

要删除一个 Collection，请使用 dropCollection()方法，指定 Collection 名称。

要放弃一个 Collection，请使用 dropCollection()方法，指定 Collection 名称。

要删除 Collection，请使用 DropCollection()方法，指定 Collection 名称。

要删除一个 Collection，可以使用 POST /v2/vectordb/collections/dropAPI 端点。

# 10. Drop the collections
client.drop_collection(
    collection_name="quick_setup"
)

client.drop_collection(
collection_name="customized_setup_1"
)

client.drop_collection(
collection_name="customized_setup_2"
)