BASE64_ENCODE (Transact-SQL)

Gilt für:Azure SQL DatabaseSQL Analytics Endpunkt und Warehouse in Microsoft Fabric SQL databasein Microsoft Fabric

BASE64_ENCODE konvertiert den Wert eines varbinary Ausdrucks in einen base64-codierten varchar- Ausdruck.

Transact-SQL-Syntaxkonventionen

Syntax

BASE64_ENCODE (expression [ , url_safe ] )

Argumente

expression

Ein Ausdruck vom Typ varbinary(n) oder varbinary(max).

url_safe

Optionaler ganzzahliger Literal oder Ausdruck, der angibt, ob die Ausgabe des Codierungsvorgangs URL-sicher sein soll. Jede andere Zahl als 0 wird als TRUE ausgewertet. Standardwert: 0.

Rückgabetypen

• varchar(8000), wenn die Eingabe varbinary(n), wobei n<= 6000.
• varchar(max), wenn die Eingabe varbinary(n), wobei n> 6000.
• varchar(max), wenn die Eingabe varbinary(max)ist.
• Wenn der Eingabeausdruck NULL ist, ist die Ausgabe NULL.

Bemerkungen

Das codierte Zeichenfolgen-Alphabet ist das von RFC 4648 Tabelle 1 und kann Abstand hinzufügen. Die URL-sichere Ausgabe verwendet das Base64url-Alphabet von RFC 4648-Tabelle 2 und fügt keine Auffüllung hinzu. Diese Funktion fügt keine Zeilenvorschubzeichen hinzu.

In jedem Fall wird die Standardsortierung der Datenbank verwendet. Weitere Informationen zu den unterstützten Sortierungen in Microsoft Fabric finden Sie unter Tabellen.

Wenn url_safe TRUE ist, ist die generierte Base64url-Zeichenfolge nicht mit den XML- und JSON-Base64-Decodern von SQL Server kompatibel.

Beispiele

A. Standard-BASE64_ENCODE

Im folgenden Beispiel wird der base64-codierte Wert für das symbol © zurückgegeben.

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

Hier sehen Sie das Ergebnis.

qQ==

B. BASE64_ENCODE für eine Zeichenfolge

Im folgenden Beispiel wird eine Zeichenfolge Base64-codiert. Die Zeichenfolge muss zuerst in den Datentyp varbinary umgewandelt werden.

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

Hier sehen Sie das Ergebnis.

aGVsbG8gd29ybGQ=

C. BASE64_ENCODE: Standard im Vergleich zu url_safe

Im folgenden Beispiel gibt die erste Auswahl nicht url_safean; Die zweite Auswahl gibt jedoch url_safean.

SELECT BASE64_ENCODE(0xCAFECAFE);

Hier sehen Sie das Ergebnis.

yv7K/g==

Im folgenden Beispiel wird angegeben, dass die Ausgabe URL-sicher ist.

SELECT BASE64_ENCODE(0xCAFECAFE, 1);

Hier sehen Sie das Ergebnis.

yv7K_g

Verwandte Inhalte

• BASE64_DECODE (Transact-SQL)