CHECKSUM (Transact-SQL)

Devuelve el valor de suma de comprobación calculado sobre una fila de una tabla o sobre una lista de expresiones. CHECKSUM se ha pensado para utilizarlo en la generación de índices hash.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

  • *
    Especifica que el cálculo se realiza sobre todas las columnas de la tabla. CHECKSUM devuelve un error si alguna columna tiene un tipo de datos no comparable. Los tipos de datos no comparables son text, ntext, image, XML y cursor, así como sql_variant con uno de los tipos anteriores como tipo base.

  • expression
    Es una expresión de cualquier tipo excepto un tipo de datos no comparable.

Tipos de valor devueltos

int

Notas

CHECKSUM calcula un valor hash, denominado suma de comprobación, sobre su lista de argumentos. El valor hash se ha pensado para utilizarlo en la generación de índices hash. Si los argumentos de CHECKSUM son columnas y se genera un índice sobre el valor CHECKSUM calculado, el resultado es un índice hash. Éste se puede utilizar para búsquedas de igualdades sobre las columnas.

CHECKSUM cumple las propiedades de una función hash: si se aplica CHECKSUM sobre dos listas de expresiones, devuelve el mismo valor si los elementos correspondientes de las dos listas tienen el mismo tipo y son iguales cuando se comparan utilizando el operador igual (=). En esta definición, la comparación de valores NULL de un tipo específico se consideran como iguales. Si uno de los valores de la lista de expresiones cambia, la suma de comprobación de la lista generalmente también cambia. No obstante, existe una pequeña posibilidad de que la suma de comprobación no cambie. Por este motivo, no se recomienda usar CHECKSUM para detectar si han cambiado los valores, a menos que la aplicación pueda tolerar perder un cambio ocasionalmente. Considere la posibilidad de utilizar HashBytes en su lugar. Cuando se especifica un algoritmo hash MD5, la probabilidad de que HashBytes devuelva el mismo resultado de dos entradas diferentes es mucho menor que la de que lo haga CHECKSUM.

El orden de las expresiones afecta el valor del resultado de CHECKSUM. El orden de las columnas utilizadas en el caso de CHECKSUM(*) es el orden de las columnas especificado en la definición de la tabla o la vista. Esto incluye las columnas calculadas.

Ejemplos

En los ejemplos siguientes se muestra cómo utilizar CHECKSUM para generar índices hash. El índice hash se genera al agregar una columna de suma de comprobación calculada a la tabla que se va a indizar y después generar un índice en la columna de suma de comprobación.

-- Create a checksum index.
SET ARITHABORT ON;
USE AdventureWorks; 
GO
ALTER TABLE Production.Product
ADD cs_Pname AS CHECKSUM(Name);
GO
CREATE INDEX Pname_index ON Production.Product (cs_Pname);
GO

El índice de la suma de comprobación se puede utilizar como un índice hash, especialmente para mejorar la velocidad de indización cuando la columna que se va a indizar es una columna de cadenas largas de caracteres. El índice de suma de comprobación se puede utilizar para búsquedas de igualdades.

/*Use the index in a SELECT query. Add a second search 
condition to catch stray cases where checksums match, 
but the values are not the same.*/
SELECT * 
FROM Production.Product
WHERE CHECKSUM(N'Bearing Ball') = cs_Pname
AND Name = N'Bearing Ball';
GO

La creación del índice en la columna calculada se materializa en la columna de suma de comprobación y cualquier cambio en el valor de ProductName se propagará a la columna de suma de comprobación. Alternativamente, se podría generar un índice directamente en la columna indizada. No obstante, si los valores clave son largos, es posible que un índice normal tenga un rendimiento peor que un índice de suma de comprobación.