OLE DB Driver for SQL Server 中的 UTF-8 支援

發行項
05/23/2023

適用於：SQL Server Azure SQL Database Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System (PDW)

Microsoft OLE DB Driver for SQL Server (18.2.1 版) 新增 UTF-8 伺服器編碼的支援。如需有關 SQL Server UTF-8 支援的相關資訊，請參閱：

驅動程式的 18.4.0 版新增 UTF-8 用戶端編碼的支援 (以 Windows 10 和 Windows 11 中 [區域設定] 下的 [使用全球語言支援的 Unicode UTF-8] 核取方塊來啟用)。

注意

Microsoft OLE DB Driver for SQL Server 使用 GetACP 函式來判斷 DBTYPE_STR 輸入緩衝區的編碼方式。

自 18.4 版起，支援 GetACP 傳回 UTF-8 編碼的案例 (以 Windows 10 和 Windows 11 中 [區域設定] 下的 [使用全球語言支援的 Unicode UTF-8] 核取方塊來啟用)。在舊版中，若緩衝區需要儲存 Unicode 資料，則緩衝區資料類型應設定為 DBTYPE_WSTR (UTF-16 編碼)。

將資料插入至 UTF-8 編碼的 CHAR 或 VARCHAR 資料行

建立輸入參數緩衝區以用於插入時，會使用 DBBINDING 結構 \(英文\) 的陣列來描述緩衝區。每個 DBBINDING 結構都會將單一參數關聯至取用者的緩衝區，並包含資料值的類型與長度等資訊。針對類型 CHAR 的輸入參數緩衝區，應該將 DBBINDING 結構的 wType 設定為 DBTYPE_STR。針對類型 WCHAR 的輸入參數緩衝區，應該將 DBBINDING 結構的 wType 設定為 DBTYPE_WSTR。

搭配參數執行命令時，驅動程式會建構參數資料類型資訊。如果輸入緩衝區類型和參數資料類型相符，就不會在驅動程式中進行任何轉換。否則，驅動程式會將輸入參數緩衝區轉換為參數資料類型。使用者可以藉由呼叫 ICommandWithParameters::SetParameterInfo \(英文\)，明確地設定參數資料類型。若未提供此資訊，驅動程式就會 (a) 在陳述式備妥時從伺服器中擷取資料行中繼資料，或 (b) 嘗試從輸入參數資料類型進行預設轉換，藉以衍生參數資料類型資訊。

根據輸入緩衝區資料類型和參數資料類型而定，可能會透過驅動程式或伺服器來將輸入參數緩衝區轉換為伺服器資料行定序。轉換期間，如果用戶端字碼頁或資料庫定序字碼頁無法表示輸入緩衝區中的所有字元，則可能會發生資料遺失。下表描述將資料插入至啟用 UTF-8 的資料行時的轉換流程：

緩衝區資料類型	參數資料類型	轉換	使用者預防措施
DBTYPE_STR	DBTYPE_STR	從用戶端字碼頁到資料庫定序字碼頁的伺服器轉換；從資料庫定序字碼頁到資料行定序字碼頁的伺服器轉換。	確定用戶端字碼頁和資料庫定序字碼頁均可表示輸入資料中的所有字元。例如，若要插入波蘭文字元，可以將用戶端字碼頁設定為 1250 (ANSI 中歐語系)，而資料庫定序可以使用波蘭文作為定序指示項 (例如 Polish_100_CI_AS_SC) 或啟用 UTF-8。
DBTYPE_STR	DBTYPE_WSTR	從用戶端字碼頁到 UTF-16 編碼的驅動程式轉換；從 UTF-16 編碼到資料行定序字碼頁的伺服器轉換。	確定用戶端字碼頁可以表示輸入資料中的所有字元。例如，若要插入波蘭文字元，可以將用戶端字碼頁設定為 1250 (ANSI 中歐語系)。
DBTYPE_WSTR	DBTYPE_STR	從 UTF-16 編碼到資料庫定序字碼頁的驅動程式轉換；從資料庫定序字碼頁到資料行定序字碼頁的伺服器轉換。	確定資料庫定序字碼頁可以表示輸入資料中的所有字元。例如，若要插入波蘭文字元，資料庫定序字碼頁可以使用波蘭文作為定序指示項 (例如 Polish_100_CI_AS_SC) 或啟用 UTF-8。
DBTYPE_WSTR	DBTYPE_WSTR	從 UTF-16 到資料行定序字碼頁的伺服器轉換。	無。

從 UTF-8 編碼的 CHAR 或 VARCHAR 資料行擷取資料

針對擷取的資料建立緩衝區時，會使用 DBBINDING 結構 \(英文\) 的陣列來描述緩衝區。每個 DBBINDING 結構都會與所擷取資料列中的單一資料行產生關聯。若要以 CHAR 格式擷取資料行資料，將 DBBINDING 結構的 wType 設定為 DBTYPE_STR。若要以 WCHAR 格式擷取資料行資料，將 DBBINDING 結構的 wType 設定為 DBTYPE_WSTR。

針對結果緩衝區類型指示器 DBTYPE_STR，驅動程式會將啟用 UTF-8 編碼的資料轉換為用戶端編碼。使用者應該確定用戶端編碼可以表示來自 UTF-8 資料行的資料，否則可能會發生資料遺失。

針對結果緩衝區類型指示器 DBTYPE_WSTR，驅動程式會將啟用 UTF-8 編碼的資料轉換為 UTF-16 編碼。

與不支援 UTF-8 的伺服器進行通訊

Microsoft OLE DB Driver for SQL Server 確定資料以伺服器能夠了解的方式公開至伺服器。當從已啟用 UTF-8 的用戶端插入資料時，驅動程式會在將 UTF-8 編碼字串傳送至伺服器之前，將其先翻譯為資料庫定序字碼頁。

注意

使用 ISequentialStream (英文) 介面將 UTF-8 編碼資料插入舊版文字資料行，僅限於支援 UTF-8 的伺服器。如需詳細資訊，請參閱 Blob 與 OLE 物件。

另請參閱

OLE DB Driver for SQL Server 功能
 OLE DB Driver for SQL Server 中支援 UTF-16