BASE64_ENCODE (Transact-SQL)

Vonatkozik a következőkre:Azure SQL DatabaseSQL analytics endpoint and Warehouse in Microsoft FabricSQL database in Microsoft Fabric

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 ábécéje RFC 4648 Table 1, és tartalmazhat kitöltést. Az URL-biztonságos kimenet RFC 4648 Table 2 base64url betűjét használja, és nem ad hozzá 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 url_safe igaz, a létrehozott base64url sztring nem kompatibilis az SQL Server XML- és JSON base64-dekódereivel.

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ú. A sztringet először varbinárisra kell öntöttetni.

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ő kijelölés nem adja meg a url_safe; a második kijelölés azonban url_safead meg.

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)