Fonctions permettant de manipuler des adresses IPv4 et IPv6

IPv4CIDRToRange

Introduit dans : v20.1.0 Prend une adresse IPv4 et la longueur de son préfixe CIDR (Classless Inter-Domain Routing), et renvoie la plage d’adresses du sous-réseau sous la forme d’un tuple de deux valeurs IPv4 : la première et la dernière adresse de ce sous-réseau. Pour la version IPv6, voir IPv6CIDRToRange. Syntaxe

IPv4CIDRToRange(ipv4, cidr)

Arguments

ipv4 — Adresse IPv4. IPv4 ou String
cidr — Valeur CIDR. UInt8

Valeur renvoyée Renvoie un tuple contenant deux adresses IPv4 représentant la plage d’adresses du sous-réseau. Tuple(IPv4, IPv4) Exemples Exemple d’utilisation

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

Introduite dans : v1.1.0 Convertit un entier de 32 bits en sa représentation sous forme de chaîne d’adresse IPv4 en notation décimale pointée (format A.B.C.D). Interprète l’entrée selon l’ordre des octets big-endian. Syntaxe

IPv4NumToString(num)

Alias : INET_NTOA Arguments

num — adresse IPv4 sous la forme d’un nombre UInt32. UInt32

Valeur renvoyée Renvoie un nombre représentant l’adresse MAC, ou 0 si le format n’est pas valide. String Exemples Exemple d’utilisation

Query

IPv4NumToString(3232235521)

Response

192.168.0.1

IPv4NumToStringClassC

Introduit dans : v1.1.0 Convertit un entier de 32 bits en sa représentation textuelle d’adresse IPv4 en notation décimale pointée (format A.B.C.D), similaire à IPv4NumToString, mais en utilisant xxx à la place du dernier octet. Syntaxe

IPv4NumToStringClassC(num)

Arguments

num — Adresse IPv4 représentée sous forme de nombre UInt32. UInt32

Valeur renvoyée Renvoie la chaîne représentant l’adresse IPv4, où xxx remplace le dernier octet. String Exemples Exemple de base avec agrégation

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

Introduit dans : v1.1.0 Convertit une chaîne d’adresse IPv4 en notation décimale pointée (format A.B.C.D) en sa représentation entière correspondante sur 32 bits. (L’inverse de IPv4NumToString). Si l’adresse IPv4 n’est pas dans un format valide, une exception est levée. Syntaxe

IPv4StringToNum(string)

Alias : INET_ATON Arguments

string — chaîne contenant une adresse IPv4. String

Valeur renvoyée Renvoie l’adresse IPv4. UInt32 Exemples Exemple d’utilisation

Query

IPv4StringToNum('192.168.0.1')

Response

3232235521

IPv4StringToNumOrDefault

Introduit dans : v22.3.0 Convertit une chaîne d’adresse IPv4 en notation décimale pointée (format A.B.C.D) en sa représentation sous forme d’entier 32 bits correspondante. Si l’adresse IPv4 n’a pas un format valide, renvoie 0. Syntaxe

IPv4StringToNumOrDefault(string)

Arguments

string — chaîne contenant une adresse IPv4. String

Valeur renvoyée Renvoie l’adresse IPv4, ou 0 si elle est invalide. UInt32 Exemples Exemple avec une adresse invalide

Query

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

Response

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

IPv4StringToNumOrNull

Introduit dans : v22.3.0 Convertit un entier 32 bits en sa représentation sous forme de chaîne d’adresse IPv4 en notation décimale pointée (format A.B.C.D), mais si l’adresse IPv4 a un format invalide, renvoie NULL. Syntaxe

IPv4StringToNumOrNull(string)

Arguments

string — chaîne contenant une adresse IPv4. String

Valeur renvoyée Renvoie l’adresse IPv4, ou NULL si elle est invalide. Nullable(UInt32) Exemples Exemple avec une adresse invalide

Query

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

Response

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

IPv4ToIPv6

Introduit dans : v1.1.0 Interprète un nombre 32 bits (big endian) comme une adresse IPv4, puis l’interprète comme l’adresse IPv6 correspondante au format FixedString(16). Syntaxe

IPv4ToIPv6(x)

Arguments

x — adresse IPv4. UInt32

Valeur renvoyée Renvoie une adresse IPv6 au format binaire. FixedString(16) Exemples Exemple d’utilisation

Query

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

Response

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

IPv6CIDRToRange

Introduit dans : v20.1.0 Prend une adresse IPv6 avec la longueur de son préfixe Classless Inter-Domain Routing (CIDR) et renvoie la plage d’adresses du sous-réseau sous la forme d’un Tuple de deux valeurs IPv6 : l’adresse la plus basse et la plus haute de ce sous-réseau. Pour la version IPv4, voir IPv4CIDRToRange. Syntaxe

IPv6CIDRToRange(ipv6, cidr)

Arguments

ipv6 — adresse IPv6. IPv6 ou String
cidr — valeur CIDR. UInt8

Valeur renvoyée Renvoie un tuple de deux adresses IPv6 représentant la plage du sous-réseau. Tuple(IPv6, IPv6) Exemples Exemple d’utilisation

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

Introduit dans : v1.1.0 Convertit une adresse IPv6 du format binaire (FixedString(16)) en sa représentation textuelle standard. Les adresses IPv6 mappées sur IPv4 sont affichées au format ::ffff:111.222.33.44. Syntaxe

IPv6NumToString(x)

Alias : INET6_NTOA Arguments

x — adresse IPv6 au format binaire. FixedString(16) ou IPv6

Valeur renvoyée Renvoie la chaîne de l’adresse IPv6 au format texte. String Exemples Exemple d’utilisation

Query

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

Response

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

Analyse IPv6 avec la table 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 │
└─────────────────────────────────────────┴───────┘

Adresses IPv4 mappées sur 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

Introduit dans : v1.1.0 Convertit une adresse IPv6 de sa représentation textuelle standard en format binaire (FixedString(16)). Accepte les adresse IPv6 mappée sur IPv4 au format ::ffff:111.222.33.44.. Si l’adresse IPv6 est dans un format invalide, une exception est levée. Si la chaîne d’entrée contient une adresse IPv4 valide, renvoie son équivalent IPv6. HEX peut être en majuscules ou en minuscules. Syntaxe

IPv6StringToNum(string)

Alias : INET6_ATON Arguments

string — Chaîne d’adresse IPv6. String

Valeur renvoyée Renvoie l’adresse IPv6 au format binaire. FixedString(16) Exemples Exemple de base

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

Introduit dans : v22.3.0 Convertit une adresse IPv6 de sa représentation textuelle standard au format binaire (FixedString(16)). Accepte les adresse IPv6 mappée sur IPv4 au format ::ffff:111.222.33.44.. Si l’adresse IPv6 n’est pas dans un format valide, elle renvoie la valeur par défaut ::. Syntaxe

IPv6StringToNumOrDefault(string)

Arguments

string — chaîne représentant une adresse IPv6. String

Valeur renvoyée Adresse IPv6 au format binaire, ou FixedString(16) rempli de zéros si l’adresse n’est pas valide. FixedString(16) Exemples Exemple de base avec une adresse invalide

Query

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

Response

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

IPv6StringToNumOrNull

Introduit dans : v22.3.0 Convertit une adresse IPv6 de sa représentation textuelle standard en format binaire (FixedString(16)). Accepte les adresses IPv6 mappées sur IPv4 au format ::ffff:111.222.33.44.. Si le format de l’adresse IPv6 n’est pas valide, renvoie NULL. Syntaxe

IPv6StringToNumOrNull(string)

Arguments

string — Chaîne représentant une adresse IPv6. String

Valeur renvoyée Renvoie l’adresse IPv6 au format binaire, ou NULL si elle n’est pas valide. Nullable(FixedString(16)) Exemples Exemple simple avec une adresse non valide

Query

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

Response

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

cutIPv6

Introduit dans : v1.1.0 Accepte une valeur FixedString(16) contenant l’adresse IPv6 au format binaire. Renvoie une chaîne contenant l’adresse après suppression du nombre d’octets spécifié, au format texte. Syntaxe

cutIPv6(x, bytesToCutForIPv6, bytesToCutForIPv4)

Arguments

x — adresse IPv6 au format binaire. FixedString(16) ou IPv6
bytesToCutForIPv6 — nombre d’octets à supprimer pour IPv6. UInt8
bytesToCutForIPv4 — nombre d’octets à supprimer pour IPv4. UInt8

Valeur renvoyée Renvoie une chaîne contenant l’adresse IPv6 au format texte après suppression des octets spécifiés. String Exemples Exemple d’utilisation

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

Introduit dans : v21.4.0 Détermine si une adresse IP appartient à un réseau représenté au format Classless Inter-Domain Routing (CIDR). Cette fonction accepte les adresses IPv4 et IPv6 (ainsi que les réseaux) représentées sous forme de chaînes. Elle renvoie 0 si la version IP de l’adresse et celle du CIDR ne correspondent pas. Syntaxe

isIPAddressInRange(address, prefix)

Arguments

address — Une adresse IPv4 ou IPv6. String
prefix — Un préfixe réseau IPv4 ou IPv6 au format CIDR. String

Valeur renvoyée Renvoie 1 si la version IP de l’adresse et celle du CIDR correspondent, sinon 0. UInt8 Exemples Adresse IPv4 comprise dans la plage

Query

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

Response

Adresse IPv4 en dehors de la plage

Query

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

Response

Adresse IPv6 en dehors de la plage

Query

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

Response

isIPv4String

Introduit dans : v21.1.0 Détermine si la chaîne d’entrée est ou non une adresse IPv4. Pour la version IPv6, voir isIPv6String. Syntaxe

isIPv4String(string)

Arguments

string — Chaîne représentant l’adresse IP à vérifier. String

Valeur renvoyée Renvoie 1 si string est une adresse IPv4, sinon 0. UInt8 Exemples Exemple d’utilisation

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

Introduit dans : v21.1.0 Détermine si la chaîne d’entrée est ou non une adresse IPv6. Pour la version IPv4, voir isIPv4String. Syntaxe

isIPv6String(string)

Arguments

string — Chaîne contenant l’adresse IP à vérifier. String

Valeur renvoyée Renvoie 1 si string est une adresse IPv6, sinon 0. UInt8 Exemples Exemple d’utilisation

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

Introduit dans : v20.1.0 Convertit une chaîne ou une adresse IPv4 sous forme de UInt32 en type IPv4. Cette fonction est similaire aux fonctions IPv4StringToNum et IPv4NumToString, mais elle prend en charge à la fois les types de données chaîne et entier non signé en arguments d’entrée. Syntaxe

toIPv4(x)

Arguments

x — Une adresse IPv4 String ou UInt8/16/32

Valeur renvoyée Renvoie une adresse IPv4. IPv4 Exemples Exemple d’utilisation

Query

SELECT toIPv4('171.225.130.45');

Response

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

Comparaison avec les fonctions IPv4StringToNum et 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                 │
└───────────────────────────────────┴──────────────────────────┘

Conversion d’un entier

Query

SELECT toIPv4(2130706433);

Response

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

toIPv4OrDefault

Introduit dans : v22.3.0 Convertit une chaîne ou une valeur UInt32 représentant une adresse IPv4 en type IPv4. Si l’adresse IPv4 a un format invalide, la fonction renvoie 0.0.0.0 (IPv4 0) ou la valeur IPv4 par défaut fournie. Syntaxe

toIPv4OrDefault(string[, default])

Arguments

string — Chaîne contenant l’adresse IP à convertir. String
default — Facultatif. Valeur à renvoyer si la chaîne n’est pas une adresse IPv4 valide. IPv4

Valeur renvoyée Renvoie une adresse IPv4 obtenue à partir de la chaîne, ou la valeur par défaut si la conversion échoue. IPv4 Exemples Chaînes IPv4 valides et non valides

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

Introduit dans : v22.3.0 Convertit une valeur d’entrée en une valeur de type IPv4, mais renvoie NULL en cas d’erreur. Comme toIPv4, mais renvoie NULL au lieu de lever une exception en cas d’erreur de conversion. Arguments pris en charge :

Représentations sous forme de chaîne d’adresses IPv4 en notation décimale pointée.
Représentations entières d’adresses IPv4.

Arguments non pris en charge (renvoient NULL) :

Formats d’adresse IP non valides.
Adresses IPv6.
Valeurs hors plage.
Adresses mal formées.

Syntaxe

toIPv4OrNull(x)

Arguments

x — Une représentation d’une adresse IPv4 sous forme de chaîne ou d’entier. String ou Integer

Valeur renvoyée Renvoie une adresse IPv4 en cas de succès, sinon NULL. IPv4 ou NULL Exemples Exemple d’utilisation

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

Introduit dans : v23.1.0 Convertit une valeur d’entrée en une valeur de type IPv4, mais renvoie l’adresse IPv4 nulle en cas d’erreur. Comme toIPv4, mais renvoie l’adresse IPv4 nulle (0.0.0.0) au lieu de lever une exception en cas d’erreur de conversion. Arguments pris en charge :

Représentations sous forme de chaînes d’adresses IPv4 en notation décimale pointée.
Représentations entières d’adresses IPv4.

Arguments non pris en charge (renvoie l’adresse IPv4 nulle) :

Formats d’adresse IP non valides.
Adresses IPv6.
Valeurs hors plage.

Syntaxe

toIPv4OrZero(x)

Arguments

x — Une représentation d’une adresse IPv4 sous forme de chaîne ou d’entier. String ou Integer

Valeur renvoyée Renvoie une adresse IPv4 en cas de succès ; sinon, l’adresse IPv4 nulle (0.0.0.0). IPv4 Exemples Exemple d’utilisation

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

Introduit dans : v20.1.0 Convertit une chaîne ou une adresse IPv6 au format UInt128 vers le type IPv6. Pour les chaînes, si l’adresse IPv6 a un format invalide, renvoie une valeur vide. Semblable aux fonctions IPv6StringToNum et IPv6NumToString, qui convertissent une adresse IPv6 depuis et vers le format binaire (c.-à-d. FixedString(16)). Si la chaîne d’entrée contient une adresse IPv4 valide, l’équivalent IPv6 de cette adresse IPv4 est renvoyé. Syntaxe

toIPv6(x)

Arguments

x — Une adresse IP. String ou UInt128

Valeur renvoyée Renvoie une adresse IPv6. IPv6 Exemples Exemple d’utilisation

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

Correspondance IPv4-IPv6

Query

SELECT toIPv6('127.0.0.1');

Response

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

toIPv6OrDefault

Introduit dans : v22.3.0 Convertit une chaîne ou une valeur UInt128 représentant une adresse IPv6 en type IPv6. Si l’adresse IPv6 a un format non valide, la fonction renvoie :: (IPv6 0) ou l’adresse IPv6 par défaut fournie. Syntaxe

toIPv6OrDefault(string[, default])

Arguments

string — Chaîne d’adresse IP à convertir. - default — Facultatif. Valeur à renvoyer si la chaîne a un format invalide.

Valeur renvoyée Renvoie l’adresse IPv6, sinon :: ou la valeur par défaut facultative fournie si l’argument string a un format invalide. IPv6 Exemples Chaînes IPv6 valides et invalides

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

Introduit dans : v22.3.0 Convertit une valeur d’entrée en valeur de type IPv6, mais renvoie NULL en cas d’erreur. Comme toIPv6, mais renvoie NULL au lieu de lever une exception en cas d’erreur de conversion. Arguments pris en charge :

Représentations textuelles d’adresses IPv6 en notation standard.
Représentations textuelles d’adresses IPv4 (converties en adresses IPv6 mappées sur IPv4).
Représentations binaires d’adresses IPv6.

Arguments non pris en charge (renvoient NULL) :

Formats d’adresse IP invalides.
Adresses IPv6 mal formées.
Valeurs hors plage.
Notation invalide.

Syntaxe

toIPv6OrNull(x)

Arguments

x — Une représentation sous forme de chaîne d’une adresse IPv6 ou IPv4. String

Valeur renvoyée Renvoie une adresse IPv6 en cas de réussite, sinon NULL. IPv6 ou NULL Exemples Exemple d’utilisation

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

Introduit dans : v23.1.0 Convertit une valeur d’entrée en valeur de type IPv6, mais renvoie l’adresse IPv6 nulle en cas d’erreur. Comme toIPv6, mais renvoie l’adresse IPv6 nulle (::) au lieu de lever une exception en cas d’erreur de conversion. Arguments pris en charge :

Représentations sous forme de chaîne d’adresses IPv6 en notation standard.
Représentations sous forme de chaîne d’adresses IPv4 (converties en IPv6 mappées sur IPv4).
Représentations binaires d’adresses IPv6.

Arguments non pris en charge (renvoient une adresse IPv6 nulle) :

Formats d’adresse IP non valides.
Adresses IPv6 mal formées.
Valeurs hors plage.

Syntaxe

toIPv6OrZero(x)

Arguments

x — La représentation sous forme de chaîne d’une adresse IPv6 ou IPv4. String

Valeur renvoyée Renvoie une adresse IPv6 en cas de réussite, sinon l’adresse IPv6 nulle (::). IPv6 Exemples Exemple d’utilisation

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

​IPv4CIDRToRange

​IPv4NumToString

​IPv4NumToStringClassC

​IPv4StringToNum

​IPv4StringToNumOrDefault

​IPv4StringToNumOrNull

​IPv4ToIPv6

​IPv6CIDRToRange

​IPv6NumToString

​IPv6StringToNum

​IPv6StringToNumOrDefault

​IPv6StringToNumOrNull

​cutIPv6

​isIPAddressInRange

​isIPv4String

​isIPv6String

​toIPv4

​toIPv4OrDefault

​toIPv4OrNull

​toIPv4OrZero

​toIPv6

​toIPv6OrDefault

​toIPv6OrNull

​toIPv6OrZero

IPv4CIDRToRange

IPv4NumToString

IPv4NumToStringClassC

IPv4StringToNum

IPv4StringToNumOrDefault

IPv4StringToNumOrNull

IPv4ToIPv6

IPv6CIDRToRange

IPv6NumToString

IPv6StringToNum

IPv6StringToNumOrDefault

IPv6StringToNumOrNull

cutIPv6

isIPAddressInRange

isIPv4String

isIPv6String

toIPv4

toIPv4OrDefault

toIPv4OrNull

toIPv4OrZero

toIPv6

toIPv6OrDefault

toIPv6OrNull

toIPv6OrZero