FROM_BASE32

Syntaxe

Paramètres

Description

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

Remarques

• La fonction FROM_BASE32 convertit du texte encodé en Base32 vers un format binaire : Elle est conçue pour décoder une chaîne encodée en Base32 et la transformer en une valeur de type BYTES. Cela permet de récupérer les données binaires d'origine qui avaient été converties pour être transmises ou stockées plus facilement sous forme textuelle.
• Le paramètre string_expr doit être une chaîne encodée en Base32 valide : La chaîne passée en argument doit respecter l'alphabet standard du Base32 (caractères A-Z et 2-7, sans distinction de casse), sans espace ni caractère non conforme. Une erreur sera générée si la chaîne contient des caractères invalides ou mal formatés.
• Le résultat est de type BYTES, et non une chaîne de caractères : Contrairement à ce que l'on pourrait croire, le résultat de FROM_BASE32 n'est pas un texte lisible, mais bien une séquence binaire. Ce type de donnée est souvent utilisé pour manipuler des contenus codés comme des clefs, des identifiants ou des fichiers binaires.
• Elle est complémentaire de la fonction TO_BASE32 : FROM_BASE32 sert à décoder ce qui a été encodé avec TO_BASE32. Ensemble, ces deux fonctions permettent d'encoder des données binaires en texte (pour l'entreposage ou la transmission) puis de les restaurer à leur état d'origine de manière réversible.
• Cette fonction est utile pour traiter des données transmises dans des formats sûrs : Base32 est un format d'encodage textuel conçu pour être sûr pour les canaux comme les URLs ou les systèmes qui ne supportent pas bien les octets bruts. Elle est donc utile pour importer des données extérieures encodées de manière sécurisée.
• Elle peut être utilisée dans des pipelines de transformation pour restaurer des données : Lors de l'ingestion de données encodées en Base32 depuis des fichiers ou des APIs, cette fonction permet de décoder immédiatement ces champs dans BigQuery sans avoir besoin d'un traitement externe, ce qui simplifie les flux ETL.
• L'encodage Base32 étant plus long que le binaire, le résultat décodé est plus compact : La chaîne de départ est en général plus longue que les données qu'elle représente une fois décodée. Le BYTES résultant est donc une représentation plus compacte et adaptée aux opérations de hachage, de cryptographie ou d'entreposage optimisé.
• Elle ne doit pas être utilisée si les données n'ont pas été encodées en Base32 à l'origine : Si une chaîne qui n'est pas réellement en Base32 est passée à cette fonction, cela entraînera une erreur ou un résultat erroné. Il est donc essentiel de connaître l'origine et le format du contenu avant de l'utiliser avec FROM_BASE32.