mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-10-22 16:30:49 +00:00
80 lines
3.6 KiB
Markdown
80 lines
3.6 KiB
Markdown
|
## IPv6
|
|||
|
|
|||
|
`IPv6` is a domain based on `FixedString(16)` type and serves as typed replacement for storing IPv6 values. It provides compact storage with human-friendly input-output format, and column type information on inspection.
|
|||
|
|
|||
|
### Basic Usage
|
|||
|
|
|||
|
``` sql
|
|||
|
CREATE TABLE hits (url String, from IPv6) ENGINE = MergeTree() ORDER BY url;
|
|||
|
|
|||
|
DESCRIBE TABLE hits;
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
┌─name─┬─type───┬─default_type─┬─default_expression─┬─comment─┬─codec_expression─┐
|
|||
|
│ url │ String │ │ │ │ │
|
|||
|
│ from │ IPv6 │ │ │ │ │
|
|||
|
└──────┴────────┴──────────────┴────────────────────┴─────────┴──────────────────┘
|
|||
|
```
|
|||
|
|
|||
|
OR you can use `IPv6` domain as a key:
|
|||
|
|
|||
|
``` sql
|
|||
|
CREATE TABLE hits (url String, from IPv6) ENGINE = MergeTree() ORDER BY from;
|
|||
|
```
|
|||
|
|
|||
|
`IPv6` domain supports custom input as IPv6-strings:
|
|||
|
|
|||
|
``` sql
|
|||
|
INSERT INTO hits (url, from) VALUES ('https://wikipedia.org', '2a02:aa08:e000:3100::2')('https://clickhouse.yandex', '2001:44c8:129:2632:33:0:252:2')('https://clickhouse.yandex/docs/en/', '2a02:e980:1e::1');
|
|||
|
|
|||
|
SELECT * FROM hits;
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
┌─url────────────────────────────────┬─from──────────────────────────┐
|
|||
|
│ https://clickhouse.yandex │ 2001:44c8:129:2632:33:0:252:2 │
|
|||
|
│ https://clickhouse.yandex/docs/en/ │ 2a02:e980:1e::1 │
|
|||
|
│ https://wikipedia.org │ 2a02:aa08:e000:3100::2 │
|
|||
|
└────────────────────────────────────┴───────────────────────────────┘
|
|||
|
```
|
|||
|
|
|||
|
Values are stored in compact binary form:
|
|||
|
|
|||
|
``` sql
|
|||
|
SELECT toTypeName(from), hex(from) FROM hits LIMIT 1;
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
┌─toTypeName(from)─┬─hex(from)────────────────────────┐
|
|||
|
│ IPv6 │ 200144C8012926320033000002520002 │
|
|||
|
└──────────────────┴──────────────────────────────────┘
|
|||
|
```
|
|||
|
|
|||
|
Domain values are not implicitly convertible to types other than `FixedString(16)`.
|
|||
|
If you want to convert `IPv6` value to a string, you have to do that explicitly with `IPv6NumToString()` function:
|
|||
|
|
|||
|
``` sql
|
|||
|
SELECT toTypeName(s), IPv6NumToString(from) as s FROM hits LIMIT 1;
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
┌─toTypeName(IPv6NumToString(from))─┬─s─────────────────────────────┐
|
|||
|
│ String │ 2001:44c8:129:2632:33:0:252:2 │
|
|||
|
└───────────────────────────────────┴───────────────────────────────┘
|
|||
|
```
|
|||
|
|
|||
|
Or cast to a `FixedString(16)` value:
|
|||
|
|
|||
|
``` sql
|
|||
|
SELECT toTypeName(i), CAST(from as FixedString(16)) as i FROM hits LIMIT 1;
|
|||
|
```
|
|||
|
|
|||
|
```
|
|||
|
┌─toTypeName(CAST(from, 'FixedString(16)'))─┬─i───────┐
|
|||
|
│ FixedString(16) │ <20><><EFBFBD> │
|
|||
|
└───────────────────────────────────────────┴─────────┘
|
|||
|
```
|
|||
|
|
|||
|
[Original article](https://clickhouse.yandex/docs/en/data_types/domains/ipv6) <!--hide-->
|