BASE64_ENCODE (Transact-SQL)

Platí pro: Koncový bod analýzy SQL azureSQL Database Azure SQL Database 2025 (17.x) v Microsoft Fabric a Warehouse v databázi MicrosoftFabric SQL v Microsoft Fabric

BASE64_ENCODEpřevede hodnotu varbinárního výrazu na výraz s kódováním Base64.

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

Kódovaný řetězec používá abecedu z RFC 4648 Table 1 a může obsahovat odsazení. Výstup bezpečný pro adresy URL používá abecedu Base64URL z tabulky RFC 4648 Table 2 a nezahrnuje 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 nastavíte url_safe hodnotu true, vygenerovaný řetězec Base64URL 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. Nejprve je nutné přetypovat řetězec na varbinary.

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í SELECT příkaz nezadává url_safe; druhý SELECT příkaz 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)