虚谷文档 v1.0.2

适用虚谷数据库版本

v12.9



适用虚谷数据库版本

v12.9


部署连接 ​

📄字数 5.0K
👁️阅读量 加载中...

本章节主要介绍非生产环境下，单机部署，快速体验 XuguDB。

获取版本 ​

在虚谷官网的下载中心，下载 XuguDB 产品包，以 XuguDB-12.0.0-xxx-xxx-20250714-1209009.zip 示例数据库部署与客户端工具连接。

快速部署 ​

提示

本方案适用于学习、测试、适配环境，如需在生产环境部署 XuguDB，则参考部署数据库。

  1. 在自定义路径解压 XuguDB 产品包。

  2. 进入目录 ./XuguDB/Server/BIN/， 执行脚本 startdb.sh 前端监控方式启动数据库。默认监听端口：5138。

    示例：

    sh
    $ cd ./XuguDB/Server/BIN/
$ ./startdb.sh
当前脚本支持终端启动，其它方式启动参考数据库使用文档
XuguDB 12.0.0 (Built:2025-07-14 12:00:00 GA)
Start at: 2025-07-14 15:12:56
database server PID=102601
...
Open file cluster.ini failed.
Loading license ... failed!
init data buffer...ok.
Perform control file checksum...ok.
Trial Edition,remain 360 days
open all tablespaces...ok.
Load all local stores...ok.
Load all gstores...ok.
Mount all gstore...ok.
Open all system tables...ok
Open all system views...ok
Load all jobs...ok
All service started.
Listening at port 5138

  3. 可使用执行程序的命令行参数启动，如：

    前端监控方式启动。如果当前远程登录主机的连接关闭，则数据库服务进程将被中止并退出。

    sh
    $ ./xugu_linux_x86_64_20250714 --child

    后台服务方式启动。数据库服务进程不会因当前远程登录主机的连接关闭而退出。

    sh
    $ ./xugu_linux_x86_64_20250714 --server

客户端连接 ​

XuguDB部署完成后，使用产品包中 Client 目录下的客户端工具连接测试。

xgconsole ​

控制台工具位于产品包 ./XuguDB/Client/xgconsole/ 目录下。

可以在虚谷官网-下载中心单独下载虚谷数据库控制台 （xgconsole）。

提示

本方案使用 xgconsole 于 Linux 本地快捷登录。

  1. 进入目录 ./XuguDB/Client/xgconsole/ 。

  2. 连接方式一：执行脚本 xgconsole_local.sh 。此脚本使用默认连接信息，IP 127.0.0.1、端口 5138、系统库SYSTEM、SYSDBA 用户及口令，无需手动输入连接信息。

    sh
    [root@kunqian236 xgconsole]# ./xgconsole_local.sh

XuguDB Linux Console GA V2.2.7

Copyright (c) 2002-2025 XuGuWeiYe Technologies Co., Ltd.  All rights reserved.

Connect to 127.0.0.1:5138 SYSTEM SYSDBA. Connect ok.

SQL>

  3. 连接方式二：执行脚本 xgconsole.sh ，手动输入数据库相关信息，即可连接。

    sh
    [root@kunqian236 xgconsole]# ./xgconsole.sh 
Server [127.0.0.1]: 127.0.0.1
Port [5138]: 5138
SSL [nssl]: nssl
Database [SYSTEM]: SYSTEM
Username [SYSDBA]: SYSDBA 
Please input password:*masked*

XuguDB Linux Console GA V2.2.7

Copyright (c) 2002-2025 XuGuWeiYe Technologies Co., Ltd.  All rights reserved.

Connect to 127.0.0.1:5138 SYSTEM SYSDBA. Connect ok.

SQL>

  4. 连接方式三：执行控制台可执行程序，后跟数据库相关信息，即可连接。

    sql
    ./xgconsole -s nssl -h 127.0.0.1 -P 5138 -d SYSTEM -u SYSDBA -p SYSDBA

注意

xgconsole_local.sh 脚本文件中保存用户密码信息，仅用于测试库。

更多控制台工具 xgconsole 使用，详情参考 虚谷数据库控制台工具 。

DBeaver ​

参考 DBeaver管理工具 DBeaver下载安装 与 创建虚谷数据库连接 章节，连接 XuguDB 。