Dela via


BASE64_ENCODE (Transact-SQL)

gäller för:Azure SQL DatabaseSQL-analysslutpunkt och -lager i Microsoft Fabric

BASE64_ENCODE konverterar värdet för ett varbinärt uttryck till ett base64-kodat uttryck.

Transact-SQL syntaxkonventioner

Syntax

BASE64_ENCODE (expression [ , url_safe ] )

Argument

uttryck

Ett uttryck av typen varbinary(n) eller varbinary(max).

url_safe

Valfri heltal eller uttryck som anger om utdata från kodningsåtgärden ska vara URL-säkra. Ett annat tal än 0 utvärderas till sant. Standardvärdet är 0.

Returtyper

  • varchar(8000) om indata är varbinary(n) där n<= 6000.
  • varchar(max) om indata är varbinary(n) där n> 6000.
  • varchar(max) om indata är varbinary(max).
  • Om indatauttrycket är NULLär utdata NULL.

Anmärkningar

Det kodade sträng alfabetet är det för RFC 4648 Tabell 1 och kan lägga till utfyllnad. URL-säkra utdata använder base64url-alfabetet för RFC 4648 Tabell 2 och lägger inte till utfyllnad. Den här funktionen lägger inte till några nya radtecken.

I varje fall används databasens standardsortering. Mer information om sortering som stöds i Microsoft Fabric finns i Tables.

Om url_safe är sant är base64url-strängen som genereras inte kompatibel med SQL Server XML- och JSON base64-avkodare.

Exempel

A. Standard BASE64_ENCODE

I följande exempel returneras det base64-kodade värdet för symbolen ©.

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

Här är resultatuppsättningen.

qQ==

B. BASE64_ENCODE en sträng

I följande exempel är en sträng base64-kodad. Strängen måste först castas till en varbinary.

SELECT BASE64_ENCODE(CAST ('hello world' AS VARBINARY));

Här är resultatuppsättningen.

aGVsbG8gd29ybGQ=

C. BASE64_ENCODE standard jämfört med url_safe

I följande exempel anger det första valet inte url_safe; Men det andra valet anger url_safe.

SELECT BASE64_ENCODE(0xCAFECAFE);

Här är resultatuppsättningen.

yv7K/g==

I följande exempel anges att utdata är URL-säkra.

SELECT BASE64_ENCODE(0xCAFECAFE, 1);

Här är resultatuppsättningen.

yv7K_g