DECOMPRESS_BINARY

DECOMPRESS_BINARY

DECOMPRESS_BINARY 함수는 압축된 BINARY 입력 매개변수를 압축 해제해요.

출처: DECOMPRESS_BINARY

본문

DECOMPRESS_BINARY 함수는 압축된 BINARY 입력 매개변수를 압축 해제해요.

함께 보기: COMPRESS, DECOMPRESS_STRING

구문 (Syntax)

DECOMPRESS_BINARY(<input>, <method>)

인자 (Arguments)

필수 (Required):

  • input — COMPRESS에 지정된 압축 방법 중 하나를 사용해 압축된 데이터가 있는 BINARY 값(또는 표현식)이에요. 압축된 BINARY 값이 아닌 압축된 문자열을 압축 해제하려고 하면 오류가 발생하지 않고, 대신 함수가 BINARY 값을 반환해요. 자세한 내용은 아래 사용 메모를 참조해요.
  • method — 입력을 압축하는 데 원래 사용된 압축 방법이에요. 압축 방법 목록은 COMPRESS를 참조해요. DECOMPRESS_BINARY 방법은 COMPRESS 방법과 달리 압축 수준(compression level)을 지정할 필요가 없어요. 압축 수준을 지정해도 DECOMPRESS_BINARY는 이를 무시하고 실제 압축 수준을 사용해요.

반환 (Returns)

반환 값의 데이터 타입은 BINARY예요.

사용 메모 (Usage notes)

  • 압축 방법이 알 수 없거나 유효하지 않으면 쿼리가 실패해요.
  • 압축 방법 이름(예: ZLIB)은 대소문자를 구분하지 않아요.
  • DECOMPRESS_BINARY 함수는 원래 문자열 형식이었던 데이터를 압축 해제할 수 있어요. 그러나 DECOMPRESS_BINARY의 출력은 여전히 문자열이 아닌 BINARY예요. 예를 들어 SELECT DECOMPRESS_BINARY(COMPRESS('Hello', 'SNAPPY'), 'SNAPPY')는 BINARY 값을 반환하며, 해당 값을 표시하면 48656C6C6F로 표시되는데, 이는 'Hello'의 16진수 표현이에요. 혼동을 피하기 위해 Snowflake는 문자열 데이터를 DECOMPRESS_BINARY가 아닌 DECOMPRESS_STRING을 사용해 압축 해제할 것을 권장해요.

예제 (Examples)

압축된 값을 포함하는 BINARY 데이터를 압축 해제하는 간단한 예제를 보여줘요:

SELECT DECOMPRESS_BINARY(TO_BINARY('0920536E6F77666C616B65', 'HEX'), 'SNAPPY');
+-------------------------------------------------------------------------+
| DECOMPRESS_BINARY(TO_BINARY('0920536E6F77666C616B65', 'HEX'), 'SNAPPY') |
|-------------------------------------------------------------------------|
| 536E6F77666C616B65                                                      |
+-------------------------------------------------------------------------+

더 알아보기 (Learn more)

  • COMPRESS
  • DECOMPRESS_STRING
  • 문자열 및 이진 함수 (String & binary functions)
  • 압축/압축 해제 함수 (Compression/Decompression)