2020-03-20 18:20:59 +00:00
## IPv4 {#ipv4}
2019-06-14 12:44:33 +00:00
`IPv4` — это домен, базирующийся на типе данных `UInt32` предназначенный для хранения адресов IPv4. Он обеспечивает компактное хранение данных с удобным для человека форматом ввода-вывода, и явно отображаемым типом данных в структуре таблицы.
2020-03-20 18:20:59 +00:00
### Применение {#primenenie}
2019-06-14 12:44:33 +00:00
2020-03-20 18:20:59 +00:00
``` sql
2019-06-14 12:44:33 +00:00
CREATE TABLE hits (url String, from IPv4) ENGINE = MergeTree() ORDER BY url;
DESCRIBE TABLE hits;
```
2020-03-20 18:20:59 +00:00
``` text
2019-06-14 12:44:33 +00:00
┌─name─┬─type───┬─default_type─┬─default_expression─┬─comment─┬─codec_expression─┐
│ url │ String │ │ │ │ │
│ from │ IPv4 │ │ │ │ │
└──────┴────────┴──────────────┴────────────────────┴─────────┴──────────────────┘
```
Или вы можете использовать домен IPv4 в качестве ключа:
2020-03-20 18:20:59 +00:00
``` sql
2019-06-14 12:44:33 +00:00
CREATE TABLE hits (url String, from IPv4) ENGINE = MergeTree() ORDER BY from;
```
`IPv4` поддерживает вставку в виде строк с текстовым представлением IPv4 адреса:
2020-03-20 18:20:59 +00:00
``` sql
2020-01-30 10:34:55 +00:00
INSERT INTO hits (url, from) VALUES ('https://wikipedia.org', '116.253.40.133')('https://clickhouse.tech', '183.247.232.58')('https://clickhouse.yandex/docs/en/', '116.106.34.242');
2019-06-14 12:44:33 +00:00
SELECT * FROM hits;
```
2020-03-20 18:20:59 +00:00
``` text
2019-06-14 12:44:33 +00:00
┌─url────────────────────────────────┬───────────from─┐
2020-01-30 10:34:55 +00:00
│ https://clickhouse.tech/docs/en/ │ 116.106.34.242 │
2019-06-14 12:44:33 +00:00
│ https://wikipedia.org │ 116.253.40.133 │
2020-01-30 10:34:55 +00:00
│ https://clickhouse.tech │ 183.247.232.58 │
2019-06-14 12:44:33 +00:00
└────────────────────────────────────┴────────────────┘
```
Значения хранятся в компактной бинарной форме:
2020-03-20 18:20:59 +00:00
``` sql
2019-06-14 12:44:33 +00:00
SELECT toTypeName(from), hex(from) FROM hits LIMIT 1;
```
2020-03-20 18:20:59 +00:00
``` text
2019-06-14 12:44:33 +00:00
┌─toTypeName(from)─┬─hex(from)─┐
│ IPv4 │ B7F7E83A │
└──────────────────┴───────────┘
```
Значения с доменным типом данных не преобразуются неявно в другие типы данных, кроме `UInt32` .
Если необходимо преобразовать значение типа `IPv4` в строку, то это необходимо делать явно с помощью функции `IPv4NumToString()` :
2020-03-20 18:20:59 +00:00
``` sql
2019-06-14 12:44:33 +00:00
SELECT toTypeName(s), IPv4NumToString(from) AS s FROM hits LIMIT 1;
```
2020-03-20 18:20:59 +00:00
``` text
2019-06-14 12:44:33 +00:00
┌─toTypeName(IPv4NumToString(from))─┬─s──────────────┐
│ String │ 183.247.232.58 │
└───────────────────────────────────┴────────────────┘
```
Или приводить к типу данных `UInt32` :
2020-03-20 18:20:59 +00:00
``` sql
2019-06-14 12:44:33 +00:00
SELECT toTypeName(i), CAST(from AS UInt32) AS i FROM hits LIMIT 1;
```
2020-03-20 18:20:59 +00:00
``` text
2019-06-14 12:44:33 +00:00
┌─toTypeName(CAST(from, 'UInt32'))─┬──────────i─┐
│ UInt32 │ 3086477370 │
└──────────────────────────────────┴────────────┘
```
2020-01-30 10:34:55 +00:00
[Оригинальная статья ](https://clickhouse.tech/docs/ru/data_types/domains/ipv4 ) <!--hide-->