问题现象
在各个项目实施中,我们经常遇到客户、开发人员需要连接和使用YashanDB但不知如何操作的问题,本文旨在介绍远程连接、使用YashanDB的几种方式。
问题的风险及影响
无风险
问题影响的版本
历史版本~23.2
问题发生原因
无
解决方法及规避方式
不需要规避
问题分析和处理过程
方式一 客户端工具yasql
yasql简介
yasql 是YashanDB的客户端连接管理工具,可以通过此工具连接数据库服务器并对其进行操作和维护,除了具备操作数据库的基本功能,yasql还提供了若干其他功能,便于用户使用。
一般而言,在部署YashanDB的数据库上会同步部署yasql,其安装目录一般在$YASDB_HOME/bin下。
yasql的一般使用
使用yasql -H命令可查看帮助和版本信息。
$ yasql -H
使用yasql -V命令可查看版本信息。
$ yasql -V
常用的登录方式:
-
方式一:通过输入用户名 、密码、数据库主机名和监听端口等信息登录并连接数据库,格式为"yasql /@:"。
-
方式二:通过在${YASDB_HOME}/client/yasc_service.ini中定义的连接别名登录并连接数据库,格式为"yasql /@alias"。
-
方式三:通过操作系统认证方式登录,格式为"yasql / as sysdba"或"yasql / as sysdba",连接到本地YASDB_DATA环境变量对应的数据库实例。操作系统认证方式登录需配置后才可使用,配置操作请参考数据库管理手册操作系统身份认证配置。
操作示例
使用Yasql执行一个sql文件、
可以通过参数"-f [-e]" 执行一个SQL文件。其中,“-e”显示执行的语句。通过重定向符,还可以记录输出。
操作示例
通过 “!” 执行外部的shell命令
可以通过使用 "!“ 在yasql中执行外部命令
操作示例
如何退出
通过 “exit” 或者 ctrl+z的方式退出yasql
操作示例
在输入sql时回退以及上下翻页
安装rlwrap
sudo yum install rlwrap
sudo yum -y install readline*
wget http://files.cnblogs.com/files/killkill/rlwrap-0.30.tar.gz.zip
tar -xf rlwrap-0.30.tar.gz.zip
cd rlwrap-0.30
./configure
make
sudo make install
操作示例
如何单独安装Yasql
当需要在一台额外的服务器上访问远程的数据库时(或在windows本地),可能需要单独安装yasql。
linux中安装使用
1 获得安装包--arm 环境
yashandb-client-23.1.3.101-linux-aarch64.tar.gz--X86环境
yashandb-client-23.1.3.101-linux-x86_64.tar.gz2 解压安装包cd /home/yashanclient/yasql (例如在这个目录)
tar -zxf yashandb-client-23.1.3.101-linux-x86_64.tar.gz3 获得当前目录,设置环境变量pwd
#例如输出:/home/yashanclient/yasqlexport LD_LIBRARY_PATH=${解压目录}/lib:$LD_LIBRARY_PATH
#例如:
export LD_LIBRARY_PATH=/home/yashanclient/yasql/lib:$LD_LIBRARY_PATH或者永久生效:
vi ~/.bashrc
写入
export LD_LIBRARY_PATH=${解压目录}/lib:$LD_LIBRARY_PATH
:wq!
source ~/.bashrc4 连接yashan服务端cd yasql解压目录/bin./yasql 用户/密码@IP:端口
windows中安装使用
1 解压yashandb-client-23.1.3.101-windows-amd64.zip
2 设置环境变量假如解压的目录是:C:\Users\huangsl\Desktop\yashandb-client-23.1.3.101-windows-amd64添加环境变量:用户环境变量--> 双击Path-->新建: C:\Users\huangsl\Desktop\yashandb-client-23.1.3.101-windows-amd64\lib保存3 使用打开powershellcd C:\Users\huangsl\Desktop\yashandb-client-23.1.3.101-windows-amd64\bin.\yasql username/userpassword@ip:port
方式二 使用开发者工具DBeaver
DBeaver简介
DBeaver for YashanDB基于流行的开源图形化工具DBeaver,在严格遵循DBeaver Community Edition 的ASL开源协议基础上,进行了二次开发和封装,支持管理单机、集群和分布式三种形态的YashanDB数据库图形化开发及管理。可以通过下载中心下载:https://download.yashandb.com/download
连接YashanDB
参考操作文档:DBeaver 建立YashanDB连接
方式三 使用Yasboot连接
Yasboot工具也集成了yasql客户端的功能(实际上是调用了yasql)。
示例1(连接yasql客户端)
#指定节点标识连接
$ yasboot sql -n 1-1 -u username -p password -c yashandb#指定IP:PORT连接
$ yasboot sql -d username/password@127.0.0.1:1688# ipv6 需要添加中括号
$ yasboot sql -d username/password@[::1]:1688
示例2(执行SQL语句)
$ yasboot sql -n 1-1 -u username -p password -c yashandb -s 'select status from v$instance;'STATUS
-----------------
OPEN
示例3(执行SQL文件)
$ yasboot sql -d username/password@127.0.0.1:1678 -f get_status.sql --echo
方式四 使用高级编程语言的数据库驱动
YashanDB 23.2版本对外支持的驱动有:JAVA、Python、C、.NET等
以常用的JDBC举例:
//DriverManager方法
public static Connection getConnection(String username, String passwd) {//驱动类。String driver = "com.yashandb.jdbc.Driver";//数据库连接描述符。String sourceURL = "jdbc:yasdb://10.10.10.2:1688/yasdb";Connection conn = null;try {//加载驱动。Class.forName(driver);} catch( Exception e ) {e.printStackTrace();return null;}try {//创建连接。conn = DriverManager.getConnection(sourceURL, username, passwd);System.out.println("Connection succeed!");} catch(Exception e) {e.printStackTrace();return null;}return conn;}//YasDataSource方法
public static Connection getConnDS() {Connection connect = null;try {YasDataSource ads = new YasDataSource();ads.setURL(url);connect = ads.getConnection(user, password);} catch (Exception e) {e.printStackTrace();}return connect;}
其它详细介绍见文档:JDBC驱动
经验总结
无