用途:本技能用于通过 weaviate-cli 命令行工具操作与管理 Weaviate 向量数据库,覆盖集合、数据、租户、备份、导出、RBAC、集群与复制、别名、基准测试等日常运维任务。
安装与连接:使用 pip install weaviate-cli 或 brew install weaviate/tap/weaviate-cli 安装;用 weaviate-cli get nodes --minimal --json 验证连通性。默认读取 ~/.config/weaviate/config.json,可用 --config-file <path> 覆盖;本地集群默认连接 localhost:8080(HTTP)与 localhost:50051(gRPC),无需配置文件。需要认证时在 ~/.config/weaviate/ 下创建配置文件,支持 api_key 与 user(RBAC,需每条命令带 --user)两种类型;不要未经用户同意覆盖 config.json。
主要能力与用法:命令格式为 weaviate-cli [--config-file FILE] [--user USER] <group> <command> [--json] [options],建议始终加 --json 便于程序消费。命令组包括 create/get/update/delete/query/restore/cancel/assign/revoke/benchmark。可创建与管理 collection,支持复制因子、向量索引、向量器、多租户、对象 TTL 与异步复制配置;数据命令支持 fetch、vector、keyword、hybrid、uuid 检索,并可用 --collection 传入别名。租户状态含 hot/active、cold/inactive、frozen/offloaded,数据操作要求租户为 hot/active。支持备份与恢复(backend 可为 s3、gcs、filesystem)、集合导出(parquet)、RBAC 角色用户与权限管理、节点与分片查看、复制任务与别名管理、QPS 基准测试。
限制:创建用户需集群部署时启用 DYNAMIC_USERS=true;导出需集群已配置相应后端;权限含通配符时需加引号(如 -p 'crud_data:*');--consistency_level 须用小写(one/quorum/all);时间 TTL 中 create/update 类型最短 60 秒。其余细节请参考资料中对应参考文件,未在资料中说明的内容暂未提供。