BASE64_ENCODE （Transact-SQL）
適用於：
Microsoft Fabric 中的 Azure SQL 資料庫 SQL 分析端點和倉儲
BASE64_ENCODE會將 varbinary 的值轉換成 base64 編碼的 varchar。
語法
BASE64_ENCODE (expression [, url_safe])
引數
expression
varbinary 類型的表達式 （n | max）
url_safe
選擇性的整數常值或表達式，指定編碼作業的輸出是否應為URL安全。 評估為 true 以外的 0 任何數位。 預設值是 0。
傳回類型
- Varchar（8000）
- 如果輸入為 varbinary（max） 的 Varchar（max）
- 如果輸入為 varchar（n） ，其中 n > 6000，Varchar（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
在下列範例中，簡單的 varbinary 是 base64 編碼。
SELECT Base64_Encode(0xA9) as "Encoded © symbol";
結果集如下所示。
------------
qQ==
(1 row affected)
B. BASE64_ENCODE字串
在下列範例中，字串是以base64編碼。 字串必須先轉換成 varbinary。
SELECT BASE64_ENCODE (CAST ('hello world' as varbinary))
結果集如下所示。
------------
aGVsbG8gd29ybGQ=
(1 row affected)
C. 默認BASE64_ENCODE與url_safe
在下列範例中，第一個選取不會指定 url_safe，但第二個選取會指定 url_safe。
SELECT BASE64_ENCODE(0xCAFECAFE)
結果集如下所示。
------------
yv7K/g==
(1 row affected)
下列範例會指定輸出為URL安全。
SELECT BASE64_ENCODE(0xCAFECAFE, 1);
結果集如下所示。
------------
yv7K_g
(1 row affected)