作者：lzzzz

本文主要介绍如何创建崖山数据库型的数据源，使用版本为超图idesktopX：11.2.1 ，使用环境：Windows 10；yashandb：23.2.5.100，使用环境：centos 7.9。

崖山数据库安装

以单机部署为例，崖山数据库主要安装步骤如下

创建yashan用户；

useradd -d /home/yashan -m yashan
passwd yashan

创建yashan用户组；

groupadd YASDBA
usermod -a -G YASDBA yashan

把yashan数据库包放至/home/install，并进行解压

cd /home/yashan/install
tar -zxvf yashandb-23.2.5.100-linux-x86_64.tar.gz

启动Web服务端

./bin/yasom --web --listen 192.168.1.2:9001

然后，就可以通过http://192.168.1.2:9001来访问安装页面，通过引导来进行数据库的安装，其中192.168.1.2为数据库服务器ip。

如果需要其他方式的安装，可以参考单机（主备）部署 | YashanDB Doc

至此，数据库安装成功。

崖山客户端安装

直接解压对应yashandb-client包，并在Windows配置用户环境变量的工具中，为Path变量增加如下内容：

D:\yashandb-client\bin
D:\yashandb-client\lib

打开桌面，新建数据库数据源中的yashan按钮亮起，即为安装成功。

常见问题 

1，新建数据源后，关闭后重新打开数据源失败

崖山数据库大小写敏感，且建库时会自动转换为大写，因此，新建数据源时候，要保证数据库名称全部大写。

2，新增某些中文字段失败或者乱码

yasql的Windows客户端字符集为GBK，服务器字符集默认为UTF8,

在YashanDB客户端文件夹中新建client文件夹，并于client文件夹中新建文件yasc_env.ini，文件内设置字符集为UTF8。

CHARACTER_SET=UTF8

然后，把客户端目录配置为YASDB_HOME环境变量，结果如图所示

3，使用组件开发时，无法读取或识别崖山数据源

没有读到对应的依赖库，可以把yashandb-client中lib目录下的依赖复制到组件bin目录解决