接口定义
RPCVectorDBClient() 用于通过 RPC(Remote Procedure Call,远程过程调用)的请求方式创建一个向量数据库的客户端对象。
VectorDBClient() 为了兼容旧版本而保留,用于通过 HTTP I/O 请求方式创建一个向量数据库的客户端对象。
说明:
Python SDK 为 1.3.3 及以上版本支持 RPC(Remote Procedure Call,远程过程调用)通信,在多线程场景,RPC 可以提供比 HTTP I/O 更好的的并发请求能力。同时,为了确保兼容性和性能,Python SDK 需要在 Python 3.8或更高版本的环境下运行。
class RPCVectorDBClient( url: Any | None = None, username: str = '', key: str = '', read_consistency: ReadConsistency = ReadConsistency.EVENTUAL_CONSISTENCY, timeout: int = 10, adapter: HTTPAdapter = None, pool_size: int = 10 )
class VectorDBClient( url: Any | None = None, username: str = '', key: str = '', read_consistency: ReadConsistency = ReadConsistency.EVENTUAL_CONSISTENCY, timeout: int = 10, adapter: HTTPAdapter = None, pool_size: int = 10 )
使用示例
import tcvectordbfrom tcvectordb.model.enum import ReadConsistencyclient = tcvectordb.RPCVectorDBClient( url='http://10.0.X.X:80', username='root', key='eC4bLRy2va******************************', read_consistency=ReadConsistency.EVENTUAL_CONSISTENCY, timeout=30)
import tcvectordbfrom tcvectordb.model.enum import ReadConsistencyclient = tcvectordb.VectorDBClient(url='http://10.0.X.X:80',username='root',key='eC4bLRy2va******************************',read_consistency=ReadConsistency.EVENTUAL_CONSISTENCY, timeout=30)
入参描述
参数名 | 参数含义 | 是否必选 | 获取方式 |
url | 客户端所需连接的向量数据库服务端访问地址。 | 是 | |
username | 客户端访问向量数据库服务端的账号。 | 是 | 数据库当前仅支持 root 账号。 |
key | 客户端访问向量数据库服务端的 API 密钥,用于进行身份认证。 | 是 | |
read_consistency | 设置读一致性。 | 否 | 取值如下所示,默认为 EVENTUAL_CONSISTENCY。 ReadConsistency.STRONG_CONSISTENCY:强一致性。 ReadConsistency.EVENTUAL_CONSISTENCY:最终一致性。 |
timeout | 请求超时时间。 | 是 | 单位:秒。 默认值:10。 取值范围:大于等于0。若 timeout 设置为小于0或为 Null,系统会自动赋值为默认值。 |