Todos os produtos
Search
Central de documentação

Simple Log Service:Funções binárias

Última atualização: Jul 31, 2026

Este tópico descreve a sintaxe das funções binárias e apresenta exemplos.

O Simple Log Service oferece suporte às seguintes funções binárias.

Importante
  • Em uma instrução de consulta do Simple Log Service, as strings devem estar entre aspas simples ('). Literais sem aspas ou entre aspas duplas (") representam nomes de campos ou colunas. Por exemplo, 'status' é a string 'status', enquanto status ou "status" refere-se ao campo de log status.

  • varbinary é um tipo de caractere binário e varchar é um tipo de caractere de comprimento variável.

Função

Sintaxe

Descrição

Suporte SQL

Suporte SPL

from_base64 function

from_base64(x)

Decodifica uma string codificada em Base64 para dados binários.

from_base64url function

from_base64url(x)

Decodifica uma string Base64 segura para URL em dados binários.

×

from_big_endian_64 function

from_big_endian_64(x)

Decodifica um bigint a partir de sua representação binária big-endian.

×

from_hex function

from_hex(x)

Converte uma string hexadecimal em dados binários.

length function

length(x)

Retorna o comprimento dos dados varbinary em bytes ou o número de caracteres em uma string varchar.

×

md5 function

md5(x)

Calcula o hash MD5 de dados binários.

to_base64 function

to_base64(x)

Codifica dados binários em uma string Base64.

to_base64url function

to_base64url(x)

Codifica dados binários em uma string Base64 segura para URL.

×

to_hex function

to_hex(x)

Converte dados binários em uma string hexadecimal.

to_big_endian_64 function

to_big_endian_64(x)

Codifica um bigint em sua representação binária big-endian.

×

sha1 function

sha1(x)

Calcula o hash SHA-1 de dados binários.

sha256 function

sha256(x)

Calcula o hash SHA-256 de dados binários.

sha512 function

sha512(x)

Calcula o hash SHA-512 de dados binários.

xxhash64 function

xxhash64(x)

Calcula o hash xxHash64 de dados binários.

aes_encrypt(data, key, iv, mode, pad_style)

Criptografa dados binários usando criptografia AES.

aes_decrypt(data, key, iv, mode, pad_style)

Descriptografa dados binários criptografados com AES.

Função from_base64

A função from_base64 decodifica uma string codificada em Base64 para dados binários.

Syntax

from_base64(x)

Parameters

Parâmetro

Descrição

x

Uma string varchar. Esta string deve estar codificada em Base64.

Return value type

varbinary

Importante

O tipo varbinary pode conter caracteres invisíveis. O console do Simple Log Service exibe o resultado no formato Base64.

  • Para visualizar um valor de retorno com caracteres invisíveis, use a função to_hex para convertê-lo em uma string hexadecimal.

  • Se o valor de retorno contiver apenas caracteres visíveis, use a função from_utf8 para convertê-lo em uma string UTF-8.

Examples

Decodifique uma string codificada em Base64 para dados binários e, em seguida, converta os dados binários em uma string hexadecimal.

  • Instrução de consulta

    * | SELECT to_hex(from_base64('c2xz'))
  • Resultados da consulta: O valor da coluna _col0 é 736C73.

Função from_base64url

A função from_base64url decodifica uma string Base64 segura para URL em dados binários.

Syntax

from_base64url(x)

Parameters

Parâmetro

Descrição

x

Uma string varchar. Esta string deve ser codificada em Base64 e segura para URL.

Return value type

varbinary

Importante

O tipo varbinary pode conter caracteres invisíveis. O console do Simple Log Service exibe o resultado no formato Base64.

  • Para visualizar um valor de retorno com caracteres invisíveis, use a função to_hex para convertê-lo em uma string hexadecimal.

  • Se o valor de retorno contiver apenas caracteres visíveis, use a função from_utf8 para convertê-lo em uma string UTF-8.

Examples

Decodifique uma string Base64 segura para URL em dados binários.

  • Instrução de consulta

    * | SELECT to_hex(from_base64url('c2xz'))
  • Resultados da consulta: O valor da coluna _col0 é 736C73.

Função from_big_endian_64

A função from_big_endian_64 decodifica um bigint a partir de sua representação binária big-endian.

Syntax

from_big_endian_64(x)

Parameters

Parâmetro

Descrição

x

Uma expressão varbinary.

Return value type

bigint

Examples

Converta a representação binária big-endian do número 10 de volta para um número.

  • Instrução de consulta

    * | SELECT from_big_endian_64(to_big_endian_64(10))
  • O resultado é 10.

Função from_hex

A função from_hex converte uma string hexadecimal em dados binários.

Syntax

from_hex(x)

Parameters

Parâmetro

Descrição

x

Uma string varchar hexadecimal.

Return value type

varbinary

Examples

Converta a string hexadecimal 'D74D' para dados binários.

  • Instrução de consulta

    * | SELECT from_hex('D74D')
  • Resultados da consulta: O valor da coluna _col0 é 100=.

Função length

A função length retorna o comprimento dos dados varbinary em bytes ou o número de caracteres em uma string varchar.

Syntax

length(x)

Parameters

Parâmetro

Descrição

x

Uma expressão varbinary ou varchar.

Return value type

bigint

Examples

Calcule o comprimento da string '00101000'.

  • Instrução de consulta

    * | SELECT length('00101000')
  • O resultado é 8.

Função md5

A função md5 calcula o hash MD5 de dados binários.

Syntax

md5(x)

Parameters

Parâmetro

Descrição

x

Uma expressão varbinary.

Return value type

varbinary

Examples

Calcule o hash MD5 dos dados binários decodificados da string Base64 '1101'.

  • Instrução de consulta

    * | SELECT MD5(from_base64('1101')) AS md5
  • Resultados da consulta: O valor da coluna md5 é rG3lOanun9N57opubMnPDw==.

Função to_base64

A função to_base64 codifica dados binários em uma string Base64.

Syntax

to_base64(x)

Parameters

Parâmetro

Descrição

x

Uma expressão varbinary.

Return value type

varchar

Examples

Codifique os dados binários decodificados da string Base64 '10' em uma string Base64.

  • Instrução de consulta

    * | SELECT  to_base64(from_base64('10')) AS base64
  • Resultados da consulta: O valor da coluna base64 é 1w==.

Função to_base64url

A função to_base64url codifica dados binários em uma string Base64 segura para URL.

Syntax

to_base64url(x)

Parameters

Parâmetro

Descrição

x

Uma expressão varbinary.

Return value type

varchar

Examples

Codifique os dados binários decodificados da string Base64 '100' em uma string Base64 segura para URL.

  • Instrução de consulta

    * | SELECT  to_base64url(from_base64('100'))
  • Resultados da consulta: to_base64url

Função to_hex

A função to_hex converte dados binários em uma string hexadecimal.

Syntax

to_hex(x)

Parameters

Parâmetro

Descrição

x

Uma expressão varbinary.

Return value type

varchar

Examples

Converta os dados binários decodificados da string Base64 '100' para uma string hexadecimal.

  • Instrução de consulta

    * | SELECT to_hex(from_base64('100'))
  • Resultados da consulta: O valor da coluna _col0 é D74D.

Função to_big_endian_64

A função to_big_endian_64 codifica um bigint em sua representação binária big-endian.

Syntax

to_big_endian_64(x)

Parameters

Parâmetro

Descrição

x

Uma expressão bigint.

Return value type

varbinary

Examples

Converta o número 0 para dados binários big-endian.

  • Instrução de consulta

    * | SELECT to_big_endian_64(0)
  • Resultados da consulta:to_big_endian_64

Função sha1

A função sha1 calcula o hash SHA-1 de dados binários.

Syntax

sha1(x)

Parameters

Parâmetro

Descrição

x

Uma expressão varbinary.

Return value type

varbinary

Examples

Calcule o hash SHA-1 dos dados binários decodificados da string Base64 '1101'.

  • Instrução de consulta

    * | SELECT sha1(from_base64('1101')) AS sha1
  • Resultados da consulta:sha1

Função sha256

A função sha256 calcula o hash SHA-256 de dados binários.

Syntax

sha256(x)

Parameters

Parâmetro

Descrição

x

Uma expressão varbinary.

Return value type

varbinary

Examples

Calcule o hash SHA-256 dos dados binários decodificados da string Base64 '1101'.

  • Instrução de consulta

    * | SELECT sha256(from_base64('1101')) AS sha256
  • Resultados da consulta:sha256

Função sha512

A função sha512 calcula o hash SHA-512 de dados binários.

Syntax

sha512(x)

Parameters

Parâmetro

Descrição

x

Uma expressão varbinary.

Return value type

varbinary

Examples

Calcule o hash SHA-512 dos dados binários decodificados da string Base64 '1101'.

  • Instrução de consulta

    * | SELECT sha512(from_base64('1101')) AS sha512
  • Resultados da consulta:sha512

Função xxhash64

A função xxhash64 calcula o hash xxHash64 de dados binários.

Syntax

xxhash64(x)

Parameters

Parâmetro

Descrição

x

Uma expressão varbinary.

Return value type

varbinary

Examples

Calcule o hash xxHash64 dos dados binários decodificados da string Base64 '10'.

  • Instrução de consulta

    * | SELECT xxhash64(from_base64('10'))
  • Resultados da consulta:xxhash64

Função aes_encrypt

A função aes_encrypt criptografa dados binários usando criptografia AES. O Advanced Encryption Standard (AES) é um algoritmo de criptografia simétrica amplamente utilizado. Ele oferece suporte a vários modos de criptografia, incluindo CBC, ECB, OFB, CFB e CTR, além de múltiplos estilos de preenchimento.

Syntax

aes_encrypt(data, key, iv, mode, pad_style)

Parameters

Parâmetro

Tipo

Obrigatório

Descrição

data

Binário

Sim

Os dados em texto simples a serem criptografados. Valores não constantes são suportados.

key

Binário

Sim

A chave usada para criptografia.

iv

Binário

Sim

O vetor de inicialização (IV) para criptografia.

mode

String

Não

O modo de criptografia AES. Valor padrão: CBC. Valores válidos: CBC (Cipher Block Chaining), ECB (Electronic Code Book), OFB (Output Feedback), CFB (Cipher Feedback), CTR (Counter).

pad_style

String

Não

O estilo de preenchimento. Este parâmetro só tem efeito em modos de bloco (CBC e ECB). Modos de fluxo (OFB, CFB e CTR) não usam preenchimento. Valor padrão: pkcs7. Valores válidos: pkcs7 (preenchimento PKCS#7), iso7816 (preenchimento ISO 7816), x923 (preenchimento ANSI X.923).

Return value type

Binário

Examples

Exemplo 1: Criptografar dados usando o modo CBC padrão.

Log bruto: {"test":"aliyuntest"}

  • Regra de processamento

    * | extend result=to_base64(aes_encrypt(cast(test as binary), cast('qwertyuiopasdfgd' as binary), cast('xxywosjdapdiawdk' as binary)))
  • Resultado do processamento:

    {
      "result": "gXIqu0cBBtZHQxJBK8GLeA==",
      "test": "aliyuntest"
    }

Exemplo 2: Criptografar dados usando o modo ECB.

Log bruto: {"test":"aliyuntest"}

  • Regra de processamento

    * | extend result=to_base64(aes_encrypt(cast(test as binary), cast('qwertyuiopasdfgd' as binary), cast('xxywosjdapdiawdk' as binary),'ECB'))
  • Resultado do processamento:

    {
      "result": "xh6A2VwoVuojfuA0CHuLBQ==",
      "test": "aliyuntest"
    }

Exemplo 3: Criptografar dados usando o modo de fluxo OFB.

Log bruto: {"test":"aliyuntest"}

  • Regra de processamento

    * | extend result=to_base64(aes_encrypt(cast(test as binary), cast('qwertyuiopasdfgd' as binary), cast('xxywosjdapdiawdk' as binary),'OFB'))
  • Resultado do processamento:

    {
      "result": "lBQuflXuEE2/bQ==",
      "test": "aliyuntest"
    }

Função aes_decrypt

A função aes_decrypt descriptografa dados binários criptografados com AES.

Syntax

aes_decrypt(data, key, iv, mode, pad_style)

Parameters

Parâmetro

Tipo

Obrigatório

Descrição

data

Binário

Sim

Os dados cifrados a serem descriptografados.

key

Binário

Sim

A chave usada para descriptografia.

iv

Binário

Sim

O vetor de inicialização (IV) para descriptografia.

mode

String

Não

O modo de descriptografia AES. Valor padrão: CBC. Valores válidos: CBC (Cipher Block Chaining), ECB (Electronic Code Book), OFB (Output Feedback), CFB (Cipher Feedback), CTR (Counter).

pad_style

String

Não

O estilo de preenchimento. Este parâmetro só tem efeito em modos de bloco (CBC e ECB). Valor padrão: pkcs7. Valores válidos: pkcs7 (preenchimento PKCS#7), iso7816 (preenchimento ISO 7816), x923 (preenchimento ANSI X.923).

Return value type

Binário (bytes de texto simples, exibidos como texto usando codificação UTF-8)

Examples

Exemplo 1: Descriptografar dados criptografados com CBC (entrada Base64).

Log bruto: {"test":"gXIqu0cBBtZHQxJBK8GLeA=="}

  • Regra de processamento

    * | extend result=aes_decrypt(cast(from_base64(test) as binary), cast('qwertyuiopasdfgd' as binary), cast('xxywosjdapdiawdk' as binary))
  • Resultado do processamento:

    {
      "test": "gXIqu0cBBtZHQxJBK8GLeA==",
      "result": "aliyuntest"
    }

Exemplo 2: Descriptografar dados criptografados no modo de fluxo OFB.

Log bruto: {"test": "lBQuflXuEE2/bQ=="}

  • Regra de processamento

    * | extend result=cast(aes_decrypt(cast(from_base64(test) as binary), cast('qwertyuiopasdfgd' as binary), cast('xxywosjdapdiawdk' as binary), 'OFB') as varchar)
  • Resultado do processamento:

    {
      "test": "lBQuflXuEE2/bQ==",
      "result": "aliyuntest"
    }

Exemplo 3: Descriptografar dados criptografados no modo ECB.

Log bruto: {"test": "xh6A2VwoVuojfuA0CHuLBQ=="}

  • Regra de processamento

    * | extend result=cast(aes_decrypt(cast(from_base64(test) as binary), cast('qwertyuiopasdfgd' as binary), cast('xxywosjdapdiawdk' as binary), 'ECB') as varchar)
  • Resultado do processamento:

    {
      "test": "xh6A2VwoVuojfuA0CHuLBQ==",
      "result": "aliyuntest"
    }