Функция 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 прошедшие проверку подлинности дополнительные данные (AAD) в GCM режиме. Должен соответствовать используемому aad для создания зашифрованного значения. Применяется к Databricks SQL и Databricks Runtime 13.3 LTS и выше.

Возвраты

Значение BINARY.

mode должен быть одним из (без учета регистра):

  • 'CBC': используйте режим цепочки цепочки шифров (CBC). Применяется к Databricks SQL, Databricks Runtime 13.3 LTS и выше.
  • 'ECB': используйте режим электронной кодовой книги (Electronic CodeBook, ECB).
  • 'GCM': Используйте Режим Галуа / счетчик (Galois / Counter Mode, GCM). Это значение по умолчанию.

padding должен быть одним из (без учета регистра):

  • 'NONE': Не использует заполнение. Допустимо только для 'GCM'.
  • 'PKCS': использует заполнение по стандартам шифрования с открытым ключом (Public Key Cryptography Standards, PKCS). Допустимо только для 'ECB' и 'CBC'.
  • 'DEFAULT': используется 'NONE' для 'GCM' и 'PKCS''ECB' режима.'CBC'

Алгоритм зависит от длины ключа:

  • 16: AES-128
  • 24: AES-192
  • 32: 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
  • Last updated on