Partager via

BASE64_ENCODE (Transact-SQL)

  • Article

S’applique à : point de terminaison d’analytique SQL Azure SQL Database et Warehouse dans Microsoft Fabric

BASE64_ENCODE convertit la valeur d’un varbinary en varchar encodé en base64.

Conventions de la syntaxe Transact-SQL

Syntaxe

BASE64_ENCODE (expression [, url_safe])

Arguments

expression

Une expression de type varbinary (n | 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)
  • Varchar(max) si l’entrée est varbinary(max)
  • Varchar(max) si l’entrée est varchar(n) où n > 6000
  • 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 un 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

Dans l’exemple suivant, varbinary simple est encodé en base64.

SELECT Base64_Encode(0xA9) as "Encoded © symbol";

Voici le jeu de résultats.

------------  
qQ==
(1 row affected)

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=
(1 row affected)

C. BASE64_ENCODE par défaut ou url_safe

Dans l’exemple suivant, la première sélection ne spécifie pas url_safe, mais la deuxième sélection spécifie url_safe.

SELECT BASE64_ENCODE(0xCAFECAFE)

Voici le jeu de résultats.

------------  
yv7K/g==
(1 row affected)

L’exemple suivant spécifie que la sortie est URL-safe.

SELECT BASE64_ENCODE(0xCAFECAFE, 1);

Voici le jeu de résultats.

------------  
yv7K_g
(1 row affected)

Étapes suivantes