FROM_BASE64

Syntaxe

Paramètres

Description

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

Remarques

• La fonction FROM_BASE64 sert à décoder une chaîne encodée en Base64 en données binaires : Elle prend en entrée une chaîne de caractères au format Base64 et renvoie une valeur de type BYTES, correspondant aux données binaires originales avant encodage. Cela permet de manipuler directement les contenus binaires stockés ou transmis sous forme de texte.
• Le paramètre string_expr doit être une chaîne valide encodée en Base64 : La chaîne passée à la fonction doit respecter la norme Base64, incluant les caractères alphanumériques ainsi que les symboles "+", "/" et éventuellement "=" pour le remplissage. Toute chaîne mal formée ou contenant des caractères invalides entraînera une erreur lors de la décodification.
• Le résultat est un type BYTES, non une chaîne de texte : Contrairement à ce que l'on pourrait penser, la sortie n'est pas une chaîne lisible mais une séquence binaire. Ce type est adapté pour des opérations comme l'entreposage compact, la cryptographie ou la manipulation de fichiers encodés.
• Cette fonction est souvent utilisée conjointement avec TO_BASE64 : FROM_BASE64 permet de récupérer les données binaires d'origine après qu'elles aient été encodées avec TO_BASE64 pour un transfert ou entreposage sûr. Elles forment ainsi un couple de fonctions indispensables pour la gestion des données binaires en environnement BigQuery.
• Le Base64 est un format très courant pour l'encodage de données binaires en texte : Ce format est fréquemment utilisé pour encoder des images, fichiers, clefs cryptographiques ou données transmises par des API, car il permet de représenter des octets en caractères ASCII sûrs pour les systèmes textuels.
• L'usage de FROM_BASE64 simplifie l'ingestion de données encodées : Lorsqu'une base de données ou un flux de données externe fournit des données encodées en Base64, cette fonction permet de les décoder directement dans BigQuery, évitant ainsi des traitements additionnels en amont ou hors plateforme.
• Le décodage respecte le padding Base64 avec des "=" si nécessaire : Le format Base64 utilise des signes "=" pour compléter la chaîne à un multiple de 4 caractères. FROM_BASE64 gère correctement ce padding, assurant un décodage fiable même si la chaîne d'origine n'est pas un multiple exact d'octets.
• Il est essentiel que les données entrantes soient bien encodées en Base64 : Passer une chaîne non conforme au format Base64 à FROM_BASE64 provoquera une erreur. Il est donc important de valider ou nettoyer les données avant leur décodage pour éviter les interruptions dans les traitements.