Partager via


BASE64_ENCODE (Transact-SQL)

S’applique à : point de terminaison d’analytique SQL Azure SQL Databaseet 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)n<= 6000.
  • varchar(max) si l’entrée est varbinary(n)n> 6000.
  • varchar(max) si l’entrée est varbinary(max).
  • Si l’expression d’entrée est NULL, la sortie est NULL.

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
  • BASE64_DECODE (Transact-SQL)