BASE64_ENCODE (Transact-SQL)

A következőkre vonatkozik: SQL Server 2025 (17.x) Azure SQL DatabaseAzure SQL Managed InstanceSQL Analytics-végpont a Microsoft Fabricben és a Microsoft Fabric SQL Database-ben a Microsoft FabricSQL Database-ben

BASE64_ENCODE Egy varbináris kifejezés értékét Base64 kódolású varchar-kifejezéssé alakítja.

Transact-SQL szintaxis konvenciói

Szintaxis

BASE64_ENCODE (expression [ , url_safe ] )

Érvek

kifejezés

varbinary(n) vagy varbinary(max)kifejezés.

url_safe

Nem kötelező egész szám literál vagy kifejezés, amely meghatározza, hogy a kódoló művelet kimenetének URL-biztonságosnak kell-e lennie. A 0 kivételével bármely szám igaz értéket ad vissza. Az alapértelmezett érték a 0.

Visszatérési típusok

• varchar(8000), ha a bemenet varbinary(n) ahol n<= 6000.
• varchar(max), ha a bemenet varbinary(n), ahol n> 6000.
• varchar(max), ha a bemenet varbinary(max).
• Ha a bemeneti kifejezés NULL, a kimenet NULL.

Megjegyzések

A kódolt sztring az RFC 4648 1. táblázatából származó ábécét használja, és tartalmazhat kitöltést is. Az URL-biztonságos kimenet a Base64URL ábécét használja az RFC 4648 2. táblázatából , és nem tartalmazza a kitöltést. Ez a függvény nem ad hozzá új sorkarakterek.

A rendszer minden esetben az adatbázis alapértelmezett rendezést használja. A Microsoft Fabricben támogatott rendezésekkel kapcsolatos további információkért lásd: Táblák.

Ha igaz értékre állítja url_safe , a létrehozott Base64URL sztring nem kompatibilis az SQL Server XML- és JSON Base64-dekódolóival.

Példák

Egy. Szabványos BASE64_ENCODE

Az alábbi példa a szimbólum Base64 kódolású értékét © adja vissza.

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

Itt van az eredményhalmaz.

qQ==

B. sztring BASE64_ENCODE

Az alábbi példában egy sztring base64 kódolású. Először a sztringet egy varbinárisra kell öntötte.

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

Itt van az eredményhalmaz.

aGVsbG8gd29ybGQ=

C. BASE64_ENCODE alapértelmezett és url_safe

Az alábbi példában az első SELECT utasítás nem adja meg url_safe, a második SELECT utasítás azonban nem adja meg url_safe.

SELECT BASE64_ENCODE(0xCAFECAFE);

Itt van az eredményhalmaz.

yv7K/g==

Az alábbi példa azt határozza meg, hogy a kimenet URL-biztonságos.

SELECT BASE64_ENCODE(0xCAFECAFE, 1);

Itt van az eredményhalmaz.

yv7K_g

Kapcsolódó tartalom

• BASE64_DECODE (Transact-SQL)