Funciones para trabajar con direcciones IPv4 e IPv6

Documentación sobre las funciones para trabajar con direcciones IPv4 e IPv6.

​

IPv4CIDRToRange

Introducido en: v20.1.0

Toma una dirección IPv4 con la longitud de su prefijo de enrutamiento entre dominios sin clases (CIDR) y devuelve el rango de direcciones de la subred como una tupla de dos valores IPv4: la primera y la última dirección de esa subred. Para la versión IPv6, consulte IPv6CIDRToRange.

Sintaxis

IPv4CIDRToRange(ipv4, cidr)

Argumentos

• ipv4 — Dirección IPv4. IPv4 o String
• cidr — Valor de CIDR. UInt8

Valor devuelto

Devuelve una tupla con dos direcciones IPv4 que representan el rango de la subred. Tuple(IPv4, IPv4)

Ejemplos

Ejemplo 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

Introducido en: v1.1.0

Convierte un entero de 32 bits en la representación textual de su dirección IPv4 en notación decimal con puntos (formato A.B.C.D). Interpreta la entrada usando el orden de bytes big-endian.

Sintaxis

IPv4NumToString(num)

Alias: INET_NTOA

Argumentos

• num — dirección IPv4 como número UInt32. UInt32

Valor devuelto

Devuelve un número que representa la dirección MAC, o 0 si el formato no es válido. String

Ejemplos

Ejemplo de uso

Query

IPv4NumToString(3232235521)

Response

192.168.0.1

​

IPv4NumToStringClassC

Introducido en: v1.1.0

Convierte un entero de 32 bits en la representación en cadena de su dirección IPv4 en notación decimal con puntos (formato A.B.C.D), similar a IPv4NumToString, pero usa xxx en lugar del último octeto.

Sintaxis

IPv4NumToStringClassC(num)

Argumentos

• num — Dirección IPv4 en forma de número UInt32. UInt32

Valor devuelto

Devuelve la cadena de dirección IPv4, con xxx en lugar del último octeto. String

Ejemplos

Ejemplo básico con agregación

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

Introducido en: v1.1.0

Convierte una cadena con una dirección IPv4 en notación decimal con puntos (formato A.B.C.D) en su correspondiente representación entera de 32 bits. (La operación inversa de IPv4NumToString). Si la dirección IPv4 tiene un formato no válido, se lanza una excepción.

Sintaxis

IPv4StringToNum(string)

Alias: INET_ATON

Argumentos

• string — Cadena con la dirección IPv4. String

Valor devuelto

Devuelve la dirección IPv4. UInt32

Ejemplos

Ejemplo de uso

Query

IPv4StringToNum('192.168.0.1')

Response

3232235521

​

IPv4StringToNumOrDefault

Introducido en: v22.3.0

Convierte una cadena con una dirección IPv4 en notación decimal con puntos (formato A.B.C.D) en su correspondiente representación entera de 32 bits; si la dirección IPv4 tiene un formato no válido, devuelve 0.

Sintaxis

IPv4StringToNumOrDefault(string)

Argumentos

• string — Cadena con una dirección IPv4. String

Valor devuelto

Devuelve la dirección IPv4 o 0 si no es válida. UInt32

Ejemplos

Ejemplo con una dirección no válida

Query

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

Response

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

​

IPv4StringToNumOrNull

Introducido en: v22.3.0

Convierte un entero de 32 bits en la representación de cadena de su dirección IPv4 en notación decimal con puntos (formato A.B.C.D), pero, si la dirección IPv4 tiene un formato no válido, devuelve NULL.

Sintaxis

IPv4StringToNumOrNull(string)

Argumentos

• string — Cadena con una dirección IPv4. String

Valor devuelto

Devuelve la dirección IPv4, o NULL si no es válida. Nullable(UInt32)

Ejemplos

Ejemplo con una dirección no válida

Query

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

Response

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

​

IPv4ToIPv6

Introducido en: v1.1.0

Interpreta un número de 32 bits (big-endian) como una dirección IPv4, que luego se interpreta como la dirección IPv6 correspondiente en formato FixedString(16).

Sintaxis

IPv4ToIPv6(x)

Argumentos

• x — dirección IPv4. UInt32

Valor devuelto

Devuelve una dirección IPv6 en formato binario. FixedString(16)

Ejemplos

Ejemplo de uso

Query

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

Response

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

​

IPv6CIDRToRange

Introducido en: v20.1.0

Toma una dirección IPv6 con la longitud de su prefijo de enrutamiento entre dominios sin clases (CIDR) y devuelve el rango de direcciones de la subred como una tupla de dos valores IPv6: la dirección más baja y la más alta de esa subred. Para la versión IPv4, consulte IPv4CIDRToRange.

Sintaxis

IPv6CIDRToRange(ipv6, cidr)

Argumentos

• ipv6 — Dirección IPv6. IPv6 o String
• cidr — Valor CIDR. UInt8

Valor devuelto

Devuelve una tupla con dos direcciones IPv6 que representan el rango de la subred. Tuple(IPv6, IPv6)

Ejemplos

Ejemplo 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

Introducido en: v1.1.0

Convierte una dirección IPv6 del formato binario (FixedString(16)) a su representación de texto estándar. Las direcciones IPv6 con mapeo de IPv4 se muestran con el formato ::ffff:111.222.33.44.

Sintaxis

IPv6NumToString(x)

Alias: INET6_NTOA

Argumentos

• x — Dirección IPv6 en formato binario. FixedString(16) o IPv6

Valor devuelto

Devuelve la dirección IPv6 como cadena en formato de texto. String

Ejemplos

Ejemplo de uso

Query

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

Response

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

Análisis de hits con IPv6

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 │
└─────────────────────────────────────────┴───────┘

Direcciones IPv4 mapeadas en 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

Introducido en: v1.1.0

Convierte una dirección IPv6 de su representación textual estándar al formato binario (FixedString(16)). Acepta direcciones IPv6 con mapeo de IPv4 en el formato ::ffff:111.222.33.44.. Si la dirección IPv6 tiene un formato no válido, se lanza una excepción.

Si la cadena de entrada contiene una dirección IPv4 válida, devuelve su equivalente en IPv6. HEX puede estar en mayúsculas o minúsculas.

Sintaxis

IPv6StringToNum(string)

Aliases: INET6_ATON

Argumentos

• string — Cadena con la dirección IPv6. String

Valor devuelto

Devuelve la dirección IPv6 en formato binario. FixedString(16)

Ejemplos

Ejemplo 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

Introducido en: v22.3.0

Convierte una dirección IPv6 de su representación textual estándar al formato binario (FixedString(16)). Acepta direcciones IPv6 con mapeo de IPv4 en el formato ::ffff:111.222.33.44.. Si la dirección IPv6 tiene un formato no válido, devuelve el valor predeterminado ::.

Sintaxis

IPv6StringToNumOrDefault(string)

Argumentos

• string — Cadena con la dirección IPv6. String

Valor devuelto

Dirección IPv6 en formato binario, o FixedString(16) rellenado con ceros si no es válida. FixedString(16)

Ejemplos

Ejemplo básico con una dirección no válida

Query

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

Response

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

​

IPv6StringToNumOrNull

Introducido en: v22.3.0

Convierte una dirección IPv6 de su representación de texto estándar a formato binario (FixedString(16)). Acepta direcciones IPv6 con mapeo de IPv4 en el formato ::ffff:111.222.33.44.. Si la dirección IPv6 tiene un formato no válido, devuelve NULL.

Sintaxis

IPv6StringToNumOrNull(string)

Argumentos

• string — Cadena con una dirección IPv6. String

Valor devuelto

Devuelve la dirección IPv6 en formato binario, o NULL si no es válida. Nullable(FixedString(16))

Ejemplos

Ejemplo básico con una dirección no válida

Query

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

Response

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

​

cutIPv6

Introducido en: v1.1.0

Acepta un valor FixedString(16) que contiene la dirección IPv6 en formato binario. Devuelve una cadena que contiene la dirección, con el número especificado de bytes eliminados, en formato de texto.

Sintaxis

cutIPv6(x, bytesToCutForIPv6, bytesToCutForIPv4)

Argumentos

• x — Dirección IPv6 en formato binario. FixedString(16) o IPv6
• bytesToCutForIPv6 — Número de bytes que se deben eliminar para IPv6. UInt8
• bytesToCutForIPv4 — Número de bytes que se deben eliminar para IPv4. UInt8

Valor devuelto

Devuelve una cadena que contiene la dirección IPv6 en formato de texto con los bytes especificados eliminados. String

Ejemplos

Ejemplo 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

Introducido en: v21.4.0

Determina si una dirección IP está incluida en una red representada en notación enrutamiento entre dominios sin clases (CIDR).

Esta función acepta direcciones IPv4 e IPv6 (y redes) representadas como cadenas. Devuelve 0 si la versión IP de la dirección y la del CIDR no coinciden.

Sintaxis

isIPAddressInRange(address, prefix)

Argumentos

• address — Una dirección IPv4 o IPv6. String
• prefix — Un prefijo de red IPv4 o IPv6 en formato CIDR. String

Valor devuelto

Devuelve 1 si la versión IP de la dirección y el CIDR coinciden; de lo contrario, 0. UInt8

Ejemplos

Dirección IPv4 dentro del rango

Query

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

Response

1

Dirección IPv4 fuera del rango

Query

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

Response

0

Dirección IPv6 fuera de rango

Query

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

Response

0

​

isIPv4String

Introducido en: v21.1.0

Determina si la cadena de entrada es una dirección IPv4. Para la versión para IPv6, consulta isIPv6String.

Sintaxis

isIPv4String(string)

Argumentos

• string — cadena con la dirección IP que se va a comprobar. String

Valor devuelto

Devuelve 1 si string es una dirección IPv4; de lo contrario, 0. UInt8

Ejemplos

Ejemplo 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

Introducido en: v21.1.0

Determina si la cadena de entrada es una dirección IPv6. Para la versión para IPv4, consulte isIPv4String.

Sintaxis

isIPv6String(string)

Argumentos

• string — Cadena con la dirección IP que se va a comprobar. String

Valor devuelto

Devuelve 1 si string es una dirección IPv6; de lo contrario, 0. UInt8

Ejemplos

Ejemplo 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

Introducido en: v20.1.0

Convierte una cadena o una dirección IPv4 en formato UInt32 al tipo IPv4. Es similar a las funciones IPv4StringToNum y IPv4NumToString, pero admite como argumentos de entrada tanto cadenas como tipos de datos enteros sin signo.

Sintaxis

toIPv4(x)

Argumentos

• x — Una dirección IPv4 de tipo String o UInt8/16/32

Valor devuelto

Devuelve una dirección IPv4. IPv4

Ejemplos

Ejemplo de uso

Query

SELECT toIPv4('171.225.130.45');

Response

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

Comparación con las funciones 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                 │
└───────────────────────────────────┴──────────────────────────┘

Conversión a partir de un entero

Query

SELECT toIPv4(2130706433);

Response

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

​

toIPv4OrDefault

Introducido en: v22.3.0

Convierte una cadena o una dirección IPv4 en formato UInt32 al tipo IPv4. Si la dirección IPv4 tiene un formato no válido, devuelve 0.0.0.0 (IPv4 0) o el valor predeterminado de IPv4 especificado.

Sintaxis

toIPv4OrDefault(string[, default])

Argumentos

• string — Cadena con la dirección IP que se va a convertir. String
• default — Opcional. Valor que se devolverá si string no es una dirección IPv4 válida. IPv4

Valor devuelto

Devuelve la dirección IPv4 obtenida a partir de la cadena, o el valor predeterminado si la conversión falla. IPv4

Ejemplos

Cadenas IPv4 válidas y no vá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

Introducido en: v22.3.0

Convierte un valor de entrada en un valor de tipo IPv4, pero devuelve NULL en caso de error. Como toIPv4, pero devuelve NULL en lugar de lanzar una excepción ante errores de conversión.

Argumentos admitidos:

• Representaciones en cadena de direcciones IPv4 en notación decimal con puntos.
• Representaciones enteras de direcciones IPv4.

Argumentos no admitidos (devuelven NULL):

• Formatos de direcciones IP no válidos.
• Direcciones IPv6.
• Valores fuera de rango.
• Direcciones malformadas.

Sintaxis

toIPv4OrNull(x)

Argumentos

• x — Una dirección IPv4 representada como cadena o entero. String o Integer

Valor devuelto

Devuelve una dirección IPv4 si la operación se realiza correctamente; de lo contrario, NULL. IPv4 o NULL

Ejemplos

Ejemplo 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

Introducido en: v23.1.0

Convierte un valor de entrada en un valor de tipo IPv4, pero devuelve la dirección IPv4 nula en caso de error. Como toIPv4, pero devuelve la dirección IPv4 nula (0.0.0.0) en lugar de lanzar una excepción cuando se producen errores de conversión.

Argumentos admitidos:

• Representaciones en cadena de direcciones IPv4 en notación decimal con puntos.
• Representaciones enteras de direcciones IPv4.

Argumentos no admitidos (devuelven una dirección IPv4 nula):

• Formatos de dirección IP no válidos.
• Direcciones IPv6.
• Valores fuera de rango.

Sintaxis

toIPv4OrZero(x)

Argumentos

• x — Una representación en forma de cadena o de entero de una dirección IPv4. String o Integer

Valor devuelto

Devuelve una dirección IPv4 si la conversión se realiza correctamente; en caso contrario, devuelve la dirección IPv4 cero (0.0.0.0). IPv4

Ejemplos

Ejemplo 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

Introducido en: v20.1.0

Convierte una cadena o una dirección IPv6 en formato UInt128 al tipo IPv6. En el caso de las cadenas, si la dirección IPv6 tiene un formato no válido, devuelve un valor vacío. Es similar a las funciones IPv6StringToNum y IPv6NumToString, que convierten direcciones IPv6 a y desde formato binario (es decir, FixedString(16)).

Si la cadena de entrada contiene una dirección IPv4 válida, se devuelve su equivalente en IPv6.

Sintaxis

toIPv6(x)

Argumentos

• x — Una dirección IP. String o UInt128

Valor devuelto

Devuelve una dirección IPv6. IPv6

Ejemplos

Ejemplo 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 │
└───────────────────────────────────┴──────────────────────────────────┘

Mapeo de IPv4 a IPv6

Query

SELECT toIPv6('127.0.0.1');

Response

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

​

toIPv6OrDefault

Introducido en: v22.3.0

Convierte una cadena o una dirección IPv6 en formato UInt128 al tipo IPv6. Si la dirección IPv6 tiene un formato no válido, devuelve :: (IPv6 0) o el valor predeterminado de IPv6 proporcionado.

Sintaxis

toIPv6OrDefault(string[, default])

Argumentos

• string — Cadena con la dirección IP que se va a convertir. - default — Opcional. Valor que se devolverá si la cadena tiene un formato no válido.

Valor devuelto

Devuelve la dirección IPv6; en caso contrario, :: o el valor predeterminado opcional proporcionado si el argumento string tiene un formato no válido. IPv6

Ejemplos

Cadenas IPv6 válidas y no vá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

Introducido en: v22.3.0

Convierte un valor de entrada en un valor de tipo IPv6, pero devuelve NULL en caso de error. Igual que toIPv6, pero devuelve NULL en lugar de generar una excepción cuando se producen errores de conversión.

Argumentos compatibles:

• Representaciones en cadena de direcciones IPv6 en notación estándar.
• Representaciones en cadena de direcciones IPv4 (convertidas en direcciones IPv6 con mapeo de IPv4).
• Representaciones binarias de direcciones IPv6.

Argumentos no compatibles (devuelven NULL):

• Formatos de direcciones IP no válidos.
• Direcciones IPv6 mal formadas.
• Valores fuera de rango.
• Notación no válida.

Sintaxis

toIPv6OrNull(x)

Argumentos

• x — Una representación textual de una dirección IPv6 o IPv4. String

Valor devuelto

Devuelve una dirección IPv6 si la conversión se realiza correctamente; de lo contrario, NULL. IPv6 o NULL

Ejemplos

Ejemplo 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

Introducido en: v23.1.0

Convierte un valor de entrada en un valor de tipo IPv6, pero devuelve la dirección IPv6 nula en caso de error. Es como toIPv6, pero devuelve la dirección IPv6 nula (::) en lugar de lanzar una excepción cuando se producen errores de conversión.

Argumentos admitidos:

• Representaciones en cadena de direcciones IPv6 en notación estándar.
• Representaciones en cadena de direcciones IPv4 (convertidas a IPv6 con mapeo de IPv4).
• Representaciones binarias de direcciones IPv6.

Argumentos no admitidos (devuelven la dirección IPv6 nula):

• Formatos de dirección IP no válidos.
• Direcciones IPv6 mal formadas.
• Valores fuera de rango.

Sintaxis

toIPv6OrZero(x)

Argumentos

• x — Una representación en cadena de una dirección IPv6 o IPv4. String

Valor devuelto

Devuelve una dirección IPv6 si la conversión se realiza correctamente; de lo contrario, devuelve la dirección IPv6 cero (::). IPv6

Ejemplos

Ejemplo 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        │ ::           │
└─────────────────────────────────────┴──────────────┘