NET.SAFE_IP_FROM_STRING |
Réseau : Sauvegarde l'IP d'une chaîne de caractères |
| BigQuery |
Syntaxe
|
NET.SAFE_IP_FROM_STRING(addr_str)
|
Paramètres
| Nom |
Description |
| addr_str |
Ce paramètre permet de spécifier l'adresse IP, au format chaîne de caractères (IPv4 ou IPv6), que vous souhaitez convertir en format binaire (BYTES). Contrairement à NET.IP_FROM_STRING, cette fonction est "sûre" car elle renvoie NULL si la chaîne d'entrée n'est pas une adresse IP valide, au lieu de provoquer une erreur. |
Description
Cette fonction permet de de convertir une adresse IP de format IPv4 ou IPv6 en en chaîne de caractères de format binaire et de retourner la valeur NULL si une exception se produit.
Remarques
- Conversion sécurisée d'une adresse IP en format binaire : La fonction NET.SAFE_IP_FROM_STRING convertit une adresse IP
fournie sous forme de chaîne de caractères en une représentation binaire (BYTES). Elle supporte à la fois les formats IPv4 et
IPv6, ce qui la rend polyvalente pour de nombreux cas d'usage réseau.
- Gestion d'erreurs intégrée sans interruption : Contrairement à NET.IP_FROM_STRING générant une erreur lorsqu'une adresse invalide est fournie,
NET.SAFE_IP_FROM_STRING renvoie NULL dans ce cas. Cela permet d'éviter que des erreurs bloquent l'exécution des requêtes, améliorant ainsi la robustesse des traitements.
- Pratique dans les environnements où les données sont imparfaites : Lorsqu'on travaille avec des sources de données externes ou non contrôlées, il est
fréquent de rencontrer des adresses IP malformées ou incorrectes. Cette fonction facilite la conversion sans risque d'arrêt, en marquant simplement ces cas par une
valeur nulle.
- Compatible avec IPv4 et IPv6 pour une plus grande couverture : La fonction traite indifféremment les adresses IPv4
(format 4 octets) et IPv6 (format 16 octets), ce qui permet d'avoir un seul outil pour convertir tous types d'adresses
IP dans une base de données.
- Retourne une valeur binaire utilisable pour d'autres fonctions réseau : Le format BYTES retourné est standard pour les fonctions réseau
BigQuery, telles que NET.IP_TRUNC ou NET.IPV4_TO_INT64. Cela facilite la chaîne de traitement des adresses IP, depuis la conversion jusqu'à l'analyse avancée.
- Idéale pour nettoyer et valider les données IP dans un pipeline SQL : En intégrant NET.SAFE_IP_FROM_STRING dans un flux de transformation, on peut
rapidement détecter les adresses invalides et décider comment les traiter (filtrage, remplacement, signalement), améliorant ainsi la qualité des données.
- Permet d'éviter les erreurs critiques dans les scripts et automatisations : Dans des requêtes complexes ou des processus automatisés, une erreur liée à
une IP malformée peut interrompre toute la chaîne. Cette fonction offre une solution élégante en renvoyant simplement NULL, évitant ainsi des échecs coûteux.
- Complément indispensable de NET.IP_FROM_STRING dans l'écosystème BigQuery : Tandis que NET.IP_FROM_STRING est stricte et s'utilise lorsque la validité
est assurée, NET.SAFE_IP_FROM_STRING est préférée dans des contextes plus incertains ou exploratoires, garantissant une meilleure tolérance aux anomalies.
Dernière mise à jour : Jeudi, le 18 Juin 2020
