適用於：
Azure SQL 資料庫SQL 分析端點與倉庫 在 Microsoft Fabric中 Microsoft Fabric 中的 SQL 資料庫
BASE64_ENCODE 將 varbinary 運算式的值轉換為 base64 編碼的 varchar 運算式。
語法
BASE64_ENCODE (expression [ , url_safe ] )
引數
expression
varbinary（n） 或 varbinary（max） 類型的運算式。
url_safe
選擇性的整數常值或表達式，指定編碼作業的輸出是否應為URL安全。 評估為 true 以外的 0 任何數位。 預設值是 0。
傳回類型
-
varchar（8000） 如果 輸入是 varbinary（n） 其中
n<= 6000。 -
varchar（max） 如果輸入是 varbinary（n），
n>則為 6000。 - varchar（max） 如果 輸入是 varbinary（max） 。
- 如果輸入表示式為
NULL，則輸出為NULL。
備註
編碼的字串字母是 RFC 4648 表 1 的字串字母，可能會新增填補。 URL 安全輸出會使用 RFC 4648 表 2 的 base64url 字母，而且不會新增填補。 此函式不會新增任何新的行字元。
在每個案例中，都會使用資料庫預設定序。 如需 Microsoft Fabric 中支援定序的詳細資訊，請參閱 數據表。
如果 url_safe 為 true，則產生的base64url字串與 SQL Server 的 XML 和 JSON base64 譯碼器不相容。
範例
A. 標準BASE64_ENCODE
下列範例會傳回符號的 © base64 編碼值。
SELECT Base64_Encode(0xA9) AS "Encoded © symbol";
結果集如下所示。
qQ==
B. BASE64_ENCODE字串
在下列範例中，字串是以base64編碼。 字串必須先轉換成 varbinary。
SELECT BASE64_ENCODE(CAST ('hello world' AS VARBINARY));
結果集如下所示。
aGVsbG8gd29ybGQ=
C. 默認BASE64_ENCODE與url_safe
在下列範例中，第一個選取不會指定 url_safe;不過，第二個選取會指定 url_safe。
SELECT BASE64_ENCODE(0xCAFECAFE);
結果集如下所示。
yv7K/g==
下列範例會指定輸出為URL安全。
SELECT BASE64_ENCODE(0xCAFECAFE, 1);
結果集如下所示。
yv7K_g