Teilen über

BASE64_ENCODE (Transact-SQL)

Gilt für: SQL Server 2025 (17.x) Azure SQL-DatenbankAzure SQL Managed InstanceSQL SQL Analytics-Endpunkt in Microsoft Fabric und Warehouse in Microsoft FabricSQL-Datenbank in Microsoft Fabric in Microsoft Fabric

BASE64_ENCODE konvertiert den Wert eines varbinären 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

Die codierte Zeichenfolge verwendet das Alphabet aus RFC 4648 Tabelle 1 und kann Einen Abstand enthalten. Die URL-sichere Ausgabe verwendet das Base64URL-Alphabet aus RFC 4648 Tabelle 2 und enthält keinen Abstand. 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 Sie auf "true" festgelegt haben url_safe , 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 &copy; Symbol zurückgegeben.

SELECT BASE64_ENCODE(0xA9) AS "Encoded &copy; symbol";

Hier sehen Sie das Ergebnis.

qQ==

B. BASE64_ENCODE für eine Zeichenfolge

Im folgenden Beispiel ist eine Zeichenfolge base64-codiert. Sie müssen die Zeichenfolge zuerst in ein Varbinary umwandeln.

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 SELECT Anweisung nicht an url_safe; die zweite SELECT Anweisung gibt url_safejedoch an.

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

  • Last updated on