TO_BASE32

Syntaxe

Paramètres

Description

Cette fonction permet de convertir une expression de type de données BYTES en un format base32 de type de données STRING.

Remarques

• Conversion binaire vers représentation textuelle sécurisée : La fonction TO_BASE32 transforme des données binaires (BYTES) en une chaîne de caractères encodée en Base32. Ce format est particulièrement utile lorsqu'on souhaite transmettre ou stocker des données binaires sous forme lisible, tout en évitant les caractères spéciaux problématiques dans certains contextes (URL, fichiers,...).
• Encodage adapté aux systèmes sensibles à la casse et aux caractères spéciaux : Le Base32 utilise un alphabet restreint composé de lettres majuscules A à Z et des chiffres 2 à 7. Cela le rend plus résilient aux erreurs de transcription (humaines ou systèmes) que le Base64, et plus lisible dans des environnements contraints comme les QR codes ou les clefs API.
• Conversion sans perte, mais non réversible avec cette seule fonction : TO_BASE32 encode de façon déterministe les données BYTES. Cependant, il est important de noter qu'il n'existe pas de fonction inverse directe nommée FROM_BASE32 dans BigQuery à l'heure actuelle, ce qui limite les cas d'usage si une conversion retour est nécessaire.
• Idéal pour l'anonymisation ou le masquage des identifiants binaires : En convertissant des identifiants ou des empreintes numériques en Base32, on obtient une chaîne pseudonymisée, plus facile à manipuler, tout en masquant la structure ou le contenu exact d'origine. C'est utile pour publier des journaux ou des identifiants sans révéler directement les données brutes.
• Moins compact que Base64, mais plus lisible : L'encodage Base32 génère des chaînes plus longues que Base64 (environ 60 % plus longues que les données originales), mais offre en retour une meilleure lisibilité, une insensibilité à la casse, et une meilleure tolérance aux erreurs. Le compromis espace/lisibilité est souvent acceptable selon les cas.
• Attention à la nature de l'entrée : La fonction ne prend en entrée que des données de type BYTES. Si l'utilisateur souhaite encoder une chaîne (STRING), il devra d'abord la convertir explicitement en BYTES à l'aide de la fonction TO_BYTES. Omettre cette conversion provoquera une erreur de type.
• Pratique pour générer des codes d'activation ou des clefs uniques : TO_BASE32 peut être utilisée pour encoder des hashs ou des GUID binaires, afin de créer des clés d'identification lisibles et transmises facilement dans les URLs ou les systèmes externes. C'est une approche souvent utilisée dans les systèmes d'invitation ou d'authentification par jeton.
• Utilisation sécurisée dans des contextes web ou inter-applications : Comparé à d'autres formats d'encodage, Base32 est plus sûr dans les environnements interdisant certains caractères (comme +, /, = de Base64). Cela permet d'éviter les encodages secondaires (comme URL encode) et réduit les risques d'erreurs d'interprétation côté client.