嬴图CLI（ultipa_cli）是一款跨平台（Windows/Mac/Linux）命令行界面工具，专为嬴图数据库设计，用来执行GQL和UQL查询语句。
准备工作
- 命令行工具：
- Linux或MacOS：Bash，Zsh，TCSH
- Windows：PowerShell
- 点击此处下载嬴图CLI。无需安装。
使用指南
以下步骤均在Window系统上PowerShell中演示。
1. 打开终端工具
打开终端程序，导航至ultipa_cli所在文件夹。
2. 连接嬴图数据库
运行ultipa_cli，连接到嬴图数据库。
./ultipa_cli.exe -h <host_addr> -u <username> -p <password>
在与嬴图数据库建立连接时，ultipa_cli支持使用以下标志：
标志 |
参数 | 可选 |
|---|---|---|
-h, --host |
数据库主机地址，以URL（不包括https://或http://）或IP:Port形式提供；若连接至一个集群，需提供由英文逗号分隔的IP:Port对 |
否 |
-u, --username |
数据库用户名（用于主机身份验证） | 否 |
-p, --password |
用户登录密码 | 否 |
-g, --graph |
待设定为当前工作图集的图集；默认为default |
是 |
-qt, --queryType |
查询类型：uql（默认）或gql |
是 |
-crt, --crt |
用于加密传输的本地TSL文件路径 | 是 |
-d, --debug |
布尔型标志，用于启用调试模式 | 是 |
-t, --timeout |
请求超时阈值（单位：秒） | 是 |
3. 指定工作图集
使用use命令指定当前工作图集。以图集alimama为例。
use alimama
4. 执行查询
ultipa_cli支持UQL模式和GQL模式。默认使用UQL模式。
UQL查询
执行UQL查询：
find().nodes({@nodx.cateID == "1089685"}) as n return n{*} limit 5
UQL和GQL模式切换
可使用uql和gql命令切换至UQL模式或GQL模式。
gql
GQL查询
执行GQL查询：
MATCH (n:nodx {cateID: "1089685"}) RETURN n LIMIT 5
版本检查
使用-version或--version标志检查ultipa_cli的版本。
UQL执行历史
首次成功连接至嬴图数据库后，系统会在ultipa_cli所在目录下自动生成.ultipa_cli_history文件，用于记录ultipa_cli中执行的所有命令。只要该文件存在，新执行的命令都将增加至文件末尾，方便用户追踪执行的历史命令，用于后续参考和再次执行。