Ver coleções

Pode obter a lista de nomes de todas as coleções na base de dados atualmente ligada e consultar os detalhes de uma coleção específica.

Listar coleções

O exemplo seguinte demonstra como obter a lista de nomes de todas as coleções na base de dados atualmente ligada.

from pymilvus import MilvusClient, DataType

client = MilvusClient(
    uri="http://localhost:19530",
    token="root:Milvus"
)

res = client.list_collections()

print(res)
import io.milvus.v2.client.ConnectConfig;
import io.milvus.v2.client.MilvusClientV2;
import io.milvus.v2.service.collection.response.ListCollectionsResp;

ConnectConfig connectConfig = ConnectConfig.builder()
        .uri("http://localhost:19530")
        .token("root:Milvus")
        .build();

MilvusClientV2 client = new MilvusClientV2(connectConfig);

ListCollectionsResp resp = client.listCollections();
System.out.println(resp.getCollectionNames());
import (
    "context"
    "fmt"

    "github.com/milvus-io/milvus/client/v3/milvusclient"
)

ctx, cancel := context.WithCancel(context.Background())
defer cancel()

milvusAddr := "http://localhost:19530"
token := "root:Milvus"
client, err := milvusclient.New(ctx, &milvusclient.ClientConfig{
    Address: milvusAddr,
    APIKey:  token,
})
if err != nil {
    fmt.Println(err.Error())
    // handle err
}
defer client.Close(ctx)

collectionNames, err := client.ListCollections(ctx, milvusclient.NewListCollectionOption())
if err != nil {
    fmt.Println(err.Error())
    // handle error
}

fmt.Println(collectionNames)
use milvus::v2::prelude::*;

let client = ClientV2::new(
    &ConnectConfig::new()
        .uri("http://localhost:19530")
        .token("root:Milvus"),
)
.await?;

let collections = client
    .list_collections(ListCollectionsRequest::builder().build()?)
    .await?;
println!("{:?}", collections.collection_names());
#include <iostream>
#include "milvus/MilvusClientV2.h"

auto client = milvus::MilvusClientV2::Create();

milvus::ConnectParam connect_param{"http://localhost:19530", "root:Milvus"};
auto status = client->Connect(connect_param);
if (!status.IsOk()) {
    std::cout << status.Message() << std::endl;
}

milvus::ListCollectionsResponse response;
status = client->ListCollections(milvus::ListCollectionsRequest(), response);
if (!status.IsOk()) {
    std::cout << status.Message() << std::endl;
}

for (auto& name : response.CollectionNames()) {
    std::cout << "\t" << name << std::endl;
}
import { MilvusClient } from '@zilliz/milvus2-sdk-node';

const client = new MilvusClient({
    address: 'http://localhost:19530',
    token: 'root:Milvus'
});

const collections = await client.listCollections();
console.log(collections);
using Milvus.Client.V2;
using Milvus.Client.V2.Requests.Collection;
using Milvus.Client.V2.Types;

using var client = new MilvusClientV2(new ConnectConfig
{
    Uri = "http://localhost:19530",
    ApiKey = "root:Milvus"
});
await client.ConnectAsync();

var res = await client.ListCollectionsAsync(new ListCollectionsReq());
foreach (var name in res.CollectionNames)
{
    Console.WriteLine(name);
}
export CLUSTER_ENDPOINT="http://localhost:19530"
export TOKEN="root:Milvus"

curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/collections/list" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
--header "Request-Timeout: 10" \
-d '{}'

Se já tiver criado uma coleção com o nome quick_setup, o resultado do exemplo acima deverá ser semelhante ao seguinte.

["quick_setup"]

list_collections() Devolve os nomes de todas as coleções na base de dados atualmente ligada e não se destina a verificações de existência. Para verificar se uma coleção específica existe, utilize has_collection() em vez disso (por exemplo, client.has_collection("quick_setup") devolve um valor booleano), ou o seu equivalente noutros SDKs.

Descrever uma coleção

Também é possível obter os detalhes de uma coleção específica. O exemplo seguinte pressupõe que já criou uma coleção chamada quick_setup.

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

print(res)
import io.milvus.v2.service.collection.request.DescribeCollectionReq;
import io.milvus.v2.service.collection.response.DescribeCollectionResp;

DescribeCollectionReq request = DescribeCollectionReq.builder()
        .collectionName("quick_setup")
        .build();
DescribeCollectionResp resp = client.describeCollection(request);
System.out.println(resp);
collection, err := client.DescribeCollection(ctx, milvusclient.NewDescribeCollectionOption("quick_setup"))
if err != nil {
    fmt.Println(err.Error())
    // handle err
}

fmt.Println(collection)
use milvus::v2::prelude::*;

let description = client
    .describe_collection(
        DescribeCollectionRequest::builder()
            .collection_name("quick_setup")
            .build()?,
    )
    .await?;

println!("{:?}", description.description());
#include <iostream>

milvus::DescribeCollectionResponse response;
auto status = client->DescribeCollection(milvus::DescribeCollectionRequest()
                                            .WithCollectionName("quick_setup"),
                                         response);
if (!status.IsOk()) {
    std::cout << status.Message() << std::endl;
}

std::cout << "Collection name: " << response.Desc().CollectionName() << std::endl;
std::cout << "Collection ID: " << response.Desc().ID() << std::endl;
const res = await client.describeCollection({
    collection_name: "quick_setup"
});

console.log(res);
using Milvus.Client.V2.Requests.Collection;

var res = await client.DescribeCollectionAsync(new DescribeCollectionReq
{
    CollectionName = "quick_setup"
});
Console.WriteLine(res.CollectionName);
export CLUSTER_ENDPOINT="http://localhost:19530"
export TOKEN="root:Milvus"

curl --request POST \
--url "${CLUSTER_ENDPOINT}/v2/vectordb/collections/describe" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
--header "Request-Timeout: 10" \
-d '{
    "collectionName": "quick_setup"
}'

O resultado do exemplo acima deverá ser semelhante ao seguinte.

{
    'collection_name': 'quick_setup', 
    'auto_id': False, 
    'num_shards': 1, 
    'description': '', 
    'fields': [
        {
            'field_id': 100, 
            'name': 'id', 
            'description': '', 
            'type': <DataType.INT64: 5>, 
            'params': {}, 
            'is_primary': True
        }, 
        {
            'field_id': 101, 
            'name': 'vector', 
            'description': '', 
            'type': <DataType.FLOAT_VECTOR: 101>, 
            'params': {'dim': 768}
        }
    ], 
    'functions': [], 
    'aliases': [], 
    'collection_id': 456909630285026300, 
    'consistency_level': 2, 
    'properties': {}, 
    'num_partitions': 1, 
    'enable_dynamic_field': True
}

Traduzido porDeepL

Experimente o Milvus gerenciado gratuitamente

O Zilliz Cloud é descomplicado, powered by Milvus e 10x mais rápido.

Começar
Feedback

Esta página foi útil?