什么是 ngql¶
ngql 是连接悦数图数据库开发版 Graph 服务的命令行工具，支持执行 GQL 语句和脚本、加载内置示例数据，以及调整查询结果的显示格式。
特性¶
- 交互模式和非交互模式：在提示符下输入并运行语句，或执行脚本文件中的语句。
- 自动补全：使用 Tab 键补全 GQL 语句。
- 历史记录：查看并重新运行已执行的语句。
- 结果格式：以不同格式显示查询结果。
在 Docker Compose 部署中进入 ngql¶
按部署教程启动悦数图数据库开发版后，在运行 Docker 的开发机终端进入compose.yaml所在目录，执行：
docker compose exec ngql ngql --host graph-cluster --port 9669 --user root
第一个ngql是 Compose 服务名，第二个是容器内的客户端命令。graph-cluster:9669是容器网络中的 Graph 服务地址，无需替换为开发机 IP。
出现Password提示后，输入悦数图数据库开发版当前的root密码；首次部署密码的设置和转义规则见设置 root 密码。连接成功后，可在提示符下输入 GQL 语句；输入:q退出客户端。
连接与查询的示例见连接并完成首次查询。
下载独立安装包¶
配套 Docker Compose 已包含ngql容器。需要在开发机或其他机器上直接运行客户端时，可下载独立安装包。
当前版本：5.3.1。按客户端所在机器的操作系统和 CPU 架构选择安装包。
| 操作系统 | CPU 架构 | 安装包 | 校验文件 |
|---|---|---|---|
| macOS | Apple 芯片（ARM64） | 下载 | SHA-256 |
| macOS | Intel（x86-64） | 下载 | SHA-256 |
| Linux | ARM64 | 下载 | SHA-256 |
| Linux | x86-64 | 下载 | SHA-256 |
| Windows | x86-64 | 下载 | SHA-256 |
需要检查文件完整性时，见校验安装包。
解压并连接¶
确认悦数图数据库开发版已按部署教程启动，再在安装包所在目录打开终端。运行下方命令前，将<package-name>替换为下载的文件名。
默认连接本机的127.0.0.1:9669。从其他机器连接时，将127.0.0.1改为运行 Docker 的开发机 IP；如已修改端口映射，使用修改后的开发机端口。
tar -xzf "<package-name>"
cd yueshu-graph-ngql/bin
./ngql --host 127.0.0.1 --port 9669 --user root
tar -xzf "<package-name>"
Set-Location yueshu-graph-ngql/bin
.\ngql.exe --host 127.0.0.1 --port 9669 --user root
出现Password提示后，输入当前的root密码。连接成功后，按首次查询加载示例数据并执行查询。