데이터 언로딩 기능 요약
데이터 언로딩 기능 요약 (Summary of Data Unloading Features)
이 문서는 COPY INTO <location> 명령으로 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가 생성하는 출력 파일의 압축을 어떻게 처리하는지 설명해요:
| 파일 위치 | 지원 | 참고 | | 내부 또는 외부 위치 | gzip, bzip2, Brotli, Zstandard | 기본적으로 모든 언로드된 데이터 파일은 압축을 명시적으로 비활성화하거나 다른 지원 압축 방법을 명시적으로 지정하지 않는 한 gzip으로 압축돼요. |
참고:
compression=gzip일 때 Azure와 Google Cloud Platform에 대해 CONTENT-ENCODING 설정이 지원되지 않는 알려진 이슈가 있어요.
출력 데이터 파일의 암호화
다음 표는 데이터를 언로드할 때 Snowflake가 생성하는 출력 파일의 암호화를 어떻게 처리하는지 설명해요. 파일이 내부 위치(즉 Snowflake 스테이지)로 언로드되는지 외부 위치(Amazon S3, Google Cloud Storage, Microsoft Azure)로 언로드되는지에 따라 옵션이 달라져요:
| 파일 위치 | 지원 | 참고 | | 내부 위치 | 128비트 또는 256비트 키 | Snowflake 내부 위치로 언로드된 모든 데이터 파일은 128비트 키로 자동 암호화돼요. 파일은 로컬 디렉토리에 다운로드되면 암호화되지 않아요. 256비트 키도(더 강한 암호화를 위해) 활성화할 수 있으며, 이 경우 추가 구성이 필요해요. | | 외부 위치 | 사용자 제공 키 | 클라우드 스토리지로 언로드된 데이터 파일은 (파일 암호화용) 보안 키가 Snowflake에 제공되면 암호화될 수 있어요. |