バイナリ入出力¶

16進数（デフォルト）¶

「16進数」形式は、16進数またはBase16システムを指します。この形式では、各バイトは2文字（0 から 9 の数字と A から F の文字）で表されます。16進数を使用して変換を実行する場合：

16進数はデフォルトのバイナリ形式です。

Base64¶

「Base64」形式は、バイナリデータ（または文字列データ）を印刷可能な ASCII 文字（文字、数字、句読点または数学演算子）としてエンコードします。（Base64エンコードスキームは RFC 4648 で定義されています。）

Base64でエンコードされたデータには、次の利点があります。

• Base64でエンコードされたデータは純粋な ASCII テキストであるため、 ASCII 文字データをサポートし、 BINARY データをサポートしないシステムに保存できます。たとえば、音楽（デジタルサンプル）を表すバイナリデータ、または北京語の文字を表す UTF データは、 ASCII テキストとしてエンコードし、 ASCII 文字のみをサポートするシステムに保存できます。

• Base64でエンコードされたデータには制御文字（例: 送信終了文字、タブ文字）が含まれていないため、Base64でエンコードされたデータは、制御文字をデータとしてではなくコマンドとして理解されるリスクのない状態で送受信できます。Base64でエンコードされたデータは、一度に1文字ずつデータを送受信する古いモデムやその他の通信機器との互換性があります（パケットのどの部分がデータであり、どの部分がヘッダーまたは制御情報であるかを示すプロトコルはありません）。

Base64でエンコードされたデータには、次の欠点があります。

• バイナリ表現と印刷可能な ASCII 表現の間でデータを変換すると、コンピューティングリソースを消費します。

• Base64でエンコードされたデータには、元のデータよりも約1/3多くのストレージ容量が必要です。

以下のセクションでは、Base64エンコードの技術的な詳細を説明します。

UTF-8¶

UTF-8形式は、Unicodeの UTF-8文字エンコードを指します。

UTF-8は、テキストからバイナリへのエンコードに使用されます。すべての可能な BINARY 値を有効な UTF-8文字列に変換できるわけではないため、 UTF-8をバイナリからテキストへのエンコードに使用することはできません。

この形式は、実際のエンコードおよびデコードではなく、基になるデータを1つのタイプまたは別のタイプとして再解釈するために、バイナリとストリングの間の1対1変換を実行するのに便利です。

データのロード¶

データのロードに使用する場合、 BINARY_FORMAT はステージングされたデータファイルのバイナリ値の形式を指定します。このオプションは、セッションにある BINARY_INPUT_FORMAT パラメーターのあらゆる値セット（バイナリ値のセッションパラメーター を参照）を オーバーライド します。

このオプションが HEX または BASE64 に設定されている場合は、ステージングされたデータファイルの文字列が有効な16進数またはBase64でないと、データのロードに失敗することがあります。この場合、Snowflakeはエラーを返し、 ON_ERROR コピーオプションに指定されたアクションを実行します。

データのアンロード¶

データのアンロードで使用する場合、 BINARY_FORMAT オプションは、指定されたステージのファイルにアンロードされるバイナリ値に適用される形式を指定します。このオプションは、セッションにある BINARY_OUTPUT_FORMAT パラメーターのあらゆる値セット（バイナリ値のセッションパラメーター を参照）を オーバーライド します。

オプションが UTF-8 に設定されている場合、テーブルのバイナリ値に無効な UTF-8が含まれていると、データのアンロードは失敗します。この場合、Snowflakeはエラーを返します。

16進数（「HEX」）形式の例¶

以下の例に示すとおり、 BINARY データを入力する1つの方法は、16進文字列としてエンコードすることです。

BINARY 列を持つテーブルの作成から始めます。

CREATE OR REPLACE TABLE demo_binary_hex (b BINARY);

TO_BINARY 関数を使用して「通常の」文字列を挿入し、有効な BINARY 値に変換しようとすると失敗します。

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

エラーメッセージは次のとおりです。

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

今回は、入力を挿入前に明示的に16進数の文字列に変換します（これは成功する）。

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

次に、データを取得します。

SELECT TO_VARCHAR(b), HEX_DECODE_STRING(TO_VARCHAR(b)) FROM demo_binary_hex;

+---------------+----------------------------------+
| TO_VARCHAR(B) | HEX_DECODE_STRING(TO_VARCHAR(B)) |
|---------------+----------------------------------|
| 48454C50      | HELP                             |
+---------------+----------------------------------+

ご覧のとおり、デフォルトでは出力は16進数で表示されます。元の文字列を取得するには、関数 HEX_DECODE_STRING （文字列のエンコードに以前に使用された関数 HEX_ENCODE の補数）を使用します。

以下のクエリは、内部で何が起こっているかをより詳細に示します。

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

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

BASE64 形式の例¶

このセクションを読む前に、 16進数（「HEX」）形式の例 をご参照ください。基本的なコンセプトは似ており、 16進数（「HEX」）形式の例 ではより詳しく説明されています。

BINARY 列を持つテーブルの作成から始めます。

CREATE OR REPLACE TABLE demo_binary_base64 (b BINARY);

行を挿入します。

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

その行を取得します。

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_base64;

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

UTF-8形式の例¶

BINARY 列を持つテーブルの作成から始めます。

CREATE OR REPLACE TABLE demo_binary_utf8 (b BINARY);

行を挿入します。

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

その行を取得します。

SELECT 'HELP',
       TO_VARCHAR(b, 'UTF-8')
  FROM demo_binary_utf8;

+--------+------------------------+
| 'HELP' | TO_VARCHAR(B, 'UTF-8') |
|--------+------------------------|
| HELP   | HELP                   |
+--------+------------------------+