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.

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:

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                                |
+----------------------+-----------------------------------------+

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                            |
+------------------+-----------------------------------------+

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 em um valor binário com o formato UTF-8, é possível 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                   |
+----+------------------------+

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 ❄                               |
+-------------------------------------+

Como obter o resumo MD5 em base64¶

Converta o resumo MD5 binário em uma cadeia de caracteres base64 usando TO_CHAR:

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==          |
+----------+-----------------------------------+

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                 |
+-------------------------+----------------------+

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                 |
+------------------+------------------------+

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 analisada com o formato fornecido.

Converta os resultados do exemplo anterior de volta para cadeias de caracteres usando SUBSTR 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             |
+------------------------+------------------+

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. Essa não é a maneira mais eficiente de trabalhar, mas é muito poderosa.

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

CREATE OR REPLACE 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;';

SELECT c1, my_decoder(c1) FROM bin;

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