BASE64_ENCODE (Transact-SQL)

Platí na:Azure SQL DatabaseSQL analytics endpoint a Warehouse in Microsoft FabricSQL database in Microsoft Fabric

BASE64_ENCODE převede hodnotu výrazu varbinary na výraz s kódováním base64 varchar.

Transact-SQL konvence syntaxe

Syntax

BASE64_ENCODE (expression [ , url_safe ] )

Argumenty

výrazu

Výraz typu varbinary(n) nebo varbinary(max).

url_safe

Volitelný celočíselná literál nebo výraz, který určuje, jestli má být výstup operace kódování bezpečný pro adresu URL. Jakékoli jiné číslo než 0 se vyhodnotí jako true. Výchozí hodnota je 0.

Návratové typy

• varchar(8000), pokud je vstup varbinary(n) kde n<= 6000.
• varchar(max), pokud je vstup varbinary(n) kde n> 6000.
• varchar(max), pokud je vstup varbinary(max).
• Pokud je vstupní výraz NULL, výstup je NULL.

Poznámky

Zakódovaná řetězcová abeceda je RFC 4648 Table 1 a může přidat odsazení. Výstup bezpečný pro adresy URL používá abecedu base64url RFC 4648 Table 2 a nepřidá odsazení. Tato funkce nepřidá žádné znaky nového řádku.

V každém případě se použije výchozí kolace databáze. Další informace o podporovaných kolacích v Microsoft Fabric najdete v tématu Tabulky.

Pokud je url_safe true, řetězec base64url, který je vygenerován, není kompatibilní s dekodéry XML a JSON Base64 SQL Serveru.

Příklady

A. Standardní BASE64_ENCODE

Následující příklad vrátí zakódovanou hodnotu base64 pro symbol ©.

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

Tady je sada výsledků.

qQ==

B. BASE64_ENCODE řetězec

V následujícím příkladu je řetězec kódován base64. Řetězec musí být nejprve přetypován na varbinární.

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

Tady je sada výsledků.

aGVsbG8gd29ybGQ=

C. BASE64_ENCODE výchozí vs. url_safe

V následujícím příkladu první výběr nezadá url_safe; druhý výběr však určuje url_safe.

SELECT BASE64_ENCODE(0xCAFECAFE);

Tady je sada výsledků.

yv7K/g==

Následující příklad určuje, že výstup je bezpečný pro adresu URL.

SELECT BASE64_ENCODE(0xCAFECAFE, 1);

Tady je sada výsledků.

yv7K_g

Související obsah

• BASE64_DECODE (Transact-SQL)