aes_decrypt
函数
适用于: Databricks SQL Databricks Runtime 10.4 LTS 及更高版本
对使用 AES 加密生成的二进制文件进行解密。
语法
aes_decrypt(expr, key [, mode [, padding [, aad]]])
参数
expr
:要解密的BINARY
表达式。key
:一个BINARY
表达式。 必须与最初用于生成加密值的密钥匹配,并且长度为 16、24 或 32 字节。mode
:一个可选的STRING
字符串表达式,描述用于生成加密值的加密模式。padding
:一个可选的STRING
表达式,描述加密如何将值填充到密钥长度。aad
:一个可选的STRING
表达式,在GCM
模式中提供经过身份验证的其他数据 (AAD)。 必须与用于生成加密值的aad
匹配。 适用于 Databricks SQL 和 Databricks Runtime 13.3 LTS 及更高版本。
返回
一个 BINARY。
mode
必须是下列项之一(不区分大小写):
'CBC'
:使用 Cipher-Block Chaining (CBC) 模式。 适用于 Databricks SQL、Databricks Runtime 13.3 LTS 及更高版本。'ECB'
:使用电子密码本 (ECB) 模式。'GCM'
:使用 Galois/计数器模式 (GCM)。 这是默认值。
padding
必须是下列项之一(不区分大小写):
'NONE'
:不使用填充。 仅对'GCM'
有效。'PKCS'
:使用公钥加密标准 (PKCS) 填充。 仅对'ECB'
和'CBC'
有效。'DEFAULT'
:将'NONE'
用于'GCM'
模式,将'PKCS'
用于'ECB'
和'CBC'
模式。
算法取决于密钥的长度:
16
:AES-12824
:AES-19232
:AES-256
若要容忍解密导致的任何错误情况并返回 NULL
,请改用 try_aes_decrypt
示例
> SELECT base64(aes_encrypt('Spark', 'abcdefghijklmnop'));
4A5jOAh9FNGwoMeuJukfllrLdHEZxA2DyuSQAWz77dfn
> SELECT cast(aes_decrypt(unbase64('4A5jOAh9FNGwoMeuJukfllrLdHEZxA2DyuSQAWz77dfn'),
'abcdefghijklmnop') AS STRING);
Spark
> SELECT base64(aes_encrypt('Spark SQL', '1234567890abcdef', 'ECB', 'PKCS'));
3lmwu+Mw0H3fi5NDvcu9lg==
> SELECT cast(aes_decrypt(unbase64('3lmwu+Mw0H3fi5NDvcu9lg=='),
'1234567890abcdef', 'ECB', 'PKCS') AS STRING);
Spark SQL
> SELECT base64(aes_encrypt('Spark SQL', '1234567890abcdef', 'GCM'));
2sXi+jZd/ws+qFC1Tnzvvde5lz+8Haryz9HHBiyrVohXUG7LHA==
> SELECT cast(aes_decrypt(unbase64('2sXi+jZd/ws+qFC1Tnzvvde5lz+8Haryz9HHBiyrVohXUG7LHA=='),
'1234567890abcdef', 'GCM') AS STRING);
Spark SQL
-- try_aes_decrypt tolerates an error where aes_decrypt does not.
> SELECT cast(aes_decrypt(x'1234567890abcdef1234567890abcdef', '1234567890abcdef', 'GCM') AS STRING);
Error: INVALID_PARAMETER_VALUE.AES_KEY
> SELECT cast(try_aes_decrypt(x'1234567890abcdef1234567890abcdef', '1234567890abcdef', 'GCM') AS STRING);
NULL
> SELECT base64(aes_encrypt('Apache Spark', '0000111122223333', 'CBC', 'PKCS'));
U2FsdGVkX1/ERGxwEOTDpDD4bQvDtQaNe+gXGudCcUk=
> SELECT cast(aes_decrypt(unbase64('OkzJi9oaiKJtTMmOrFjH2QWJZYF1UwT+4cA2008LlHA='), '0000111122223333', 'CBC', 'PKCS') AS STRING);
Apache Spark
> SELECT base64(aes_encrypt('Spark SQL', '1234567890abcdef', 'GCM', 'DEFAULT', '123456789012', 'Some AAD'));
MTIzNDU2Nzg5MDEyMdXvR41sJqwZ6hnTU8FRTTtXbL8yeChIZA==
> SELECT cast(aes_decrypt(unbase64('MTIzNDU2Nzg5MDEyMdXvR41sJqwZ6hnTU8FRTTtXbL8yeChIZA=='),
'1234567890abcdef', 'GCM', 'DEFAULT', 'Some AAD') AS STRING);
Spark SQL