バイナリ入出力¶

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多くのストレージ容量が必要です。

次のエンコーディングに関する技術的な詳細は、関心ののある読者向けです。

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

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

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

ご覧のとおり、デフォルトでは出力は16進数で表示されます。元の文字列を取得するには、関数 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 形式の例¶

このセクションを読む前に、上記の16進形式のセクションを読むことをお勧めします。基本的な概念は似ており、16進形式のセクションで詳細を説明しています。

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