HASHBYTES (Transact-SQL)

Aplica a:SQL ServerAzureSQL DatabaseAzureSQL Managed InstanceAzureSynapse AnalyticsSQLanalytics endpoint in Microsoft FabricAlmacén enla base de datos Microsoft FabricSQL en Microsoft Fabric

Devuelve el hash MD2, MD4, MD5, SHA, SHA1 o SHA2 de su entrada en SQL Server.

Transact-SQL Convenciones sintácticas

Sintaxis

HASHBYTES ( '<algorithm>', { @input | 'input' } )  
  
<algorithm>::= MD2 | MD4 | MD5 | SHA | SHA1 | SHA2_256 | SHA2_512   

Argumentos

<algorithm>
Identifica el algoritmo hash que se va a utilizar para realizar el hash de la entrada. Es un argumento requerido y no tiene valor predeterminado. Las comillas simples son necesarias. A partir de SQL Server 2016 (13.x), todos los algoritmos están en desuso, salvo SHA2_256 y SHA2_512.

@input
Especifica una variable que contiene los datos en los que se va a realizar el hash. @input es varchar, nvarchar o varbinario.

"input"
Especifica una expresión que se evalúa como un carácter o una cadena binaria que se va a aplicar el algoritmo hash.

La salida se ajusta al algoritmo estándar: 128 bits (16 bytes) para MD2, MD4 y MD5; 160 bits (20 bytes) para SHA y SHA1; 256 bits (32 bytes) para SHA2_256 y 512 bits (64 bytes) para SHA2_512.

Se aplica a: SQL Server 2012 (11.x) y versiones posteriores

En SQL Server 2014 (12.x) y versiones anteriores, los valores de entrada permitidos tienen un límite de 8000 bytes.

Valor devuelto

varbinary (máximo 8000 bytes)

Observaciones

Plantéese usar CHECKSUM o BINARY_CHECKSUM como alternativas para calcular un valor hash.

Los algoritmos MD2, MD4, MD5, SHA y SHA1 están en desuso desde SQL Server 2016 (13.x). Use SHA2_256 o SHA2_512 en su lugar.

Ejemplos

Devuelve el valor hash de una variable

En el siguiente ejemplo se devuelve el hash SHA2_256 de los datos nvarchar almacenados en la variable @HashThis.

DECLARE @HashThis NVARCHAR(32);  
SET @HashThis = CONVERT(NVARCHAR(32),'dslfdkjLK85kldhnv$n000#knf');  
SELECT HASHBYTES('SHA2_256', @HashThis);  

Devuelve el valor hash de una columna de tabla

En el ejemplo siguiente se devuelve el valor hash SHA2_256 de los valores de la columna c1 de la tabla Test1.

CREATE TABLE dbo.Test1 (c1 NVARCHAR(32));  
INSERT dbo.Test1 VALUES ('This is a test.');  
INSERT dbo.Test1 VALUES ('This is test 2.');  
SELECT HASHBYTES('SHA2_256', c1) FROM dbo.Test1;  

Este es el conjunto de resultados.

-------------------------------------------  
0x741238C01D9DB821CF171BF61D72260B998F7C7881D90091099945E0B9E0C2E3 
0x91DDCC41B761ACA928C62F7B0DA61DC763255E8247E0BD8DCE6B22205197154D  
(2 row(s) affected)