使用 kwbase CLI 工具连接 KWDB
kwbase 是 KWDB 提供的在命令行下运行的数据库连接工具。用户可以通过此工具连接 KWDB 数据库并对其进行操作和维护。
如果使用脚本部署 KWDB,系统还会自动生成 kw-sql 便捷脚本,并在 /usr/bin 目录下创建软链接 kw-sql。该脚本封装了 kwbase 连接命令,方便 root 用户快速登录数据库。
使用便捷脚本快速登录
说明
kw-sql 不支持指定其他用户,如需使用其他用户,请使用 kwbase 命令登录。
前提条件
已使用 deploy.sh 脚本部署和启动 KWDB。
步骤
在节点任一位置执行以下命令,使用 root 用户连接数据库:
kw-sql
使用 kwbase 命令连接数据库
除了使用便捷脚本外,用户也可以直接使用 kwbase 命令连接数据库。kwbase 命令支持指定不同用户、配置各类连接参数,适用于需要灵活控制的场景。
前提条件
已部署 KWDB。有关详细信息,参见单节点裸机部署或单节点容器部署。
提示
如采用容器部署方式,需使用以下命令格式连接数据库:
docker exec -it <container-name> ./kwbase sql [security-options] --host=<your-host-ip> [-u <username>]
非安全模式连接
提示
非安全模式应仅在测试环境中使用。
以下示例说明如何以非安全模式连接 KWDB。
使用部署数据库时所用的用户:
./kwbase sql --insecure --host=<your-host-ip>使用自定义用户:
./kwbase sql --insecure --host=<your-host-ip> -u <username>
安全模式连接
以下示例说明如何以安全模式连接 KWDB。
使用部署数据库时所用的用户:
./kwbase sql --certs-dir=/etc/kaiwudb/certs --host=<your-host-ip>使用自定义用户:
./kwbase sql --certs-dir=/etc/kaiwudb/certs --host=<your-host-ip> -u <username>