NHibernate：如何将 C# [Guid] 插入 MySQL [BINARY(16) DEFAULT (uuid_to_bin(uuid(),1))] 列？

Question

环境： MySQL Server 8.0、.NET Core 3.1、MySql.Data 8.0.28、NHibernate 5.3.11

我有下表：

CREATE TABLE `Master` (
  `Row_Id` char(36) NOT NULL DEFAULT (uuid()),
  `Path` varchar(1000) NOT NULL,
  PRIMARY KEY (`Row_Id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;

以下是实体定义和映射：

public class MasterEntity
{
    public virtual Guid RowId { get; set; }
    public virtual string Path { get; set; }
}

internal sealed class MasterMap : ClassMapping<MasterEntity>
{
    public MasterMap()
    {
        Table("Master");

        Id
        (
            x => x.RowId,
            map =>
            {
                map.Column("Row_Id");
                map.Generator(Generators.GuidComb);
            }
        );

        Property(x => x.Path, map => { map.Column("Path"); map.NotNullable(true); map.Type(TypeFactory.GetAnsiStringType(1000)); });
    }
}

以下是我INSERT< /code> 该实体使用 NHibernate：

using(ISession session = SessionFactory.OpenSession())
{
    MasterEntity entity = new MasterEntity();
    entity.Path = "c:\whatever";
    session.Save(entity);
    session.Flush();
}

这会正确插入记录。到这里，一切都很好。

现在，我更改了 Row_Id 列的定义，如下所示：

`Row_Id` binary(16) NOT NULL DEFAULT (uuid_to_bin(uuid(),1)),

我没有更改 C# 代码中的任何内容。现在，session.Flush(); 调用会抛出以下异常：

NHibernate.Exceptions.GenericADOException: could not execute batch command.[SQL: SQL not available]
 ---> MySql.Data.MySqlClient.MySqlException (0x80004005): Data too long for column 'Row_Id' at row 1

该错误看起来很明显。 C# 中的 Guid 为 32，列长度为 16。
我需要在映射或实体定义（或代码的其他部分）中进行哪些更改才能将 C# Guid 插入 BINARY(16) DEFAULT (uuid_to_bin(uuid(),1))< /代码> 列？

Answer 1

默认情况下，MySql.Data 会将 Guid 存储为 CHAR(36)。您可以通过在连接字符串中指定 Old Guids = True; 来使用 BINARY(16)。

来自 连接器/NET 8.0 连接选项参考：

GUID 类型的后端表示形式已从 BINARY(16) 更改为 CHAR(36)。这样做是为了允许开发人员使用服务器函数 UUID() 填充 GUID 表 - UUID() 生成 36 个字符的字符串。旧版应用程序的开发人员可以将 'Old Guiids=true' 添加到连接字符串，以使用数据类型 BINARY(16) 的 GUID。

Answer 2

接受的答案中建议的方式有效；但它有一个问题。

问题中的代码使用 uuid_to_bin(uuid(),1);第二个 swap 参数设置为 1。这样，INSERT 就可以很好地工作了；但是当您选择该行时，您会得到完全不同的 UUID。这是因为，数据库驱动程序不知道 UUID 是否被交换。

更好的解决方案是使用 MySqlConnector 而不是 Oracle 的 Connector/NET (MySql.Data.dll ）。

对于 ADO.NET：

按照此处的说明进行配置。

对于 .NET Core 2.1 或更高版本，请在应用程序启动期间调用 DbProviderFactories.RegisterFactory("MySqlConnector", MySqlConnectorFactory.Instance)。这将在中央 DbProviderFactories 注册表中注册 MySqlConnector 的 DbProviderFactory 实现。

_{我的观察是，不需要调用DbProviderFactories.RegisterFactory。它只是通过添加 MySqlConnector.dll 的引用并删除 MySql.Data.dll 的引用来工作。}

使用 MySqlConnector，OldGuids=True; 设置可用，但过时的;避免它。
使用 GuidFormat=TimeSwapBinary16; 表示 uuid_to_bin(uuid(),1)（交换参数设置为 1）。
此处提到了其他可能的值：

确定应将哪个列类型（如果有）读取为 System.Guid。选项包括：

Char36：
所有 CHAR(36) 列均使用带连字符的小写十六进制作为 Guid 进行读取/写入，与 UUID() 匹配。
< br>
Char32：
所有 CHAR(32) 列都使用不带连字符的小写十六进制作为 Guid 进行读取/写入。

Binary16：
所有 BINARY(16) 列均使用大端字节顺序作为 Guid 进行读取/写入，与 UUID_TO_BIN(x) 匹配。

TimeSwapBinary16：
所有 BINARY(16) 列均作为 Guid 读取/写入，使用大端字节顺序并交换时间部分，与 UUID_TO_BIN(x,1)< /代码>。

LittleEndianBinary16：
所有 BINARY(16) 列均使用小端字节顺序（即 Guid.ToByteArray()Guid 进行读取/写入code> 和 Guid(byte[]) 构造函数。

无：
没有列类型会自动读取为 Guid。

默认：
如果 OldGuids=False，则与 Char36 相同； 如果 OldGuids=True，则与 LittleEndianBinary16 相同。




对于NHibernate：

• 安装NHibernate.MySqlConnector 来自 nuget 包。
• 在会话工厂配置中添加 configuration.DataBaseIntegration(c => c.MySqlConnectorDriver());。
• 如上所述，在连接字符串中设置 GuidFormat。

对于其他ORM：

使用请参考此与其他 ORM 一起使用。