BASE64_ENCODE (Transact-SQL)
S’applique à : point de terminaison d’analytique SQL Azure SQL Database
et Warehouse dans Microsoft Fabric
BASE64_ENCODE
convertit la valeur d’une expression varbinary en une expression encodée en base64 varchar.
Conventions de la syntaxe Transact-SQL
Syntaxe
BASE64_ENCODE (expression [ , url_safe ] )
Arguments
expression
Expression de type varbinary(n) ou varbinary(max).
url_safe
Littéral ou expression d’entier facultatif, qui spécifie si la sortie de l’opération d’encodage doit être URL-safe. Tout nombre autre que 0
produit la valeur true. La valeur par défaut est 0
.
Types de retour
-
varchar(8000) si l’entrée est varbinary(n) où
n
<= 6000. -
varchar(max) si l’entrée est varbinary(n) où
n
> 6000. - varchar(max) si l’entrée est varbinary(max).
- Si l’expression d’entrée est
NULL
, la sortie estNULL
.
Notes
L’alphabet de chaîne encodé est celui de RFC 4648 Table 1 et peut ajouter du remplissage. La sortie URL-safe utilise l’alphabet base64url de RFC 4648 Table 2 et n’ajoute pas de remplissage. Cette fonction n’ajoute aucun nouveau caractère de ligne.
Dans chaque cas, le classement par défaut de la base de données est utilisé. Pour plus d’informations sur les classements pris en charge dans Microsoft Fabric, consultez Tables.
Si url_safe
a la valeur true, la chaîne base64url générée n’est pas compatible avec les décodeurs XML et JSON base64 de SQL Server.
Exemples
R. BASE64_ENCODE standard
L’exemple suivant retourne la valeur encodée en base64 pour le symbole ©
.
SELECT Base64_Encode(0xA9) AS "Encoded © symbol";
Voici le jeu de résultats.
qQ==
B. BASE64_ENCODE pour une chaîne
Dans l’exemple suivant, une chaîne est encodée en base64. La chaîne doit d’abord être castée en varbinary.
SELECT BASE64_ENCODE(CAST ('hello world' AS VARBINARY));
Voici le jeu de résultats.
aGVsbG8gd29ybGQ=
C. BASE64_ENCODE par défaut ou url_safe
Dans l’exemple suivant, la première sélection ne spécifie pas url_safe
; toutefois, la deuxième sélection spécifie url_safe
.
SELECT BASE64_ENCODE(0xCAFECAFE);
Voici le jeu de résultats.
yv7K/g==
L’exemple suivant spécifie que la sortie est URL-safe.
SELECT BASE64_ENCODE(0xCAFECAFE, 1);
Voici le jeu de résultats.
yv7K_g