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.
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 a SQL |
Suporte a SPL |
|
from_base64(x) |
Decodifica uma string codificada em Base64 em dados binários. |
√ |
√ |
|
|
from_base64url(x) |
Decodifica uma string Base64 segura para URL em dados binários. |
√ |
× |
|
|
from_big_endian_64(x) |
Decodifica um bigint a partir de sua representação binária big-endian. |
√ |
× |
|
|
from_hex(x) |
Converte uma string hexadecimal em dados binários. |
√ |
√ |
|
|
length(x) |
Retorna o comprimento dos dados varbinary em bytes ou o número de caracteres em uma string varchar. |
√ |
× |
|
|
md5(x) |
Calcula o hash MD5 de dados binários. |
√ |
√ |
|
|
to_base64(x) |
Codifica dados binários em uma string Base64. |
√ |
√ |
|
|
to_base64url(x) |
Codifica dados binários em uma string Base64 segura para URL. |
√ |
× |
|
|
to_hex(x) |
Converte dados binários em uma string hexadecimal. |
√ |
√ |
|
|
to_big_endian_64(x) |
Codifica um bigint em sua representação binária big-endian. |
√ |
× |
|
|
sha1(x) |
Calcula o hash SHA-1 de dados binários. |
√ |
√ |
|
|
sha256(x) |
Calcula o hash SHA-256 de dados binários. |
√ |
√ |
|
|
sha512(x) |
Calcula o hash SHA-512 de dados binários. |
√ |
√ |
|
|
xxhash64(x) |
Calcula o hash xxHash64 de dados binários. |
√ |
√ |
Função from_base64
A função from_base64 decodifica uma string codificada em Base64 em 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
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 um 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 em dados binários e 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
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 um 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' em 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:
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' em 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 em dados binários big-endian.
-
Instrução de consulta
* | SELECT to_big_endian_64(0) Resultados da consulta:
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:
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:
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:
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:
