二进制输入和输出¶

hex（默认）¶

“hex”格式是指十六进制或 base16。在这种格式中，每个字节由两个字符表示（从 0 到 9 的数字和从 A 到 F 的字母）。使用 hex 执行转换时：

hex 是默认的二进制格式。

base64¶

“base64”格式将二进制数据（或字符串数据）编码为可打印的 ASCII 字符（字母、数字和标点符号或数学运算符）。（base64 编码方案的定义见 RFC 4648 (https://tools.ietf.org/html/rfc4648)。）

base64 编码的数据具有以下优点：

• 由于 base64 编码的数据是 ASCII 纯文本，因此可以将其存储在支持 ASCII 字符数据但不支持 BINARY 数据的系统中。例如，表示音乐（数字样本）的二进制数据或表示普通话字符的 UTF 数据可以编码为 ASCII 文本，并存储在仅支持 ASCII 字符的系统中。

• 由于 base64 编码的数据不包含控制字符（例如传输结束符、制表符），因此，在传输和接收 base64 编码的数据时，无需担心控制字符会被解释为命令而不是数据。base64 编码的数据与较旧的调制解调器和其他电信设备兼容，这些设备一次发送和接收一个字符的数据，并且没有数据包标头或协议来指示数据包的哪些部分是数据，哪些部分是标头或控制信息。

base64 编码的数据具有以下缺点：

• 在二进制和可打印的 ASCII 表示形式之间来回转换数据会消耗计算资源。

• base64 编码的数据需要的存储空间比原始数据多大约 1/3。

下面为感兴趣的读者提供有关编码的技术详细信息：

UTF-8¶

UTF-8 格式是指 Unicode 的 UTF-8 字符编码。

UTF-8 用于文本到二进制编码。UTF-8 不能用于二进制到文本编码，因为并非所有可能的 BINARY 值都可以转换为有效的 UTF-8 字符串。

这种格式便于在二进制和字符串之间执行一对一的转换，用于将基础数据重新解释为其中一种类型，而不是进行实际的编码和解码。

数据加载¶

用于数据加载时，BINARY_FORMAT 指定暂存数据文件中的二进制值格式。此选项将 替换 为会话中的 BINARY_INPUT_FORMAT 参数设置的任何值（请参阅上面的 二进制值的会话参数）。

如果此选项设置为“HEX”或“BASE64”，则如果暂存数据文件中的字符串不是有效的 hex 或 base64，则数据加载可能会失败。在这种情况下，Snowflake 将返回错误，然后执行为 ON_ERROR 复制选项指定的操作。

数据卸载¶

在数据卸载中使用时，BINARY_FORMAT 选项指定的格式会应用于卸载到指定暂存区中的文件的二进制值。此选项将 替换 为会话中的 BINARY_OUTPUT_FORMAT 参数设置的任何值（请参阅上面的 二进制值的会话参数）。

如果此选项设置为 UTF-8，则如果表中的任何二进制值包含无效的 UTF-8，数据卸载将失败。在这种情况下，Snowflake 会返回错误。

十六进制（“HEX”）格式示例¶

输入 BINARY 数据的一种方法是将其编码为十六进制字符的字符串。下面是一个示例。

首先，创建一个包含 BINARY 列的表：

CREATE TABLE demo_binary (b BINARY);

Copy

如果尝试使用 TO_BINARY() 函数插入“普通”字符串，以尝试将其转换为有效的 BINARY 值，则会失败：

INSERT INTO demo_binary (b) SELECT TO_BINARY('HELP', 'HEX');

Copy

下面是错误消息：

100115 (22000): The following string is not a legal hex-encoded value: 'HELP'

Copy

这一次，在插入之前将输入显式转换为十六进制数字的字符串（这将会成功）：

INSERT INTO demo_binary (b) SELECT TO_BINARY(HEX_ENCODE('HELP'), 'HEX');

Copy

现在，检索数据：

SELECT TO_VARCHAR(b), HEX_DECODE_STRING(TO_VARCHAR(b)) FROM demo_binary;
+---------------+----------------------------------+
| TO_VARCHAR(B) | HEX_DECODE_STRING(TO_VARCHAR(B)) |
|---------------+----------------------------------|
| 48454C50      | HELP                             |
+---------------+----------------------------------+

Copy

如您所见，默认情况下，输出以十六进制格式显示。要重新获得原始字符串，请使用 HEX_DECODE_STRING 函数（它是之前用于对字符串编码的 HEX_ENCODE_STRING 函数的补充函数）。

以下内容有助于更详细地显示内部发生的情况：

SELECT 'HELP', HEX_ENCODE('HELP'), b, HEX_DECODE_STRING(HEX_ENCODE('HELP')),
   TO_VARCHAR(b), HEX_DECODE_STRING(TO_VARCHAR(b)) FROM demo_binary;

Copy

输出：

SELECT 'HELP', HEX_ENCODE('HELP'), b, HEX_DECODE_STRING(HEX_ENCODE('HELP')),
   TO_VARCHAR(b), HEX_DECODE_STRING(TO_VARCHAR(b)) FROM demo_binary;
+--------+--------------------+----------+---------------------------------------+---------------+----------------------------------+
| 'HELP' | HEX_ENCODE('HELP') | B        | HEX_DECODE_STRING(HEX_ENCODE('HELP')) | TO_VARCHAR(B) | HEX_DECODE_STRING(TO_VARCHAR(B)) |
|--------+--------------------+----------+---------------------------------------+---------------+----------------------------------|
| HELP   | 48454C50           | 48454C50 | HELP                                  | 48454C50      | HELP                             |
+--------+--------------------+----------+---------------------------------------+---------------+----------------------------------+

Copy

BASE64 格式示例¶

在阅读本部分之前，可能需要阅读上面的“十六进制格式”部分。基本概念很相似，但“十六进制格式”部分更详细地进行了解释。

首先，创建一个包含 BINARY 列的表：

CREATE TABLE demo_binary (b BINARY);

Copy

插入一行：

INSERT INTO demo_binary (b) SELECT TO_BINARY(BASE64_ENCODE('HELP'), 'BASE64');

Copy

检索该行：

SELECT 'HELP', BASE64_ENCODE('HELP'),
   BASE64_DECODE_STRING(BASE64_ENCODE('HELP')),
   TO_VARCHAR(b, 'BASE64'), 
   BASE64_DECODE_STRING(TO_VARCHAR(b, 'BASE64'))
   FROM demo_binary;
+--------+-----------------------+---------------------------------------------+-------------------------+-----------------------------------------------+
| 'HELP' | BASE64_ENCODE('HELP') | BASE64_DECODE_STRING(BASE64_ENCODE('HELP')) | TO_VARCHAR(B, 'BASE64') | BASE64_DECODE_STRING(TO_VARCHAR(B, 'BASE64')) |
|--------+-----------------------+---------------------------------------------+-------------------------+-----------------------------------------------|
| HELP   | SEVMUA==              | HELP                                        | SEVMUA==                | HELP                                          |
+--------+-----------------------+---------------------------------------------+-------------------------+-----------------------------------------------+

Copy

UTF-8 格式示例¶

首先，创建一个包含 BINARY 列的表：

CREATE TABLE demo_binary (b BINARY);

Copy

插入一行：

INSERT INTO demo_binary (b) SELECT TO_BINARY('HELP', 'UTF-8');

Copy

检索该行：

SELECT 'HELP', TO_VARCHAR(b, 'UTF-8')
   FROM demo_binary;
+--------+------------------------+
| 'HELP' | TO_VARCHAR(B, 'UTF-8') |
|--------+------------------------|
| HELP   | HELP                   |
+--------+------------------------+

Copy