// 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 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 SQL Server 和你使用的其他資料庫。