BASE64_ENCODE (Transact-SQL)

Aplica-se a: SQL Server 2025 (17.x) Azure SQL Database AzureSQL ManagedInstance SQL Analytics endpoint em Microsoft Fabric e Warehouse em Microsoft Fabric Basede dados SQL no Microsoft Fabric

BASE64_ENCODE converte o valor de uma expressão varbinária numa expressão varchar codificada em Base64.

Transact-SQL convenções de sintaxe

Sintaxe

BASE64_ENCODE (expression [ , url_safe ] )

Argumentos

expressão

Uma expressão do tipo varbinary(n) ou varbinary(max).

url_safe

Literal ou expressão inteira opcional, que especifica se a saída da operação de codificação deve ser segura para URL. Qualquer número diferente de 0 é avaliado como verdadeiro. O valor padrão é 0.

Tipos de devolução

• varchar(8000) se a entrada for varbinary(n) onde n<= 6000.
• varchar(max) se a entrada for varbinary(n) onde n> 6000.
• varchar(max) se a entrada for varbinary(max).
• Se a expressão de entrada for NULL, a saída será NULL.

Comentários

A cadeia codificada utiliza o alfabeto da Tabela 1 do RFC 4648 e pode incluir enchimento (padding). A saída segura para URL usa o alfabeto Base64URL da Tabela 2 do RFC 4648 e não inclui preenchimento (padding). Esta função não adiciona novos caracteres de linha.

Em cada caso, o agrupamento padrão do banco de dados é usado. Para obter mais informações sobre os agrupamentos suportados no Microsoft Fabric, consulte Tabelas.

Se definires url_safe para true, a string Base64URL gerada não é compatível com os descodificadores XML e JSON Base64 do SQL Server.

Exemplos

Um. BASE64_ENCODE padrão

O exemplo seguinte devolve o valor codificado em Base64 para o © símbolo.

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

Aqui está o conjunto de resultados.

qQ==

B. BASE64_ENCODE uma cadeia de caracteres

No exemplo seguinte, uma cadeia é codificada em Base64. Deves primeiro fundir a corda para um varbinário.

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

Aqui está o conjunto de resultados.

aGVsbG8gd29ybGQ=

C. BASE64_ENCODE padrão vs url_safe

No exemplo seguinte, a primeira SELECT afirmação não especifica url_safe; no entanto, a segunda SELECT afirmação especifica url_safe.

SELECT BASE64_ENCODE(0xCAFECAFE);

Aqui está o conjunto de resultados.

yv7K/g==

O exemplo a seguir especifica que a saída é segura para URL.

SELECT BASE64_ENCODE(0xCAFECAFE, 1);

Aqui está o conjunto de resultados.

yv7K_g

Conteúdo relacionado

• BASE64_DECODE (Transact-SQL)