BASE64_ENCODE (T-SQL)

Berlaku untuk:Titikakhir analitik SQL Azure SQL Database dan Gudang di 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

Alfabet string yang dikodekan adalah alfabet string RFC 4648 Table 1 dan mungkin menambahkan padding. Output url-safe menggunakan alfabet base64url dari RFC 4648 Table 2 dan tidak menambahkan 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 url_safe benar, 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 ©.

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

Berikut set hasilnya.

qQ==

B. BASE64_ENCODE string

Dalam contoh berikut, string dikodekan base64. String harus terlebih dahulu ditransmisikan ke varbinary.

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

Berikut set hasilnya.

aGVsbG8gd29ybGQ=

C. BASE64_ENCODE default vs url_safe

Dalam contoh berikut, pilihan pertama tidak menentukan url_safe; namun, pilihan kedua 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)