Update hash-functions.md

Add ru translation.
This commit is contained in:
romanzhukov 2021-09-29 19:55:11 +03:00
parent b226429435
commit 02205492e5

View File

@ -139,16 +139,120 @@ SELECT groupBitXor(cityHash64(*)) FROM table
## SHA1 {#sha1}
Вычисляет SHA-1 хеш строки и возвращает полученный набор байт в виде [FixedString(20)](../data-types/fixedstring.md).
**Синтаксис**
``` sql
SHA1('s')
```
**Параметры**
- `s` — входная строка для вычисления хеша SHA-1. [String](../data-types/string.md).
**Возвращаемое значение**
- Хеш SHA-1 в виде шестнадцатеричной некодированной строки FixedString(20).
Тип: [FixedString](../data-types/fixedstring.md).
**Пример**
Используйте функцию [hex](../functions/encoding-functions.md#hex) для представления результата в виде строки с шестнадцатеричной кодировкой.
Запрос:
``` sql
SELECT hex(SHA1('abc'));
```
Результат:
``` text
┌─hex(SHA1('abc'))─────────────────────────┐
│ A9993E364706816ABA3E25717850C26C9CD0D89D │
└──────────────────────────────────────────┘
```
## SHA224 {#sha224}
Вычисляет SHA-224 хеш строки и возвращает полученный набор байт в виде [FixedString(28)](../data-types/fixedstring.md).
**Синтаксис**
``` sql
SHA224('s')
```
**Параметры**
- `s` — входная строка для вычисления хеша SHA-224. [String](../data-types/string.md).
**Возвращаемое значение**
- Хеш SHA-224 в виде шестнадцатеричной некодированной строки FixedString(28).
Тип: [FixedString](../data-types/fixedstring.md).
**Пример**
Используйте функцию [hex](../functions/encoding-functions.md#hex) для представления результата в виде строки с шестнадцатеричной кодировкой.
Запрос:
``` sql
SELECT hex(SHA224('abc'));
```
Результат:
``` text
┌─hex(SHA224('abc'))───────────────────────────────────────┐
│ 23097D223405D8228642A477BDA255B32AADBCE4BDA0B3F7E36C9DA7 │
└──────────────────────────────────────────────────────────┘
```
## SHA256 {#sha256}
Вычисляет SHA-256 хеш строки и возвращает полученный набор байт в виде [FixedString(32)](../data-types/fixedstring.md).
**Синтаксис**
``` sql
SHA256('s')
```
**Параметры**
- `s` — входная строка для вычисления хеша SHA-256. [String](../data-types/string.md).
**Возвращаемое значение**
- Хеш SHA-256 в виде шестнадцатеричной некодированной строки FixedString(32).
Тип: [FixedString](../data-types/fixedstring.md).
**Пример**
Используйте функцию [hex](../functions/encoding-functions.md#hex) для представления результата в виде строки с шестнадцатеричной кодировкой.
Запрос:
``` sql
SELECT hex(SHA256('abc'));
```
Результат:
``` text
┌─hex(SHA256('abc'))───────────────────────────────────────────────┐
│ BA7816BF8F01CFEA414140DE5DAE2223B00361A396177A9CB410FF61F20015AD │
└──────────────────────────────────────────────────────────────────┘
```
## SHA512 {#sha512}
Вычисляет SHA-1, SHA-224, SHA-256 хеш строки и возвращает полученный набор байт в виде FixedString(20), FixedString(28), FixedString(32), [FixedString(64)](../data-types/fixedstring.md)
Вычисляет SHA-512 хеш строки и возвращает полученный набор байт в виде [FixedString(64)](../data-types/fixedstring.md)
**Синтаксис**
@ -157,7 +261,7 @@ SELECT groupBitXor(cityHash64(*)) FROM table
SHA512('s')
```
Функция работает достаточно медленно (SHA-1 - примерно 5 миллионов коротких строк в секунду на одном процессорном ядре, SHA-224 и SHA-256 - примерно 2.2 миллионов).
Функция работает достаточно медленно (SHA-1 примерно 5 миллионов коротких строк в секунду на одном процессорном ядре, SHA-224 и SHA-256 примерно 2.2 миллионов).
Рекомендуется использовать эти функции лишь в тех случаях, когда вам нужна конкретная хэш-функция и вы не можете её выбрать.
Даже в этих случаях, рекомендуется применять функцию оффлайн - заранее вычисляя значения при вставке в таблицу, вместо того, чтобы применять её при выполнении `SELECT`.