国产数据库

数据库名称	提供者	系列风格
达梦	FreeSql.Provider.Dameng	Oracle
神州通用	FreeSql.Provider.ShenTong	PostgreSQL
人大金仓	FreeSql.Provider.KingbaseES	PostgreSQL
南大通用	FreeSql.Provider.GBase	Informix
虚谷	FreeSql.Provider.Xugu	Oracle
翰高	FreeSql.Provider.Custom、FreeSql.Provider.Odbc	PostgreSQL
华为(OpenGuass)	FreeSql.Provider.PostgreSQL	PostgreSQL

由于太多，在此不一一列举，它们大多数语法兼容 MySql、Oracle、SqlServer、PostgreSQL 四种常用数据库之一。

FreeSql.Provider.Custom 提供了这四种数据库适配，并且支持 CodeFirst/DbFirst 以及完整的 FreeSql 功能。

FreeSql.Provider.Custom 不依赖具体 ado.net/odbc/oledb dll 驱动，使用者在外部自行引用 dll 驱动。

访问 MySql 数据库为例：

var fsql = new FreeSqlBuilder()
    .UseConnectionFactory(DataType.CustomMySql, () =>
        new MySqlConnection("Data Source=..."))
    .UseNoneCommandParameter(true)
    .UseMonitorCommand(cmd => Console.WriteLine(cmd.CommandText))
    .Build();
fsql.SetDbProviderFactory(MySqlConnectorFactory.Instance);

若某国产数据库兼容 MySql SQL，先引用对方提供的 DLL，然后：

• 将上面 new MySqlConnection 替换成 new XxxConnection
• 将上面 MySqlConnectorFactory.Instance 替换成对应的 DbProviderFactory

提示：对方 DLL 一般都会提供这两个现实类

---

华为报错：Received AuthenticationSASL message with 0 mechanisms!

1、连接串

Host=127.0.0.1;Port=15432;Username=qadmin;Password=******;Database=db;No Reset On Close=true;Pooling=true;Minimum Pool Size=1

2、pg_hba.conf

host    all             all             0.0.0.0/0               sha256
host    all             all             127.0.0.1/32            trust

3、postgresql.conf

password_encryption_type = 1

华为魔改 PostgreSQL 不支持 ON CONFLICT DO UPDATE，解决方法 FreeSqlBuilder().Build() 之后设置：

(fsql as IPostgreSQLProviderOptions).UseMergeInto = true;

自定义适配

除了上面，还提供了自定义适配更多的数据库，比如 mssql2000、db2，自定义适配将牺牲一些功能：

• 不支持 CodeFirst 自动迁移
• 不支持 DbFirst 接口方法的实现
• 不支持 原来的分页方法，需要自行判断 id 进行分页
• 只支持较少的基础类型：bool,sbyte,short,int,long,byte,ushort,uint,ulong,double,float,decimal,DateTime,byte[],string,Guid

使用者只需求重写类 FreeSql.Custom.CustomAdapter 就可以自定义访问不同的数据库。

我们默认做了一套 sqlserver 的语法和映射适配，代码在 CustomAdapter.cs，请查看代码了解。

class Mssql2000Adapter : FreeSql.Custom.CustomAdapter
{
    public override string InsertAfterGetIdentitySql => "SELECT SCOPE_IDENTITY()";
    //可以重写更多的设置
}

static IFreeSql fsql = new FreeSqlBuilder()
    .UseConnectionString(DataType.Custom, () => new SqlConnection(@"Data Source=..."))
    .Build(); //be sure to define as singleton mode

fsql.SetCustomAdapter(new Mssql2000Adapter());

适配好新的 CustomAdapter 后，请在 FreeSqlBuilder.Build 之后调用 IFreeSql.SetCustomAdapter 方法生效。