Aracılığıyla paylaş


BASE64_ENCODE (Transact-SQL)

Şunlar için geçerlidir:Azure SQL DatabaseSQL analytics endpoint and Warehouse in Microsoft FabricSQL database

BASE64_ENCODE, varbinary ifadesinin değerini base64 kodlanmış varchar ifadeye dönüştürür.

Transact-SQL söz dizimi kuralları

Sözdizimi

BASE64_ENCODE (expression [ , url_safe ] )

Bağımsız değişken

ifade

varbinary( n) veyavarbinary(max) türünde bir ifade.

url_safe

Kodlama işleminin çıkışının URL güvenli olup olmayacağını belirten isteğe bağlı tamsayı değişmez değeri veya ifadesi. 0 dışındaki herhangi bir sayı true olarak değerlendirilir. Varsayılan değer 0.

Dönüş türleri

  • varchar(8000) giriş varbinary(n) ise burada n<= 6000 olur.
  • Girişin varbinary(n)n 6000 olduğunda varchar(max) >.
  • Girişin varbinary(max) varchar(max).
  • Giriş ifadesi NULLise çıkış NULLolur.

Açıklamalar

Kodlanmış dize alfabesi, RFC 4648 Tablo 1 ve doldurma ekleyebilir. URL güvenli çıktı, RFC 4648 Tablo 2 base64url alfabesini kullanır ve doldurma eklemez. Bu işlev yeni satır karakteri eklemez.

Her durumda, veritabanı varsayılan harmanlaması kullanılır. Microsoft Fabric'te desteklenen harmanlamalar hakkında daha fazla bilgi için bkz. tablo .

url_safe true ise, oluşturulan base64url dizesi SQL Server'ın XML ve JSON base64 kod çözücüleriyle uyumsuzdur.

Örnekler

A. Standart BASE64_ENCODE

Aşağıdaki örnek, &copy; simgesi için base64 kodlanmış değerini döndürür.

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

Sonuç kümesi aşağıdadır.

qQ==

B. Dize BASE64_ENCODE

Aşağıdaki örnekte, bir dize base64 kodlanmıştır. Dizenin önce bir varbinary'ye atanması gerekir.

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

Sonuç kümesi aşağıdadır.

aGVsbG8gd29ybGQ=

C. BASE64_ENCODE varsayılan ile url_safe karşılaştırması

Aşağıdaki örnekte, ilk seçim url_safebelirtmez; ancak, ikinci seçim url_safebelirtir.

SELECT BASE64_ENCODE(0xCAFECAFE);

Sonuç kümesi aşağıdadır.

yv7K/g==

Aşağıdaki örnek, çıkışın URL güvenli olduğunu belirtir.

SELECT BASE64_ENCODE(0xCAFECAFE, 1);

Sonuç kümesi aşağıdadır.

yv7K_g