mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-10-19 23:10:50 +00:00
2e1f6bc56d
* replace exit with assert in test_single_page * improve save_raw_single_page docs option * More grammar fixes * "Built from" link in new tab * fix mistype * Example of include in docs * add anchor to meeting form * Draft of translation helper * WIP on translation helper * Replace some fa docs content with machine translation * add normalize-en-markdown.sh * normalize some en markdown * normalize some en markdown * admonition support * normalize * normalize * normalize * support wide tables * normalize * normalize * normalize * normalize * normalize * normalize * normalize * normalize * normalize * normalize * normalize * normalize * normalize * lightly edited machine translation of introdpection.md * lightly edited machhine translation of lazy.md * WIP on translation utils * Normalize ru docs * Normalize other languages * some fixes * WIP on normalize/translate tools * add requirements.txt * [experimental] add es docs language as machine translated draft * remove duplicate script * Back to wider tab-stop (narrow renders not so well)
57 lines
3.4 KiB
Markdown
57 lines
3.4 KiB
Markdown
# FixedString {#fixedstring}
|
||
|
||
Строка фиксированной длины `N` байт (не символов, не кодовых точек).
|
||
|
||
Чтобы объявить столбец типа `FixedString`, используйте следующий синтаксис:
|
||
|
||
``` sql
|
||
<column_name> FixedString(N)
|
||
```
|
||
|
||
Где `N` — натуральное число.
|
||
|
||
Тип `FixedString` эффективен, когда данные имеют длину ровно `N` байт. Во всех остальных случаях использование FixedString может привести к снижению эффективности.
|
||
|
||
Примеры значений, которые можно эффективно хранить в столбцах типа `FixedString`:
|
||
|
||
- Двоичное представление IP-адреса (`FixedString(16)` для IPv6).
|
||
- Коды языков (ru\_RU, en\_US … ).
|
||
- Коды валют (USD, RUB … ).
|
||
- Двоичное представление хэшей (`FixedString(16)` для MD5, `FixedString(32)` для SHA256).
|
||
|
||
Для хранения значений UUID используйте тип данных [UUID](uuid.md).
|
||
|
||
При вставке данных, ClickHouse:
|
||
|
||
- Дополняет строку нулевыми байтами, если строка содержит меньше байтов, чем `N`.
|
||
- Генерирует исключение `Too large value for FixedString(N)`, если строка содержит более `N` байт.
|
||
|
||
При выборе данных ClickHouse не обрезает нулевые байты в конце строки. Если вы используете секцию `WHERE`, то необходимо добавлять нулевые байты вручную, чтобы ClickHouse смог сопоставить выражение из фильтра значению `FixedString`. Следующий пример показывает, как использовать секцию `WHERE` с `FixedString`.
|
||
|
||
Рассмотрим следующую таблицу с единственным столбцом типа `FixedString(2)`:
|
||
|
||
``` text
|
||
┌─name──┐
|
||
│ b │
|
||
└───────┘
|
||
```
|
||
|
||
Запрос `SELECT * FROM FixedStringTable WHERE a = 'b'` не возвращает необходимых данных. Необходимо дополнить шаблон фильтра нулевыми байтами.
|
||
|
||
``` sql
|
||
SELECT * FROM FixedStringTable
|
||
WHERE a = 'b\0'
|
||
```
|
||
|
||
``` text
|
||
┌─a─┐
|
||
│ b │
|
||
└───┘
|
||
```
|
||
|
||
Это поведение отличается от поведения MySQL для типа `CHAR`, где строки дополняются пробелами, а пробелы перед выводом вырезаются.
|
||
|
||
Обратите внимание, что длина значения `FixedString(N)` постоянна. Функция [length](../query_language/functions/array_functions.md#array_functions-length) возвращает `N` даже если значение `FixedString(N)` заполнено только нулевыми байтами, однако функция [empty](../query_language/functions/string_functions.md#empty) в этом же случае возвращает `1`.
|
||
|
||
[Оригинальная статья](https://clickhouse.tech/docs/ru/data_types/fixedstring/) <!--hide-->
|