Como usar dados binários¶

A utilidade e a flexibilidade do tipo de dados BINARY é melhor demonstrada pelo exemplo. Este tópico fornece exemplos práticos de tarefas que envolvem o tipo de dados BINARY e seus três esquemas de codificação.

Neste tópico:

Conversão entre hexadecimal e base64¶

O tipo de dados BINARY pode ser usado como um passo intermediário na conversão entre cadeias de caracteres hexadecimais e base64.

Converta de hexadecimal para base64 usando TO_CHAR , TO_VARCHAR:

SELECT c1, to_char(to_binary(c1, 'hex'), 'base64') FROM hex_strings;

+----------------------+-----------------------------------------+
| C1                   | TO_CHAR(TO_BINARY(C1, 'HEX'), 'BASE64') |
|----------------------+-----------------------------------------|
| df32ede209ed5a4e3c25 | 3zLt4gntWk48JQ==                        |
| AB4F3C421B           | q088Qhs=                                |
| 9324df2ecc54         | kyTfLsxU                                |
+----------------------+-----------------------------------------+

Copy

Converta de base64 em hexadecimal:

SELECT c1, to_char(to_binary(c1, 'base64'), 'hex') FROM base64_strings;

+------------------+-----------------------------------------+
| C1               | TO_CHAR(TO_BINARY(C1, 'BASE64'), 'HEX') |
|------------------+-----------------------------------------|
| 3zLt4gntWk48JQ== | DF32EDE209ED5A4E3C25                    |
| q088Qhs=         | AB4F3C421B                              |
| kyTfLsxU         | 9324DF2ECC54                            |
+------------------+-----------------------------------------+

Copy

Conversão entre texto e bytes UTF-8¶

As cadeias de caracteres do Snowflake são compostas por caracteres Unicode, enquanto os valores binários são compostos por bytes. Ao converter uma cadeia de caracteres para um valor binário com o formato UTF-8, podemos manipular diretamente os bytes que compõem os caracteres Unicode.

Converta cadeias de caracteres com um único caractere em sua representação UTF-8 em bytes usando TO_BINARY:

SELECT c1, to_binary(c1, 'utf-8') FROM characters;

+----+------------------------+
| C1 | TO_BINARY(C1, 'UTF-8') |
|----+------------------------|
| a  | 61                     |
| é  | C3A9                   |
| ❄  | E29D84                 |
| π  | CF80                   |
+----+------------------------+

Copy

Converta uma sequência de bytes UTF-8 em uma cadeia de caracteres usando TO_CHAR , TO_VARCHAR:

SELECT to_char(X'41424320E29D84', 'utf-8');

+-------------------------------------+
| TO_CHAR(X'41424320E29D84', 'UTF-8') |
|-------------------------------------|
| ABC ❄                               |
+-------------------------------------+

Copy

Como obter o resumo MD5 em base64¶

Converta o hash MD5 binário em uma cadeia de caracteres base64 usando TO_CHAR , TO_VARCHAR:

SELECT to_char(md5_binary(c1), 'base64') FROM variants;

+----------+-----------------------------------+
| C1       | TO_CHAR(MD5_BINARY(C1), 'BASE64') |
|----------+-----------------------------------|
| 3        | 7MvIfktc4v4oMI/Z8qe68w==          |
| 45       | bINJzHJgrmLjsTloMag5jw==          |
| "abcdef" | 6AtQFwmJUPxYqtg8jBSXjg==          |
| "côté"   | H6G3w1nEJsUY4Do1BFp2tw==          |
+----------+-----------------------------------+

Copy

Conversão de binário com formato variável¶

Converta cadeias de caracteres em valores binários usando um formato binário extraído da cadeia de caracteres. A instrução inclui as funções TRY_TO_BINARY e SPLIT_PART:

SELECT c1, try_to_binary(split_part(c1, ':', 2), split_part(c1, ':', 1)) AS binary_value FROM strings;

+-------------------------+----------------------+
| C1                      | BINARY_VALUE         |
|-------------------------+----------------------|
| hex:AB4F3C421B          | AB4F3C421B           |
| base64:c25vd2ZsYWtlCg== | 736E6F77666C616B650A |
| utf8:côté               | 63C3B474C3A9         |
| ???:abc                 | NULL                 |
+-------------------------+----------------------+

Copy

Experimente vários formatos para a conversão:

SELECT c1, coalesce(
  x'00' || try_to_binary(c1, 'hex'),
  x'01' || try_to_binary(c1, 'base64'),
  x'02' || try_to_binary(c1, 'utf-8')) AS binary_value FROM strings;

+------------------+------------------------+
| C1               | BINARY_VALUE           |
|------------------+------------------------|
| ab4f3c421b       | 00AB4F3C421B           |
| c25vd2ZsYWtlCg== | 01736E6F77666C616B650A |
| côté             | 0263C3B474C3A9         |
| 1100             | 001100                 |
+------------------+------------------------+

Copy

Nota

Como as consultas acima usam TRY_TO_BINARY, o resultado será NULL se o formato não for reconhecido ou se a cadeia de caracteres não puder ser comparada com o formato dado.

Converta os resultados do exemplo anterior de volta para cadeias de caracteres usando SUBSTR , SUBSTRING e DECODE:

SELECT c1, to_char(
  substr(c1, 2),
  decode(substr(c1, 1, 1), x'00', 'hex', x'01', 'base64', x'02', 'utf-8')) AS string_value
  FROM bin;

+------------------------+------------------+
| C1                     | STRING_VALUE     |
|------------------------+------------------|
| 00AB4F3C421B           | AB4F3C421B       |
| 01736E6F77666C616B650A | c25vd2ZsYWtlCg== |
| 0263C3B474C3A9         | côté             |
| 001100                 | 1100             |
+------------------------+------------------+

Copy

Decodificação personalizada com JavaScript UDF¶

O tipo de dados BINARY permite o armazenamento de dados arbitrários. Como JavaScript UDFs suportam o tipo de dados via Uint8Array (consulte Introdução a UDFs de JavaScript), é possível implementar uma lógica de decodificação personalizada em JavaScript. Esta não é a maneira mais eficiente de trabalhar, mas é muito poderosa.

Crie uma função que decodifique com base no primeiro byte:

CREATE FUNCTION my_decoder (B binary) RETURNS variant LANGUAGE javascript AS '
  if (B[0] == 0) {
      var number = 0;
      for (var i = 1; i < B.length; i++) {
          number = number * 256 + B[i];
      }
      return number;
  }
  if (B[0] == 1) {
      var str = "";
      for (var i = 1; i < B.length; i++) {
          str += String.fromCharCode(B[i]);
      }
      return str;
  }
  return null;';

Copy

SELECT c1, my_decoder(c1) FROM bin;

+----------------+----------------+
| C1             | MY_DECODER(C1) |
|----------------+----------------|
| 002A           | 42             |
| 0148656C6C6F21 | "Hello!"       |
| 00FFFF         | 65535          |
| 020B1701       | null           |
+----------------+----------------+

Copy