用途:面向 AI 智能体与开发者的 Hologres 命令行界面,支持数据库操作、模式查看、SQL 执行与数据管理等。安装需 Python 3.11+:pip install hologres-cli,也可指定版本如 pip install hologres-cli==0.2.6。
配置:基于配置文件 ~/.hologres/config.json,可用 hologres config 交互式设置,或用 config set 直接设置 region_id、instance_id、database 等;配置优先级为 --profile 参数 > 当前 profile > 报错。连接模式由 connection_mode 决定,可选 direct(auto/jdbc,走实例 PostgreSQL 端点)或 api(走 OpenAPI ExecuteStatement,需实例启用且 RAM 具备 hologram:ExecuteStatement 权限)。认证模式支持 ram(AccessKey)、basic(Hologres 数据库账号,用户名需为 BASIC$ 前缀)与 sts(临时凭据,免密,适用于 ECS/容器)。
主要能力:hologres status 检查连接;schema/table 系列命令列出、描述、导出 DDL、查看大小与属性,并支持建表、改表、删表(默认 dry-run);sql run 执行只读或 --write 写入、explain 查看计划;data export/import/count 处理 CSV;partition、view、extension、guc、volume、model 等管理命令;V3.1+ 动态表 dt 提供创建、列表、DDL、血缘、存储、刷新、修改、删除与 V3.0→V3.1 转换;ai 子命令支持文本、图像、视频生成与编辑;输出支持 json(默认)、table、csv、jsonl。
安全特性:连接时自动设置安全 GUC;无 LIMIT 且返回超 100 行会报 LIMIT_REQUIRED(可用 --no-limit-check 关闭);写操作需 --write;危险写操作有拦截。
限制:资料未完整给出全部限制说明;部分功能依赖实例版本(如动态表 V3.1+)、需预先开启 ExecuteStatement 或授予相应权限;价格与平台支持范围暂未提供。