SqlConnectorV6.0 - 数据库连接工具操作手册
目录
1. 软件简介
SQLConnector是数据库连接工具，作为C/S软件开发框架配套工具，用于连接产品数据库以及配置业务账套。
SQLConnector适用以下软件产品：
- CSFrameworkV6.0 旗舰版
- CSFrameworkV6.0 代码生成器
连接数据库成功后，配置的参数存储在debug\config\db.json文件
2. 软件界面
【数据库类型】：支持连接SqlServer/MySQL/Oracle三种数据库。
【服务器/IP】：服务器地址/IP地址，支持DNS域名，如：www.abc.com/db，若填写IP地址：如：192.168.1.5。
【端口】：服务器端口。三种常用数据库默认端口：SqlServer=1433，MySql=3306，Oracle=1521。
【数据库名】：默认连接的数据库名称，如：CSFrameworkV6_System，必须连接开发框架的系统数据库。
【用户】：数据库用户，如：sa, root
【密码】：数据库用户的密码。
3. SQLConnector - 测试连接
输入【服务器/IP】、【数据库名】、【用户】和【密码】，点【连接服务器】按钮，若连接成功，提示：
连接失败，提示：
检查：服务器IP、端口、用户和密码是否正确。
4. SQLConnector - 配置两种后台连接模式
CSFramework开发框架支持两种后台连接模式：ADO-Direct模式、WebApi服务器。
ADO-Direct模式
ADO-Direct：直连数据库模式，客户端直接连接数据库服务器。
选择【ADO-Direct模式】及【外网连接】，点【保存配置】按钮。
ADO-Direct直连模式：支持【本地连接】和【外网连接】，连接的服务器IP分别对应 tb_DataSet 表的 LocalServerIP 和 RemoteServerIP 字段。
WebApi 服务器
WebApi服务器：连接WebApi服务器。
WebApi开发框架：CSFramework.WebApi V3.0 WebApi开发框架(.NETCore+EFCore)-开发框架文库 (cscode.net)
输入WebApi地址，点【测试连接】按钮。
后台连接方式参数值存储位置：
后台连接模式参数配置信息保存在debug\config\user.ini文件：
[BridgeType]
BridgeType=ADODirect 或 WebApi
IPType=LAN
5. 配置账套
SqlConnector V6.0 提供配置账套功能，用于维护 CSFrameworkV6_System数据库 tb_DataSet 表资料。
【修改】：在账套表选择一条记录，点【修改】按钮，用户可修改当前账套资料。
【取消】：取消当前的修改，并自动还原数据。
【保存】：保存修改的账套信息。
【连接账套】：在账套表选择一条记录，点【连接账套】按钮，测试账套配置是否正确。
您可以测试账套的本地IP、远程IP，参考下图：
修改账套信息时，数据库密码显示明文，保存到数据库是加密的密码。
6. SqlConnector C#源码
7. 依赖程序集
- CSFramework.EF.dll ，数据库框架，产品详情：https://www.cscode.net/archive/csframework.ef/363596745297925.html
- CSFramework.EF.SqlServer.dll， 默认使用SqlServer数据库
- CSFrameworkV6.Core.dll ,开发框架核心库
8. 依赖的NuGet包
SqlConnector主程序需要安装对应数据库NuGet包。
SqlServer 数据库
<ItemGroup>
<PackageReference Include="Microsoft.EntityFrameworkCore" Version="8.0.0" />
<PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="8.0.0" />
<PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer.NetTopologySuite" Version="8.0.0" />
<PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />
<PackageReference Include="System.Data.SqlClient" Version="4.8.6" />
</ItemGroup>
Oracle 数据库
<ItemGroup>
<PackageReference Include="Microsoft.EntityFrameworkCore" Version="8.0.0" />
<PackageReference Include="Oracle.EntityFrameworkCore" Version="8.21.121" />
<PackageReference Include="Oracle.ManagedDataAccess.Core" Version="23.5.1" />
<PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />
</ItemGroup>
MySql数据库
<ItemGroup>
<PackageReference Include="Google.Protobuf" Version="3.22.1" />
<PackageReference Include="K4os.Compression.LZ4.Streams" Version="1.3.5" />
<PackageReference Include="MySql.Data" Version="8.0.32" />
<PackageReference Include="MySqlConnector" Version="2.3.7" />
<PackageReference Include="Microsoft.EntityFrameworkCore" Version="8.0.0" />
<PackageReference Include="Pomelo.EntityFrameworkCore.MySql" Version="8.0.0" />
<PackageReference Include="Pomelo.EntityFrameworkCore.MySql.NetTopologySuite" Version="8.0.0" />
<PackageReference Include="Portable.BouncyCastle" Version="1.9.0" />
<PackageReference Include="SSH.NET" Version="2020.0.2" />
<PackageReference Include="System.ComponentModel.Annotations" Version="5.0.0" />
<PackageReference Include="System.Management" Version="8.0.0" />
</ItemGroup>
