Delen via


BASE64_ENCODE (Transact-SQL)

Van toepassing op: SQL Server 2025 (17.x) Azure SQL DatabaseAzure SQL Managed InstanceSQL Analytics-eindpunt in Microsoft Fabric en Warehouse in Microsoft FabricSQL Database in Microsoft Fabric SQL Database in Microsoft Fabric

BASE64_ENCODE converteert de waarde van een varbinaire expressie naar een met Base64 gecodeerde varchar-expressie .

Transact-SQL syntaxisconventies

Syntaxis

BASE64_ENCODE (expression [ , url_safe ] )

Argumenten

expressie

Een expressie van het type varbinary(n) of varbinary(max).

url_safe

Optionele letterlijke waarde of expressie voor gehele getallen, waarmee wordt aangegeven of de uitvoer van de coderingsbewerking URL-veilig moet zijn. Een ander getal dan 0 resulteert in waar. De standaardwaarde is 0.

Retourtypen

  • varchar(8000) als de invoer varbinary(n) waarbij n<= 6000.
  • varchar(max) als de invoer varbinary(n) waarbij n> 6000.
  • varchar(max) als de invoer varbinary(max)is.
  • Als de invoerexpressie NULLis, wordt de uitvoer NULL.

Opmerkingen

De gecodeerde tekenreeks maakt gebruik van het alfabet van RFC 4648 Tabel 1 en kan opvulling bevatten. De URL-veilige uitvoer maakt gebruik van het Base64URL-alfabet van RFC 4648 Tabel 2 en bevat geen opvulling. Met deze functie worden geen nieuwe regeltekens toegevoegd.

In elk geval wordt de standaardsortering van de database gebruikt. Zie Tabellenvoor meer informatie over de ondersteunde sorteringen in Microsoft Fabric.

Als u op true instelt url_safe , is de gegenereerde Base64URL-tekenreeks niet compatibel met de XML- en JSON Base64-decoders van SQL Server.

Voorbeelden

Een. Standard-BASE64_ENCODE

In het volgende voorbeeld wordt de met Base64 gecodeerde waarde voor het &copy; symbool geretourneerd.

SELECT BASE64_ENCODE(0xA9) AS "Encoded &copy; symbol";

Dit is de resultatenset.

qQ==

B. een tekenreeks BASE64_ENCODE

In het volgende voorbeeld is een tekenreeks met Base64 gecodeerd. U moet de tekenreeks eerst casten naar een varbinary.

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

Dit is de resultatenset.

aGVsbG8gd29ybGQ=

C. BASE64_ENCODE standaard versus url_safe

In het volgende voorbeeld geeft de eerste SELECT instructie niet op url_safe; de tweede SELECT instructie geeft echter wel url_safeop.

SELECT BASE64_ENCODE(0xCAFECAFE);

Dit is de resultatenset.

yv7K/g==

In het volgende voorbeeld wordt aangegeven dat de uitvoer URL-veilig is.

SELECT BASE64_ENCODE(0xCAFECAFE, 1);

Dit is de resultatenset.

yv7K_g