// SQL Server 错误参考

SQL Server 错误 8169:转换为 uniqueidentifier 失败

转换为 uniqueidentifier 的字符串不是有效的 GUID:长度错误、存在多余字符或为空字符串。

错误编号
8169
严重性
16
类别
数据转换与截断
错误信息
Conversion failed when converting from a character string to uniqueidentifier.

它的意思

A uniqueidentifier 必须是 32 个十六进制数字,也可以采用 8-4-4-4-12 带连字符的形式,也可以选择加大括号。其他任何值,包括空字符串,都会转换失败并报 8169 错误。

常见原因

  • GUID 列中的空字符串或占位符文本,该列存储为 varchar.
  • 比较一个 uniqueidentifier 列与不是 GUID 的字符串比较,从而强制转换该字符串。
  • GUID 带有多余字符,例如随值一起复制的引号或空格。

如何修复它

  1. 找到不是有效 GUID 的值。

    SELECT RawId FROM staging.Items WHERE TRY_CONVERT(uniqueidentifier, RawId) IS NULL AND RawId IS NOT NULL;
  2. 在转换之前,将空字符串转换为 NULL。

    SELECT TRY_CONVERT(uniqueidentifier, NULLIF(LTRIM(RTRIM(RawId)), '')) FROM staging.Items;

安全地复现它

SELECT CAST('not-a-guid' AS uniqueidentifier);  -- Msg 8169

相关错误

更多数据转换和截断错误

代码和消息文本来自 Microsoft 数据库引擎事件和错误参考。浏览完整的 SQL Server 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 SQL Server

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 SQL Server 以及你使用的其他数据库。