pyspark.sql.functions.sha2#

pyspark.sql.functions.sha2(col, numBits)[source]#

Returns the hex string result of SHA-2 family of hash functions (SHA-224, SHA-256, SHA-384, and SHA-512). The numBits indicates the desired bit length of the result, which must have a value of 224, 256, 384, 512, or 0 (which is equivalent to 256).

New in version 1.5.0.

Changed in version 3.4.0: Supports Spark Connect.

Parameters
colColumn or column name

target column to compute on.

numBitsint

the desired bit length of the result, which must have a value of 224, 256, 384, 512, or 0 (which is equivalent to 256).

Returns
Column

the column for computed results.

Examples

>>> import pyspark.sql.functions as sf
>>> df = spark.createDataFrame([['Alice'], ['Bob']], ['name'])
>>> df.select('*', sf.sha2('name', 256)).show(truncate=False)
+-----+----------------------------------------------------------------+
|name |sha2(name, 256)                                                 |
+-----+----------------------------------------------------------------+
|Alice|3bc51062973c458d5a6f2d8d64a023246354ad7e064b1e4e009ec8a0699a3043|
|Bob  |cd9fb1e148ccd8442e5aa74904cc73bf6fb54d1d54d333bd596aa9bb4bb4e961|
+-----+----------------------------------------------------------------+