바이너리 입력 및 출력¶

16진수(기본값)¶

“16진수” 형식이란 16진수 또는 base 16 체계를 의미합니다. 이 형식에서 각 바이트는 2개 문자(0 ~ 9 사이의 숫자 및 A ~ F 사이의 문자)로 표현됩니다. 16진수를 사용하면 다음 변환을 수행할 수 있습니다.

16진수는 기본 바이너리 형식입니다.

base64¶

“base64” 형식은 바이너리 데이터(또는 문자열 데이터)를 인쇄 가능 ASCII 문자(문자, 숫자 및 구두점 또는 수학 연산자)로 인코딩합니다. (base64 인코딩 방식에 대한 정의는 RFC4648 에서 제공됩니다.)

Base64로 인코딩된 데이터의 이점은 다음과 같습니다.

• Base64로 인코딩된 데이터는 순수 ASCII 텍스트이므로, BINARY 데이터가 아닌 ASCII 문자 데이터를 지원하는 시스템에 저장할 수 있습니다. 예를 들어, 음악(디지털 샘플)을 표현하는 바이너리 데이터 또는 중국어 문자를 표현하는 UTF 데이터는 ASCII 텍스트로 인코딩하여 ASCII 문자만 지원하는 시스템에 저장할 수 있습니다.

• Base64로 인코딩된 데이터에는 제어 문자(예: 전송 끝 문자, 탭 문자)가 포함되지 않으므로, base64로 인코딩된 데이터는 제어 문자가 데이터가 아닌 명령으로 해석될 위험 없이 수신 및 송신할 수 있습니다. base64로 인코딩된 데이터는 한 번에 1개의 데이터를 주고 받는(패킷의 어느 부분이 데이터이고 어느 부분이 헤더 또는 제어 정보인지를 나타내는 패킷 헤더 또는 프로토콜을 사용하지 않음) 기존 모뎀 및 전자 통신 장비와 호환됩니다.

Base64로 인코딩된 데이터의 단점은 다음과 같습니다.

• 바이너리와 인쇄 가능 데이터 ASCII 표현 사이에서 데이터를 서로 변환하기 위해서는 계산 리소스가 사용됩니다.

• Base64로 인코딩된 데이터는 원본 데이터에 비해 약 1/3의 저장소 공간을 더 많이 차지합니다.

다음 섹션에서는 base64 인코딩에 대한 기술적 세부 정보를 제공합니다.

UTF-8¶

UTF-8 형식은 유니코드용 UTF-8 문자 인코딩을 의미합니다.

UTF-8은 텍스트에서 바이너리로의 인코딩에서 사용됩니다. 가능한 모든 BINARY 값을 유효한 UTF-8 문자열로 변환할 수 있는 것은 아니므로 이진에서 텍스트로의 인코딩에서는 UTF-8을 사용할 수 없습니다.

이 형식은 기본 데이터를 한 가지 타입 또는 다른 타입으로 재해석하기 위해 바이너리와 문자열 사이에서 일대일 변환을 수행할 때 실제 인코딩 및 디코딩보다 편리합니다.

데이터 로딩¶

데이터 로딩에서 사용되는 경우, 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 데이터를 입력하는 한 가지 방법은 다음 예제와 같이 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                   |
+--------+------------------------+