데이터 언로드 기능 요약¶

이 항목에서는 COPY INTO <위치> 명령을 사용하여 Snowflake 테이블에서 플랫 파일로 데이터를 언로드할 수 있도록 지원되는 기능에 대한 빠른 참조를 제공합니다.

지원되는 일부 기능, 특히 압축 및 암호화는 Snowflake 내부 위치 또는 외부 위치(Amazon S3, Google Cloud Storage 또는 Microsoft Azure)로 언로드하는지에 따라 결정됩니다.

이 항목의 내용:

출력 데이터 파일 세부 정보¶

다음 테이블에서는 데이터를 언로드할 때 Snowflake에서 생성되는 출력 파일과 관련한 일반 세부 정보를 설명합니다.

기능	지원됨	참고
파일 위치	로컬 파일	파일은 우선 Snowflake 내부 위치로 언로드된 후 GET 을 사용하여 로컬 위치에 다운로드할 수 있습니다.
	Amazon S3의 파일	파일은 S3의 사용자 제공 버킷으로 직접 언로드된 후 AWS 유틸리티를 사용하여 로컬 위치에 다운로드할 수 있습니다.
	Google Cloud Storage의 파일	파일은 Cloud Storage의 사용자 제공 컨테이너로 직접 언로드된 후 Cloud Storage 유틸리티를 사용하여 로컬 위치에 다운로드할 수 있습니다.
	Microsoft Azure의 파일	파일은 Azure의 사용자 제공 컨테이너로 직접 언로드된 후 Azure 유틸리티를 사용하여 로컬 위치에 다운로드할 수 있습니다.
파일 형식	구분 기호로 분리된 파일(CSV, TSV 등)	모든 유효한 구분 기호가 지원되며, 기본값은 쉼표(즉, CSV)입니다.
	JSON
	Parquet
파일 인코딩	UTF-8	출력 파일은 파일 형식에 관계없이 항상 UTF-8을 사용하여 인코딩되며, 다른 문자 세트는 지원되지 않습니다.

참고

메모리 압박이 있는 시스템에서 실행 중인 언로딩으로 인해 파일 크기가 작아질 수 있습니다.

출력 데이터 파일의 압축¶

다음 테이블에서는 데이터를 언로드할 때 Snowflake에서 생성되는 출력 파일의 압축을 Snowflake가 처리하는 방법을 설명합니다.

파일 위치	지원됨	참고
내부 또는 외부 위치	gzip	압축이 명시적으로 비활성화되거나 지원되는 다른 압축 방법 중 하나가 명시적으로 지정된 경우를 제외하고, 기본적으로 언로드된 모든 데이터 파일은 gzip을 사용하여 압축됩니다.
	bzip2
	Brotli
	Zstandard

참고

compression=gzip 일 때 Azure 및 Google Cloud Platform에 대한 CONTENT-ENCODING 설정을 현재 지원하지 않는 것은 알려진 문제입니다.

출력 데이터 파일의 암호화¶

다음 테이블에서는 데이터를 언로드할 때 Snowflake에서 생성되는 출력 파일의 암호화를 Snowflake가 처리하는 방법을 설명합니다. 옵션은 파일의 언로드 위치가 내부 위치(즉, Snowflake 스테이지) 또는 외부 위치(Amazon S3, Google Cloud Storage 또는 Microsoft Azure)인지에 따라 다릅니다.

파일 위치	지원됨	참고
내부 위치	128비트 또는 256비트 키	Snowflake 내부 위치로 언로드되는 모든 데이터 파일은 128비트 키를 사용하여 자동으로 암호화됩니다. 파일은 로컬 디렉터리에 다운로드될 때 암호화됩니다. 256비트 키를 사용할 수도 있지만(보다 강력한 암호화를 위해), 추가적인 구성이 필요합니다.
외부 위치	사용자 제공 키	클라우드 저장소에 언로드되는 데이터 파일은 Snowflake에 보안 키(파일 암호화용)를 제공하는 경우에 암호화가 가능합니다.

파일 위치

지원됨

참고

내부 위치

128비트 또는 256비트 키

Snowflake 내부 위치로 언로드되는 모든 데이터 파일은 128비트 키를 사용하여 자동으로 암호화됩니다. 파일은 로컬 디렉터리에 다운로드될 때 암호화됩니다.

256비트 키를 사용할 수도 있지만(보다 강력한 암호화를 위해), 추가적인 구성이 필요합니다.

외부 위치

사용자 제공 키

클라우드 저장소에 언로드되는 데이터 파일은 Snowflake에 보안 키(파일 암호화용)를 제공하는 경우에 암호화가 가능합니다.