BASE64_ENCODE (Transact-SQL)

S’applique à : Point de terminaison d’analyse SQL Server 2025 (17.x) Azure SQL DatabaseAzure SQL Managed InstanceSQL dans Microsoft Fabric et Warehouse dans labase de données Microsoft Fabric SQL dans Microsoft Fabric

BASE64_ENCODE convertit la valeur d’une expression varbinary en expression varchar codée en Base64.

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 est NULL.

Notes

La chaîne encodée utilise l’alphabet de RFC 4648 Table 1 et peut inclure le remplissage. La sortie sécurisée par URL utilise l’alphabet Base64URL de RFC 4648 Table 2 et n’inclut 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 vous définissez url_safe 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. Vous devez d’abord convertir la chaîne 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 SELECT instruction ne spécifie url_safepas ; toutefois, la deuxième SELECT instruction 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

Contenu connexe

• BASE64_DECODE (Transact-SQL)