- カテゴリ:
文字列とバイナリ関数 (圧縮/解凍)
DECOMPRESS_BINARY¶
圧縮された BINARY 入力パラメーターを解凍します。
- こちらもご参照ください。
構文¶
DECOMPRESS_BINARY(<input>, <method>)
引数¶
必須:
inputCOMPRESS で指定された圧縮方法のいずれかを使用して圧縮されたデータを含む
BINARY値(または式)です。圧縮された
BINARY値ではなく、圧縮された文字列を解凍しようとしても、エラーは発生しません。関数はBINARY値を返します。詳細については、以下の使用上の注意をご参照ください。method元々
inputの圧縮に使用された圧縮方法です。圧縮方法のリストについては、 COMPRESS をご参照ください。COMPRESS方法とは異なり、DECOMPRESS_BINARY方法では、圧縮レベルを指定する必要はありません。圧縮レベルを指定すると、DECOMPRESS_BINARYはそれを無視し、実際の圧縮レベルを使用します。
戻り値¶
戻り値のデータ型は BINARY です。
使用上の注意¶
圧縮方法が不明または無効な場合は、クエリに失敗します。
圧縮方法名(例:
ZLIB)では、大文字と小文字が区別されません。DECOMPRESS_BINARY関数は、元が文字列形式であったデータを解凍できます。ただし、DECOMPRESS_BINARYの出力は文字列ではなくBINARYのままです。たとえば、SELECT DECOMPRESS_BINARY(COMPRESS('Hello', 'SNAPPY), 'SNAPPY')はBINARY値を返します。その値を表示する場合、「Hello」の16進数表現である48656C6C6Fとして表示されます。混乱を避けるため、Snowflakeは、DECOMPRESS_BINARYではなく DECOMPRESS_STRING を使用して文字列データを解凍することをお勧めします。
戻り値¶
解凍されたデータを含む BINARY 値です。
例¶
これは、圧縮された値を含む BINARY データの簡単な解凍例を示しています。
SELECT DECOMPRESS_BINARY(TO_BINARY('0920536E6F77666C616B65', 'HEX'), 'SNAPPY');
+-------------------------------------------------------------------------+
| DECOMPRESS_BINARY(TO_BINARY('0920536E6F77666C616B65', 'HEX'), 'SNAPPY') |
|-------------------------------------------------------------------------|
| 536E6F77666C616B65 |
+-------------------------------------------------------------------------+