TO_BASE64

Syntaxe

Paramètres

Description

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

Remarques

• Conversion universelle pour transmission de données binaires : La fonction TO_BASE64 permet d'encoder des données de type BYTES en une chaîne de caractères STRING au format Base64. Ce format est largement utilisé dans les communications réseau, les APIs, ou les échanges de données entre systèmes, car il convertit du binaire en texte ASCII standard.
• Format très compact et standardisé : Le Base64 produit une sortie plus compacte que Base32, avec une augmentation de taille d'environ 33 % par rapport à la donnée d'origine. Il est également standardisé et reconnu dans la plupart des protocoles modernes comme SMTP, MIME, ou JSON, ce qui garantit une interopérabilité maximale.
• Les chaînes Base64 peuvent inclure des caractères spéciaux sensibles : Contrairement à Base32, Base64 utilise les caractères +, / et =. Ces caractères peuvent poser problème dans certaines URL ou formats XML/JSON, et nécessitent alors un encodage complémentaire (exemple URL encoding). Cela doit être anticipé lors du transfert entre systèmes.
• Nécessite une entrée de type BYTES : La fonction ne traite que des valeurs binaires (BYTES). Si l'utilisateur souhaite encoder une chaîne (STRING), il doit d'abord la convertir avec TO_BYTES(). Omettre cette étape entraîne une erreur de type dans BigQuery.
• Fonction précieuse pour la sérialisation de données : TO_BASE64 est souvent utilisée pour encapsuler des objets binaires dans des documents textuels, comme l'entreposage de fichiers (images, PDF, sons) dans des colonnes de type texte ou leur transmission via des services Web. Cela permet de traiter du contenu binaire dans des environnements textuels.
• Compatible avec la fonction FROM_BASE64 : BigQuery fournit également une fonction inverse appelée FROM_BASE64 permettant de retransformer le texte encodé en données binaires (BYTES). Cette réversibilité rend l'encodage Base64 pratique pour le chiffrement léger, le hachage visible ou la transmission temporaire de données sensibles.
• Peut être utilisée pour créer des identifiants ou des jetons lisibles : Bien que le Base64 ne soit pas conçu pour l'affichage humain, il est souvent employé dans la génération de jetons d'authentification, de clés API ou de valeurs d'identifiant. Sa lisibilité relative et sa longueur modérée le rendent utile dans des contextes où la compacité compte.
• Attention à la sensibilité à la casse : L'encodage Base64 est sensible à la casse (majuscules et minuscules distinctes) et peut contenir des caractères ambigus. Dans certains systèmes, il est important de ne pas altérer le format ou de tronquer les = finaux (padding), au risque de rendre la décodification impossible.