바이너리 입력 및 출력¶

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의 저장소 공간을 더 많이 차지합니다.

아래는 관심 있는 사용자를 위한 인코딩 관련 세부 정보입니다.

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