Bagikan melalui

BASE64_ENCODE (T-SQL)

Berlaku untuk: Titik akhir analitik SQL Server 2025 (17.x) Azure SQL DatabaseAzure SQL Managed InstanceSQL di Microsoft Fabric dan Gudang dalam database Microsoft FabricSQL di Microsoft Fabric

BASE64_ENCODE mengonversi nilai ekspresi varbinary menjadi ekspresi varchar yang dikodekan Base64.

Konvensi sintaks transact-SQL

Sintaks

BASE64_ENCODE (expression [ , url_safe ] )

Argumen

expression

Ekspresi jenis varbinary(n) atau varbinary(max).

url_safe

Literal atau ekspresi bilangan bulat opsional, yang menentukan apakah output operasi pengodean harus aman untuk URL. Angka apa pun selain 0 mengevaluasi ke true. Nilai defaultnya adalah 0.

Jenis yang dikembalikan

  • varchar(8000) jika input varbinary(n) di mana n<= 6000.
  • varchar(maks) jika input varbinary(n) di mana n> 6000.
  • varchar(max) jika input varbinary(max).
  • Jika ekspresi input adalah NULL, outputnya adalah NULL.

Keterangan

String yang dikodekan menggunakan alfabet dari RFC 4648 Table 1 dan mungkin termasuk padding. Output url-safe menggunakan alfabet Base64URL dari RFC 4648 Table 2 dan tidak termasuk padding. Fungsi ini tidak menambahkan karakter baris baru.

Dalam setiap kasus, kolatasi default database digunakan. Untuk informasi selengkapnya tentang kolatasi yang didukung di Microsoft Fabric, lihat Tabel.

Jika Anda mengatur url_safe ke true, string Base64URL yang dihasilkan tidak kompatibel dengan dekoder XML dan JSON Base64 SQL Server.

Contoh

J. BASE64_ENCODE standar

Contoh berikut mengembalikan nilai yang dikodekan Base64 untuk simbol .&copy;

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

Berikut set hasilnya.

qQ==

B. BASE64_ENCODE string

Dalam contoh berikut, string dikodekan Base64. Anda harus terlebih dahulu melemparkan string ke varbinary.

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

Berikut set hasilnya.

aGVsbG8gd29ybGQ=

C. BASE64_ENCODE default vs url_safe

Dalam contoh berikut, pernyataan pertama SELECT tidak menentukan url_safe; namun, pernyataan kedua SELECT menentukan url_safe.

SELECT BASE64_ENCODE(0xCAFECAFE);

Berikut set hasilnya.

yv7K/g==

Contoh berikut menentukan bahwa output aman untuk URL.

SELECT BASE64_ENCODE(0xCAFECAFE, 1);

Berikut set hasilnya.

yv7K_g

Konten terkait

  • BASE64_DECODE (Transact-SQL)
  • Last updated on