共用方式為

BINARY_CHECKSUM (Transact-SQL)

  • 發行項

適用於：SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Microsoft Fabric 中的 SQL 分析端點 Microsoft Fabric 中的倉儲

傳回針對一份資料表的某個資料列或一份運算式清單，來計算的二進位總和檢查碼值。

Transact-SQL 語法慣例

Syntax

BINARY_CHECKSUM ( * | expression [ ,...n ] )

注意

Azure Synapse Analytics 的無伺服器 SQL 集區不支援此語法。

引數

*
指定計算涵蓋所有資料表資料行。 BINARY_CHECKSUM 忽略其計算中無法比較之資料類型的資料行。 無法比較的資料類型包含

  • cursor
  • image
  • ntext
  • text
  • xml

和無法比較的 Common Language Runtime (CLR) 使用者定義類型。

expression
任意類型的運算式。 BINARY_CHECKSUM 忽略其計算中無法比較之資料類型的運算式。

傳回型別

int

備註

只要稍後不修改資料列，對資料表任何資料列執行計算的 BINARY_CHECKSUM(*) 就會傳回相同值。 BINARY_CHECKSUM 會滿足雜湊函數的屬性：套用於任兩個運算式清單時，如果這兩個清單的對應元素具有相同的類型，且在使用等於 (=) 運算子進行比較時相等，則會傳回相同的值。 在此定義中，假設所指定類型的 Null 值比較為相等值。 如果運算式清單中至少有一個值變更，則運算式總和檢查碼也會變更。 不過，不一定有這項變更，因此若要偵測值是否已變更，建議只有在您的應用程式可以容忍偶而遺失的變更時才使用 BINARY_CHECKSUM。 否則，請考慮改用 HASHBYTES。 使用指定的 MD5 雜湊演算法，HASHBYTES 將為兩個不同輸入傳回相同結果的可能性比 BINARY_CHECKSUM 要低很多。

BINARY_CHECKSUM 可以對運算式清單進行操作，而它會針對指定的清單傳回相同的值。 套用於任兩個運算式清單的 BINARY_CHECKSUM，如果這兩個清單的對應元素具有相同的類型和位元組表示法，則會傳回相同的值。 對這項定義而言，指定類型的 Null 值會被視為具有相同位元組表示法。

BINARY_CHECKSUM 和 CHECKSUM 為類似的函數。 它們可用來計算運算式清單的總和檢查碼值，而運算式的順序會影響結果值。 用於 BINARY_CHECKSUM(*) 的資料行順序，就是資料表或檢視定義中所指定的資料行順序。 這項排序包含計算資料行。

BINARY_CHECKSUM 和 CHECKSUM 所傳回的字串資料類型值不同，其中地區設定會造成不同表示法的字串比較為相等。 字串資料類型為

  • char
  • nchar
  • nvarchar
  • varchar

或

  • sql_variant (如果 sql_variant 的基底類型是字串資料類型)。

例如，"McCavity" 和 "Mccavity" 字串的 BINARY_CHECKSUM 值不同。 反之，在不區分大小寫的伺服器中，CHECKSUM 就會針對那些字串傳回相同的總和檢查碼值。 您應該避免比較 CHECKSUM 值與 BINARY_CHECKSUM 值。

BINARY_CHECKSUM 支援任意長度的類型 varbinary(max)，並支援最多 255 個字元的類型 nvarchar(max)。

範例

此範例使用 BINARY_CHECKSUM 來偵測資料表資料列中的變更。

USE AdventureWorks2022;  
GO  
CREATE TABLE myTable (column1 INT, column2 VARCHAR(256));  
GO  
INSERT INTO myTable VALUES (1, 'test');  
GO  
SELECT BINARY_CHECKSUM(*) from myTable;  
GO  
UPDATE myTable set column2 = 'TEST';  
GO  
SELECT BINARY_CHECKSUM(*) from myTable;  
GO

另請參閱

彙總函式 (Transact-SQL)
CHECKSUM_AGG (Transact-SQL)
CHECKSUM (Transact-SQL)
HASHBYTES (Transact-SQL)