mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-10-20 23:41:01 +00:00
2d2bc052e1
* Typo fix. * Links fix. * Fixed links in docs. * More fixes. * docs/en: cleaning some files * docs/en: cleaning data_types * docs/en: cleaning database_engines * docs/en: cleaning development * docs/en: cleaning getting_started * docs/en: cleaning interfaces * docs/en: cleaning operations * docs/en: cleaning query_lamguage * docs/en: cleaning en * docs/ru: cleaning data_types * docs/ru: cleaning index * docs/ru: cleaning database_engines * docs/ru: cleaning development * docs/ru: cleaning general * docs/ru: cleaning getting_started * docs/ru: cleaning interfaces * docs/ru: cleaning operations * docs/ru: cleaning query_language * docs: cleaning interfaces/http * Update docs/en/data_types/array.md decorated ``` Co-Authored-By: BayoNet <da-daos@yandex.ru> * Update docs/en/getting_started/example_datasets/nyc_taxi.md fixed typo Co-Authored-By: BayoNet <da-daos@yandex.ru> * Update docs/en/getting_started/example_datasets/ontime.md fixed typo Co-Authored-By: BayoNet <da-daos@yandex.ru> * Update docs/en/interfaces/formats.md fixed error Co-Authored-By: BayoNet <da-daos@yandex.ru> * Update docs/en/operations/table_engines/custom_partitioning_key.md Co-Authored-By: BayoNet <da-daos@yandex.ru> * Update docs/en/operations/utils/clickhouse-local.md Co-Authored-By: BayoNet <da-daos@yandex.ru> * Update docs/en/query_language/dicts/external_dicts_dict_sources.md Co-Authored-By: BayoNet <da-daos@yandex.ru> * Update docs/en/operations/utils/clickhouse-local.md Co-Authored-By: BayoNet <da-daos@yandex.ru> * Update docs/en/query_language/functions/json_functions.md Co-Authored-By: BayoNet <da-daos@yandex.ru> * Update docs/en/query_language/functions/json_functions.md Co-Authored-By: BayoNet <da-daos@yandex.ru> * Update docs/en/query_language/functions/other_functions.md Co-Authored-By: BayoNet <da-daos@yandex.ru> * Update docs/en/query_language/functions/other_functions.md Co-Authored-By: BayoNet <da-daos@yandex.ru> * Update docs/en/query_language/functions/date_time_functions.md Co-Authored-By: BayoNet <da-daos@yandex.ru> * Update docs/en/operations/table_engines/jdbc.md Co-Authored-By: BayoNet <da-daos@yandex.ru> * docs: fixed error * docs: fixed error
56 lines
2.2 KiB
Markdown
56 lines
2.2 KiB
Markdown
# FixedString
|
|
|
|
A fixed-length string of `N` bytes (neither characters nor code points).
|
|
|
|
To declare a column of `FixedString` type, use the following syntax:
|
|
|
|
```sql
|
|
<column_name> FixedString(N)
|
|
```
|
|
|
|
Where `N` is a natural number.
|
|
|
|
The `FixedString` type is efficient when data has the length of precisely `N` bytes. In all other cases, it is likely to reduce efficiency.
|
|
|
|
Examples of the values that can be efficiently stored in `FixedString`-typed columns:
|
|
|
|
- Binary representation of IP addresses (`FixedString(16)` for IPv6).
|
|
- Language codes (ru_RU, en_US ... ).
|
|
- Currency codes (USD, RUB ... ).
|
|
- Binary representation of hashes (`FixedString(16)` for MD5, `FixedString(32)` for SHA256).
|
|
|
|
To store UUID values, use the [UUID](uuid.md) data type.
|
|
|
|
When inserting the data, ClickHouse:
|
|
|
|
- Complements a string with null bytes if the string contains fewer than `N` bytes.
|
|
- Throws the `Too large value for FixedString(N)` exception if the string contains more than `N` bytes.
|
|
|
|
When selecting the data, ClickHouse does not remove the null bytes at the end of the string. If you use the `WHERE` clause, you should add null bytes manually to match the `FixedString` value. The following example illustrates how to use the `WHERE` clause with `FixedString`.
|
|
|
|
Let's consider the following table with the single `FixedString(2)` column:
|
|
|
|
```text
|
|
┌─name──┐
|
|
│ b │
|
|
└───────┘
|
|
```
|
|
|
|
The query `SELECT * FROM FixedStringTable WHERE a = 'b'` does not return any data as a result. We should complement the filter pattern with null bytes.
|
|
|
|
```sql
|
|
SELECT * FROM FixedStringTable
|
|
WHERE a = 'b\0'
|
|
```
|
|
```text
|
|
┌─a─┐
|
|
│ b │
|
|
└───┘
|
|
```
|
|
|
|
This behavior differs from MySQL behavior for the `CHAR` type (where strings are padded with spaces, and the spaces are removed for output).
|
|
|
|
Note that the length of the `FixedString(N)` value is constant. The [length](../query_language/functions/array_functions.md#array_functions-length) function returns `N` even if the `FixedString(N)` value is filled only with null bytes, but the [empty](../query_language/functions/string_functions.md#string_functions-empty) function returns `1` in this case.
|
|
|
|
[Original article](https://clickhouse.yandex/docs/en/data_types/fixedstring/) <!--hide-->
|