You need to enable JavaScript to run this app.
导航
GetCollectionInfo
最近更新时间:2024.06.14 11:34:51首次发布时间:2024.06.14 11:34:51

概述

GetCollectionInfo 用于查询指定数据集 Collection 的详情信息。

请求参数

字段名

类型

是否必传

说明

CollectionName/CollectionAlias

string

数据集名称/数据集别名,二者选其一

响应参数
declare class ListCollectionsResponse {
  readonly CollectionInfo: CollectionInfo;
  readonly OriginalRequest: string;
  readonly LogId: string;
  constructor(
    CollectionInfo: CollectionInfo,
    OriginalRequest: string,
    LogId: string
  );
}

CollectionInfo

字段名

类型

是否必传

说明

CollectionName

string

数据集名称

Description

string

数据集描述

CollectionAliases

string[]

数据集别名列表

Fields

FieldInfo[]

数据集字段

Stat

Stat

数据集状态

IndexNames

string[]

数据集下索引名称列表

IndexNumber

number

数据集下索引数量

CreateTime

string

数据集创建时间

UpdateTime

string

数据集更新时间

UpdatePerson

string

数据集更新人

FieldInfo

type FieldInfo =
  | ScalarFieldInfo
  | PrimaryKeyFieldInfo
  | DenseVectorFieldInfo
  | SparseVectorFieldInfo
  | TextFieldInfo
  
enum FieldType {
  Int64 = "int64",
  Float32 = "float32",
  String = "string",
  Boolean = "bool",
  ListString = "list<string>",
  ListInt64 = "list<int64>",
  /** 稠密向量 */
  DenseVector = "vector",
  /** 稀疏向量 */
  SparseVector = "sparse_vector",
  Text = "text",
}

type PipelineName =
  | "text_split_bge_large_zh"
  | "text_bge_large_zh"
  | "text_split_bge_m3"
  | "text_bge_m3"
  | "text_split_bge_large_and_m3"
  | "text_bge_large_and_m3"

ScalarFieldInfo 标量字段

字段名

类型

是否必传

说明

FieldName

string

字段名

FieldType

FieldType.Int64
FieldType.Float32
FieldType.String
FieldType.Boolean
FieldType.ListString
FieldType.ListInt64

字段类型

DefaultValue

number
string
boolean
string[]
number[]

字段默认值,类型需要与传入的 FieldType 对齐

PrimaryKeyFieldInfo 主键字段

字段名

类型

是否必传

说明

FieldName

string

字段名

FieldType

FieldType.Int64
FieldType.String

字段类型

IsPrimary

true

是否主键字段,只允许传 true

DenseVectorFieldInfo 稠密向量字段

字段名

类型

是否必传

说明

FieldName

string

字段名

FieldType

FieldType.DenseVector

字段类型

Dim

number

向量维度,需要 4 的倍数

SparseVectorFieldInfo 稀疏向量字段

字段名

类型

是否必传

说明

FieldName

string

字段名

FieldType

FieldType.SparseVector

字段类型

TextFieldInfo 文本字段

字段名

类型

是否必传

说明

FieldName

string

字段名

FieldType

FieldType.Text

字段类型

PipelineName

string

绑定的 pipeline_name

Stat

字段名

类型

是否必传

说明

DataNumber

number

数据量

参考示例
import { vikingdb } from '@volcengine/openapi'

declare const service: vikingdb.VikingdbService // 替换为你初始化好的实例

const response = await service.collection.GetCollectionInfo({
  CollectionName: 'test_collection_1',
})

console.log(response.CollectionInfo) // 数据集详情信息