Funções para trabalhar com endereços IPv4 e IPv6

Documentação das funções usadas para trabalhar com endereços IPv4 e IPv6.

​

IPv4CIDRToRange

Introduzido em: v20.1.0

Recebe um endereço IPv4 com o comprimento do prefixo CIDR (Classless Inter-Domain Routing) e retorna o intervalo de endereços da sub-rede como uma tupla com dois valores IPv4: o primeiro e o último endereço dessa sub-rede. Para a versão IPv6, consulte IPv6CIDRToRange.

Sintaxe

IPv4CIDRToRange(ipv4, cidr)

Argumentos

• ipv4 — Endereço IPv4. IPv4 ou String
• cidr — Valor de CIDR. UInt8

Valor retornado

Retorna uma tupla com dois endereços IPv4 que representam o intervalo da sub-rede. Tuple(IPv4, IPv4)

Exemplos

Exemplo de uso

Query

SELECT IPv4CIDRToRange(toIPv4('192.168.5.2'), 16);

Response

┌─IPv4CIDRToRange(toIPv4('192.168.5.2'), 16)─┐
│ ('192.168.0.0','192.168.255.255')          │
└────────────────────────────────────────────┘

​

IPv4NumToString

Introduzido em: v1.1.0

Converte um inteiro de 32 bits em sua representação textual de endereço IPv4 na notação decimal pontuada (formato A.B.C.D). Interpreta a entrada usando a ordem de bytes big-endian.

Sintaxe

IPv4NumToString(num)

Aliases: INET_NTOA

Argumentos

• num — endereço IPv4 como um número UInt32. UInt32

Valor retornado

Retorna um número que representa o endereço MAC ou 0 se o formato for inválido. String

Exemplos

Exemplo de uso

Query

IPv4NumToString(3232235521)

Response

192.168.0.1

​

IPv4NumToStringClassC

Introduzido em: v1.1.0

Converte um inteiro de 32 bits em sua representação textual de endereço IPv4 na notação decimal pontuada (formato A.B.C.D), semelhante a IPv4NumToString, mas usando xxx em vez do último octeto.

Sintaxe

IPv4NumToStringClassC(num)

Argumentos

• num — endereço IPv4 como um número UInt32. UInt32

Valor retornado

Retorna a string do endereço IPv4 com xxx substituindo o último octeto. String

Exemplos

Exemplo básico com agregação

Query

SELECT
    IPv4NumToStringClassC(ClientIP) AS k,
    count() AS c
FROM test.hits
GROUP BY k
ORDER BY c DESC
LIMIT 10

Response

┌─k──────────────┬─────c─┐
│ 83.149.9.xxx   │ 26238 │
│ 217.118.81.xxx │ 26074 │
│ 213.87.129.xxx │ 25481 │
│ 83.149.8.xxx   │ 24984 │
│ 217.118.83.xxx │ 22797 │
│ 78.25.120.xxx  │ 22354 │
│ 213.87.131.xxx │ 21285 │
│ 78.25.121.xxx  │ 20887 │
│ 188.162.65.xxx │ 19694 │
│ 83.149.48.xxx  │ 17406 │
└────────────────┴───────┘

​

IPv4StringToNum

Introduzido em: v1.1.0

Converte uma string com um endereço IPv4 em notação decimal pontuada (formato A.B.C.D) para sua representação correspondente como um inteiro de 32 bits. (O inverso de IPv4NumToString). Se o endereço IPv4 tiver um formato inválido, uma exceção será lançada.

Sintaxe

IPv4StringToNum(string)

Aliases: INET_ATON

Argumentos

• string — Endereço IPv4 em formato de string. String

Valor retornado

Retorna o endereço IPv4. UInt32

Exemplos

Exemplo de uso

Query

IPv4StringToNum('192.168.0.1')

Response

3232235521

​

IPv4StringToNumOrDefault

Introduzido em: v22.3.0

Converte uma string com um endereço IPv4 em notação decimal pontuada (formato A.B.C.D) na representação inteira correspondente de 32 bits; porém, se o endereço IPv4 tiver um formato inválido, retorna 0.

Sintaxe

IPv4StringToNumOrDefault(string)

Argumentos

• string — Endereço IPv4 em formato de string. String

Valor retornado

Retorna o endereço IPv4 ou 0 se ele for inválido. UInt32

Exemplos

Exemplo com endereço inválido

Query

SELECT
    IPv4StringToNumOrDefault('127.0.0.1') AS valid,
    IPv4StringToNumOrDefault('invalid') AS invalid;

Response

┌──────valid─┬─invalid─┐
│ 2130706433 │       0 │
└────────────┴─────────┘

​

IPv4StringToNumOrNull

Introduzido em: v22.3.0

Converte um inteiro de 32 bits em sua representação textual de endereço IPv4 na notação decimal pontuada (formato A.B.C.D), mas, se o endereço IPv4 tiver um formato inválido, retorna NULL.

Sintaxe

IPv4StringToNumOrNull(string)

Argumentos

• string — Endereço IPv4 em formato de string. String

Valor retornado

Retorna o endereço IPv4 ou NULL se ele for inválido. Nullable(UInt32)

Exemplos

Exemplo com endereço inválido

Query

SELECT
IPv4StringToNumOrNull('127.0.0.1') AS valid,
IPv4StringToNumOrNull('invalid') AS invalid;

Response

┌──────valid─┬─invalid─┐
│ 2130706433 │    ᴺᵁᴸᴸ │
└────────────┴─────────┘

​

IPv4ToIPv6

Introduzido em: v1.1.0

Interpreta um número de 32 bits (big-endian) como um endereço IPv4, que depois é interpretado como o endereço IPv6 correspondente no formato FixedString(16).

Sintaxe

IPv4ToIPv6(x)

Argumentos

• x — Endereço IPv4. UInt32

Valor retornado

Retorna um endereço IPv6 em formato binário. FixedString(16)

Exemplos

Exemplo de uso

Query

SELECT IPv6NumToString(IPv4ToIPv6(IPv4StringToNum('192.168.0.1'))) AS addr;

Response

┌─addr───────────────┐
│ ::ffff:192.168.0.1 │
└────────────────────┘

​

IPv6CIDRToRange

Introduzido em: v20.1.0

Recebe um endereço IPv6 e o comprimento do prefixo CIDR (Classless Inter-Domain Routing) e retorna o intervalo de endereços da sub-rede como uma tupla de dois valores IPv6: o menor e o maior endereço dessa sub-rede. Para a versão IPv4, consulte IPv4CIDRToRange.

Sintaxe

IPv6CIDRToRange(ipv6, cidr)

Argumentos

• ipv6 — Endereço IPv6. IPv6 ou String
• cidr — Valor CIDR. UInt8

Valor retornado

Retorna uma tupla com dois endereços IPv6 que representam o intervalo da sub-rede. Tuple(IPv6, IPv6)

Exemplos

Exemplo de uso

Query

SELECT IPv6CIDRToRange(toIPv6('2001:0db8:0000:85a3:0000:0000:ac1f:8001'), 32);

Response

┌─IPv6CIDRToRange(toIPv6('2001:0db8:0000:85a3:0000:0000:ac1f:8001'), 32)─┐
│ ('2001:db8::','2001:db8:ffff:ffff:ffff:ffff:ffff:ffff')                │
└────────────────────────────────────────────────────────────────────────┘

​

IPv6NumToString

Introduzido em: v1.1.0

Converte um endereço IPv6 do formato binário (FixedString(16)) para sua representação padrão em texto. Endereços IPv6 mapeados para IPv4 são exibidos no formato ::ffff:111.222.33.44.

Sintaxe

IPv6NumToString(x)

Aliases: INET6_NTOA

Argumentos

• x — endereço IPv6 em formato binário. FixedString(16) ou IPv6

Valor retornado

Retorna o endereço IPv6 em formato de texto. String

Exemplos

Exemplo de uso

Query

SELECT IPv6NumToString(toFixedString(unhex('2A0206B8000000000000000000000011'), 16)) AS addr;

Response

┌─addr─────────┐
│ 2a02:6b8::11 │
└──────────────┘

Análise de IPv6 com a tabela hits

Query

SELECT
    IPv6NumToString(ClientIP6 AS k),
    count() AS c
FROM hits_all
WHERE EventDate = today() AND substring(ClientIP6, 1, 12) != unhex('00000000000000000000FFFF')
GROUP BY k
ORDER BY c DESC
LIMIT 10

Response

┌─IPv6NumToString(ClientIP6)──────────────┬─────c─┐
│ 2a02:2168:aaa:bbbb::2                   │ 24695 │
│ 2a02:2698:abcd:abcd:abcd:abcd:8888:5555 │ 22408 │
│ 2a02:6b8:0:fff::ff                      │ 16389 │
│ 2a01:4f8:111:6666::2                    │ 16016 │
│ 2a02:2168:888:222::1                    │ 15896 │
│ 2a01:7e00::ffff:ffff:ffff:222           │ 14774 │
│ 2a02:8109:eee:ee:eeee:eeee:eeee:eeee    │ 14443 │
│ 2a02:810b:8888:888:8888:8888:8888:8888  │ 14345 │
│ 2a02:6b8:0:444:4444:4444:4444:4444      │ 14279 │
│ 2a01:7e00::ffff:ffff:ffff:ffff          │ 13880 │
└─────────────────────────────────────────┴───────┘

Endereços IPv4 mapeados em IPv6

Query

SELECT
    IPv6NumToString(ClientIP6 AS k),
    count() AS c
FROM hits_all
WHERE EventDate = today()
GROUP BY k
ORDER BY c DESC
LIMIT 10

Response

┌─IPv6NumToString(ClientIP6)─┬──────c─┐
│ ::ffff:94.26.111.111       │ 747440 │
│ ::ffff:37.143.222.4        │ 529483 │
│ ::ffff:5.166.111.99        │ 317707 │
│ ::ffff:46.38.11.77         │ 263086 │
│ ::ffff:79.105.111.111      │ 186611 │
│ ::ffff:93.92.111.88        │ 176773 │
│ ::ffff:84.53.111.33        │ 158709 │
│ ::ffff:217.118.11.22       │ 154004 │
│ ::ffff:217.118.11.33       │ 148449 │
│ ::ffff:217.118.11.44       │ 148243 │
└────────────────────────────┴────────┘

​

IPv6StringToNum

Introduzido em: v1.1.0

Converte um endereço IPv6 da sua representação textual padrão para o formato binário (FixedString(16)). Aceita endereços IPv6 mapeado para IPv4 no formato ::ffff:111.222.33.44.. Se o endereço IPv6 tiver um formato inválido, uma exceção será lançada.

Se a string de entrada contiver um endereço IPv4 válido, retornará seu equivalente em IPv6. HEX pode estar em letras maiúsculas ou minúsculas.

Sintaxe

IPv6StringToNum(string)

Aliases: INET6_ATON

Argumentos

• string — Endereço IPv6 em formato de string. String

Valor retornado

Retorna o endereço IPv6 em formato binário. FixedString(16)

Exemplos

Exemplo básico

Query

SELECT addr, cutIPv6(IPv6StringToNum(addr), 0, 0) FROM (SELECT ['notaddress', '127.0.0.1', '1111::ffff'] AS addr) ARRAY JOIN addr;

Response

┌─addr───────┬─cutIPv6(IPv6StringToNum(addr), 0, 0)─┐
│ notaddress │ ::                                   │
│ 127.0.0.1  │ ::ffff:127.0.0.1                     │
│ 1111::ffff │ 1111::ffff                           │
└────────────┴──────────────────────────────────────┘

​

IPv6StringToNumOrDefault

Introduzido na versão: v22.3.0

Converte um endereço IPv6 de sua representação textual padrão para o formato binário (FixedString(16)). Aceita endereços IPv6 mapeado para IPv4 no formato ::ffff:111.222.33.44.. Se o endereço IPv6 tiver um formato inválido, retorna o valor padrão ::.

Sintaxe

IPv6StringToNumOrDefault(string)

Argumentos

• string — Endereço IPv6 em formato de string. String

Valor retornado

Endereço IPv6 em formato binário ou FixedString(16) preenchido com zeros se for inválido. FixedString(16)

Exemplos

Exemplo básico com endereço inválido

Query

SELECT
    IPv6NumToString(IPv6StringToNumOrDefault('2001:db8::1')) AS valid,
    IPv6NumToString(IPv6StringToNumOrDefault('invalid')) AS invalid;

Response

┌─valid───────┬─invalid─┐
│ 2001:db8::1 │ ::      │
└─────────────┴─────────┘

​

IPv6StringToNumOrNull

Introduzido em: v22.3.0

Converte um endereço IPv6 da sua representação textual padrão para o formato binário (FixedString(16)). Aceita endereços IPv6 mapeados para IPv4 no formato ::ffff:111.222.33.44.. Se o endereço IPv6 tiver um formato inválido, retorna NULL.

Sintaxe

IPv6StringToNumOrNull(string)

Argumentos

• string — Endereço IPv6 em formato de string. String

Valor retornado

Retorna o endereço IPv6 em formato binário ou NULL se for inválido. Nullable(FixedString(16))

Exemplos

Exemplo básico com endereço inválido

Query

SELECT
    IPv6NumToString(IPv6StringToNumOrNull('2001:db8::1')) AS valid,
    IPv6StringToNumOrNull('invalid') AS invalid;

Response

┌─valid───────┬─invalid─┐
│ 2001:db8::1 │    ᴺᵁᴸᴸ │
└─────────────┴─────────┘

​

cutIPv6

Introduzido em: v1.1.0

Aceita um valor FixedString(16) que contém o endereço IPv6 em formato binário. Retorna uma string contendo o endereço com a quantidade especificada de bytes removidos, em formato de texto.

Sintaxe

cutIPv6(x, bytesToCutForIPv6, bytesToCutForIPv4)

Argumentos

• x — Endereço IPv6 em formato binário. FixedString(16) ou IPv6
• bytesToCutForIPv6 — Número de bytes a remover para IPv6. UInt8
• bytesToCutForIPv4 — Número de bytes a remover para IPv4. UInt8

Valor retornado

Retorna uma string que contém o endereço IPv6 em formato de texto com os bytes especificados removidos. String

Exemplos

Exemplo de uso

Query

WITH
    IPv6StringToNum('2001:0DB8:AC10:FE01:FEED:BABE:CAFE:F00D') AS ipv6,
    IPv4ToIPv6(IPv4StringToNum('192.168.0.1')) AS ipv4
SELECT
    cutIPv6(ipv6, 2, 0),
    cutIPv6(ipv4, 0, 2)

Response

┌─cutIPv6(ipv6, 2, 0)─────────────────┬─cutIPv6(ipv4, 0, 2)─┐
│ 2001:db8:ac10:fe01:feed:babe:cafe:0 │ ::ffff:192.168.0.0  │
└─────────────────────────────────────┴─────────────────────┘

​

isIPAddressInRange

Introduzido na versão: v21.4.0

Determina se um endereço IP está contido em uma rede representada na notação Classless Inter-Domain Routing (CIDR).

Esta função aceita endereços IPv4 e IPv6 (e redes) representados como strings. Ela retorna 0 se a versão de IP do endereço e a do CIDR não corresponderem.

Sintaxe

isIPAddressInRange(address, prefix)

Argumentos

• address — Um endereço IPv4 ou IPv6. String
• prefix — Um prefixo de rede IPv4 ou IPv6 em CIDR. String

Valor retornado

Retorna 1 se a versão IP do endereço corresponder à do CIDR; caso contrário, 0. UInt8

Exemplos

Endereço IPv4 no intervalo

Query

SELECT isIPAddressInRange('127.0.0.1', '127.0.0.0/8')

Response

1

Endereço IPv4 fora do intervalo

Query

SELECT isIPAddressInRange('127.0.0.1', 'ffff::/16')

Response

0

Endereço IPv6 fora da faixa

Query

SELECT isIPAddressInRange('::ffff:192.168.0.1', '::ffff:192.168.0.4/128')

Response

0

​

isIPv4String

Introduzido na versão: v21.1.0

Determina se a string de entrada é ou não um endereço IPv4. Para a versão IPv6, consulte isIPv6String.

Sintaxe

isIPv4String(string)

Argumentos

• string — texto com o endereço IP a ser verificado. String

Valor retornado

Retorna 1 se string for um endereço IPv4; caso contrário, 0. UInt8

Exemplos

Exemplo de uso

Query

SELECT addr, isIPv4String(addr)
FROM(
SELECT ['0.0.0.0', '127.0.0.1', '::ffff:127.0.0.1'] AS addr
)
ARRAY JOIN addr;

Response

┌─addr─────────────┬─isIPv4String(addr)─┐
│ 0.0.0.0          │                  1 │
│ 127.0.0.1        │                  1 │
│ ::ffff:127.0.0.1 │                  0 │
└──────────────────┴────────────────────┘

​

isIPv6String

Introduzido em: v21.1.0

Determina se a string de entrada é um endereço IPv6. Para a versão IPv4, consulte isIPv4String.

Sintaxe

isIPv6String(string)

Argumentos

• string — String com o endereço IP a ser verificado. String

Valor retornado

Retorna 1 se string for um endereço IPv6; caso contrário, 0. UInt8

Exemplos

Exemplo de uso

Query

SELECT addr, isIPv6String(addr)
FROM(SELECT ['::', '1111::ffff', '::ffff:127.0.0.1', '127.0.0.1'] AS addr)
ARRAY JOIN addr;

Response

┌─addr─────────────┬─isIPv6String(addr)─┐
│ ::               │                  1 │
│ 1111::ffff       │                  1 │
│ ::ffff:127.0.0.1 │                  1 │
│ 127.0.0.1        │                  0 │
└──────────────────┴────────────────────┘

​

toIPv4

Introduzido em: v20.1.0

Converte uma string ou um endereço IPv4 na forma UInt32 para o tipo IPv4. É semelhante às funções IPv4StringToNum e IPv4NumToString, mas aceita como argumentos de entrada tanto tipos de dados string quanto inteiros sem sinal.

Sintaxe

toIPv4(x)

Argumentos

• x — Um endereço IPv4 String ou UInt8/16/32

Valor retornado

Retorna um endereço IPv4. IPv4

Exemplos

Exemplo de uso

Query

SELECT toIPv4('171.225.130.45');

Response

┌─toIPv4('171.225.130.45')─┐
│ 171.225.130.45           │
└──────────────────────────┘

Comparação com as funções IPv4StringToNum e IPv4NumToString.

Query

WITH
    '171.225.130.45' AS IPv4_string
SELECT
    hex(IPv4StringToNum(IPv4_string)),
    hex(toIPv4(IPv4_string))

Response

┌─hex(IPv4StringToNum(IPv4_string))─┬─hex(toIPv4(IPv4_string))─┐
│ ABE1822D                          │ ABE1822D                 │
└───────────────────────────────────┴──────────────────────────┘

Conversão a partir de um inteiro

Query

SELECT toIPv4(2130706433);

Response

┌─toIPv4(2130706433)─┐
│ 127.0.0.1          │
└────────────────────┘

​

toIPv4OrDefault

Introduzido em: v22.3.0

Converte uma string ou um valor UInt32 de um endereço IPv4 para o tipo IPv4. Se o endereço IPv4 tiver um formato inválido, retorna 0.0.0.0 (IPv4 0) ou o valor IPv4 padrão fornecido.

Sintaxe

toIPv4OrDefault(string[, default])

Argumentos

• string — String com o endereço IP a ser convertido. String
• default — Opcional. O valor a ser retornado se string for um endereço IPv4 inválido. IPv4

Valor retornado

Retorna o endereço IPv4 correspondente à string, ou o valor padrão se a conversão falhar. IPv4

Exemplos

Strings IPv4 válidas e inválidas

Query

WITH
    '192.168.1.1' AS valid_IPv4_string,
    '999.999.999.999' AS invalid_IPv4_string,
    'not_an_ip' AS malformed_string
SELECT
    toIPv4OrDefault(valid_IPv4_string) AS valid,
    toIPv4OrDefault(invalid_IPv4_string) AS default_value,
    toIPv4OrDefault(malformed_string, toIPv4('8.8.8.8')) AS provided_default;

Response

┌─valid─────────┬─default_value─┬─provided_default─┐
│ 192.168.1.1   │ 0.0.0.0       │ 8.8.8.8          │
└───────────────┴───────────────┴──────────────────┘

​

toIPv4OrNull

Introduzido em: v22.3.0

Converte um valor de entrada em um valor do tipo IPv4, mas retorna NULL em caso de erro. Como toIPv4, mas retorna NULL em vez de lançar uma exceção em caso de erro de conversão.

Argumentos suportados:

• Representações em string de endereços IPv4 na notação decimal pontuada.
• Representações inteiras de endereços IPv4.

Argumentos não suportados (retornam NULL):

• Formatos de endereço IP inválidos.
• Endereços IPv6.
• Valores fora do intervalo.
• Endereços malformados.

Sintaxe

toIPv4OrNull(x)

Argumentos

• x — Uma representação de um endereço IPv4 em formato de string ou inteiro. String ou Integer

Valor retornado

Retorna um endereço IPv4 em caso de sucesso; caso contrário, NULL. IPv4 ou NULL

Exemplos

Exemplo de uso

Query

SELECT
    toIPv4OrNull('192.168.1.1') AS valid_ip,
    toIPv4OrNull('invalid.ip') AS invalid_ip

Response

┌─valid_ip────┬─invalid_ip─┐
│ 192.168.1.1 │       ᴺᵁᴸᴸ │
└─────────────┴────────────┘

​

toIPv4OrZero

Introduzido em: v23.1.0

Converte um valor de entrada em um valor do tipo IPv4, mas retorna o endereço IPv4 zero em caso de erro. Semelhante a toIPv4, mas retorna o endereço IPv4 zero (0.0.0.0) em vez de lançar uma exceção em caso de erro de conversão.

Argumentos compatíveis:

• Representações de endereços IPv4 em formato String na notação decimal pontuada.
• Representações inteiras de endereços IPv4.

Argumentos não compatíveis (retornam IPv4 zero):

• Formatos de endereço IP inválidos.
• Endereços IPv6.
• Valores fora do intervalo.

Sintaxe

toIPv4OrZero(x)

Argumentos

• x — Uma representação de um endereço IPv4 em string ou inteiro. String ou Integer

Valor retornado

Retorna um endereço IPv4 em caso de sucesso; caso contrário, retorna o endereço IPv4 zero (0.0.0.0). IPv4

Exemplos

Exemplo de uso

Query

SELECT
    toIPv4OrZero('192.168.1.1') AS valid_ip,
    toIPv4OrZero('invalid.ip') AS invalid_ip

Response

┌─valid_ip────┬─invalid_ip─┐
│ 192.168.1.1 │ 0.0.0.0    │
└─────────────┴────────────┘

​

toIPv6

Introduzido em: v20.1.0

Converte uma string ou um endereço IPv6 na forma UInt128 para o tipo IPv6. No caso de strings, se o endereço IPv6 tiver um formato inválido, retorna um valor vazio. Semelhante às funções IPv6StringToNum e IPv6NumToString, que convertem endereços IPv6 de e para o formato binário (ou seja, FixedString(16)).

Se a string de entrada contiver um endereço IPv4 válido, o equivalente em IPv6 desse endereço IPv4 será retornado.

Sintaxe

toIPv6(x)

Argumentos

• x — Um endereço IP. String ou UInt128

Valor retornado

Retorna um endereço IPv6. IPv6

Exemplos

Exemplo de uso

Query

WITH '2001:438:ffff::407d:1bc1' AS IPv6_string
SELECT
    hex(IPv6StringToNum(IPv6_string)),
    hex(toIPv6(IPv6_string));

Response

┌─hex(IPv6StringToNum(IPv6_string))─┬─hex(toIPv6(IPv6_string))─────────┐
│ 20010438FFFF000000000000407D1BC1  │ 20010438FFFF000000000000407D1BC1 │
└───────────────────────────────────┴──────────────────────────────────┘

Mapeamento de IPv4 para IPv6

Query

SELECT toIPv6('127.0.0.1');

Response

┌─toIPv6('127.0.0.1')─┐
│ ::ffff:127.0.0.1    │
└─────────────────────┘

​

toIPv6OrDefault

Introduzido em: v22.3.0

Converte uma string ou um endereço IPv6 no formato UInt128 para o tipo IPv6. Se o endereço IPv6 tiver um formato inválido, retorna :: (IPv6 0) ou o valor padrão de IPv6 fornecido.

Sintaxe

toIPv6OrDefault(string[, default])

Argumentos

• string — Endereço IP em formato de string a ser convertido. - default — Opcional. O valor a ser retornado se a string tiver um formato inválido.

Valor retornado

Retorna o endereço IPv6; caso contrário, :: ou o valor padrão opcional fornecido se o argumento string tiver um formato inválido. IPv6

Exemplos

Strings IPv6 válidas e inválidas

Query

WITH
    '2001:0db8:85a3:0000:0000:8a2e:0370:7334' AS valid_IPv6_string,
    '2001:0db8:85a3::8a2e:370g:7334' AS invalid_IPv6_string,
    'not_an_ipv6' AS malformed_string
SELECT
    toIPv6OrDefault(valid_IPv6_string) AS valid,
    toIPv6OrDefault(invalid_IPv6_string) AS default_value,
    toIPv6OrDefault(malformed_string, toIPv6('::1')) AS provided_default;

Response

┌─valid──────────────────────────────────┬─default_value─┬─provided_default─┐
│ 2001:db8:85a3::8a2e:370:7334           │ ::            │ ::1              │
└────────────────────────────────────────┴───────────────┴──────────────────┘

​

toIPv6OrNull

Introduzido em: v22.3.0

Converte um valor de entrada em um valor do tipo IPv6, mas retorna NULL em caso de erro. Como toIPv6, mas retorna NULL em vez de lançar uma exceção em caso de erro de conversão.

Argumentos suportados:

• Representações em string de endereços IPv6 na notação padrão.
• Representações em string de endereços IPv4 (convertidos para IPv6 mapeado para IPv4).
• Representações binárias de endereços IPv6.

Argumentos não suportados (retornam NULL):

• Formatos de endereço IP inválidos.
• Endereços IPv6 malformados.
• Valores fora do intervalo.
• Notação inválida.

Sintaxe

toIPv6OrNull(x)

Argumentos

• x — Uma representação textual de um endereço IPv6 ou IPv4. String

Valor retornado

Retorna um endereço IPv6 em caso de sucesso; caso contrário, NULL. IPv6 ou NULL

Exemplos

Exemplo de uso

Query

SELECT
    toIPv6OrNull('2001:0db8:85a3:0000:0000:8a2e:0370:7334') AS valid_ipv6,
    toIPv6OrNull('invalid::ip') AS invalid_ipv6

Response

┌─valid_ipv6──────────────────────────┬─invalid_ipv6─┐
│ 2001:db8:85a3::8a2e:370:7334        │         ᴺᵁᴸᴸ │
└─────────────────────────────────────┴──────────────┘

​

toIPv6OrZero

Introduzido em: v23.1.0

Converte um valor de entrada em um valor do tipo IPv6, mas retorna o endereço IPv6 zero em caso de erro. Como toIPv6, mas retorna o endereço IPv6 zero (::) em vez de lançar uma exceção em caso de erro de conversão.

Argumentos aceitos:

• Representações em string de endereços IPv6 na notação padrão.
• Representações em string de endereços IPv4 (convertidos em IPv6 mapeado para IPv4).
• Representações binárias de endereços IPv6.

Argumentos não aceitos (retornam IPv6 zero):

• Formatos de endereço IP inválidos.
• Endereços IPv6 malformados.
• Valores fora do intervalo.

Sintaxe

toIPv6OrZero(x)

Argumentos

• x — A representação em string de um endereço IPv6 ou IPv4. String

Valor retornado

Retorna um endereço IPv6 em caso de sucesso; caso contrário, retorna o endereço IPv6 nulo (::). IPv6

Exemplos

Exemplo de uso

Query

SELECT
    toIPv6OrZero('2001:0db8:85a3:0000:0000:8a2e:0370:7334') AS valid_ipv6,
    toIPv6OrZero('invalid::ip') AS invalid_ipv6

Response

┌─valid_ipv6──────────────────────────┬─invalid_ipv6─┐
│ 2001:db8:85a3::8a2e:370:7334        │ ::           │
└─────────────────────────────────────┴──────────────┘