FROM_HEX

Syntaxe

Paramètres

Description

Cette fonction permet de convertir une expression de chaîne de caractères en format hexadécimal de type de données BYTES.

Remarques

• La fonction FROM_HEX convertit une chaîne hexadécimale en données binaires : Elle prend en entrée une chaîne composée de caractères représentant des chiffres hexadécimaux (0 à 9, A à F) et retourne une valeur de type BYTES. C'est donc une méthode directe pour transformer une représentation texte de données binaires en leur forme brute.
• La chaîne en entrée doit avoir un nombre pair de caractères : Chaque paire de caractères hexadécimaux représente un octet (byte). Si la longueur de la chaîne est impaire, BigQuery renverra une erreur, car il est impossible de former des octets complets à partir d'un nombre impair de caractères.
• Le type retourné est BYTES, utile pour les traitements binaires : Le résultat n'est pas une chaîne de texte mais une séquence de bytes. Cela permet de travailler avec des fichiers, du contenu cryptographique, ou des valeurs encodées à un niveau bas dans une requête SQL, ce qui serait impossible avec du texte classique.
• FROM_HEX est souvent utilisé en combinaison avec TO_HEX : Cette paire de fonctions permet d'encoder et de décoder des valeurs BYTES en hexadécimal. Par exemple, on peut transformer une valeur binaire en chaîne lisible (via TO_HEX) puis la récupérer plus tard dans sa forme originale avec FROM_HEX.
• Le format hexadécimal est très courant dans les systèmes informatiques : Il est souvent utilisé pour représenter des empreintes, des identifiants uniques, des contenus binaires ou des résultats de fonctions de hachage. Pouvoir décoder ces valeurs dans BigQuery facilite leur traitement sans passer par des outils externes.
• Les lettres dans la chaîne hexadécimale peuvent être en majuscules ou minuscules : BigQuery accepte aussi bien les caractères hexadécimaux en majuscules (A à F) qu'en minuscules (a à f). Cela rend la fonction plus souple, car les données sources peuvent venir de divers systèmes avec des conventions différentes.
• Attention aux caractères invalides dans la chaîne : Tout caractère non valide pour le format hexadécimal (autres que 0-9 et A-F/a-f) provoquera une erreur. Il est donc recommandé de valider ou filtrer les chaînes avant d'utiliser FROM_HEX pour éviter des interruptions de requêtes.
• La fonction est particulièrement utile pour manipuler des UUID ou des hash : Les identifiants tels que les UUID ou les hachages SHA-1, SHA-256, souvent exprimés en hexadécimal, peuvent être convertis avec FROM_HEX pour des opérations binaires ou des comparaisons optimisées. Elle permet donc une exploitation plus technique des données dans BigQuery.