Compartilhar via

BASE64_ENCODE (Transact-SQL)

Aplica-se a: Ponto de extremidade de análise de SQL do Banco de DadosSQL do Azure e Warehouse no Microsoft Fabric

BASE64_ENCODE converte o valor de uma expressão varbinary em uma expressão de varchar codificada em base64.

Convenções de sintaxe de Transact-SQL

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 de inteiro 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 true. O valor padrão é 0.

Tipos de retorno

  • varchar(8000) se a entrada for varbinary(n) em que n<= 6000.
  • varchar(max) se a entrada for varbinary(n) em que 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

O alfabeto de cadeia de caracteres codificado é o de rfc 4648 tabela 1 e pode adicionar preenchimento. A saída segura de URL usa o alfabeto base64url da RFC 4648 Tabela 2 e não adiciona preenchimento. Essa função não adiciona novos caracteres de linha.

Em cada caso, a ordenação padrão do banco de dados é usada. Para obter mais informações sobre as ordenações com suporte no Microsoft Fabric, confira Tabelas.

Se url_safe for true, a cadeia de caracteres base64url gerada será incompatível com os decodificadores XML e JSON base64 do SQL Server.

Exemplos

a. BASE64_ENCODE padrão

O exemplo a seguir retorna o valor codificado em base64 para o símbolo ©.

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

Veja a seguir o conjunto de resultados.

qQ==

B. BASE64_ENCODE uma cadeia de caracteres

No exemplo a seguir, uma cadeia de caracteres é codificada em base64. A cadeia de caracteres deve primeiro ser convertida em um varbinary.

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

Veja a seguir o conjunto de resultados.

aGVsbG8gd29ybGQ=

C. BASE64_ENCODE padrão vs url_safe

No exemplo a seguir, a primeira seleção não especifica url_safe; no entanto, a segunda seleção especifica url_safe.

SELECT BASE64_ENCODE(0xCAFECAFE);

Veja a seguir o conjunto de resultados.

yv7K/g==

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

SELECT BASE64_ENCODE(0xCAFECAFE, 1);

Veja a seguir o conjunto de resultados.

yv7K_g

Conteúdo relacionado