데이터 로딩 기능 요약
데이터 로딩 기능 요약 (Summary of data loading features)
이 문서는 COPY INTO <table> 명령으로 파일에서 Snowflake 테이블로 데이터를 로드할 때 지원되는 기능을 빠르게 참조할 수 있는 요약이에요.
본문
데이터 파일 세부 사항
다음 표는 데이터 로드에 사용되는 파일의 일반적인 세부 사항을 설명해요:
| 기능 | 지원 | 참고 | | 파일 위치 | 로컬 환경 | 파일은 먼저 내부(Snowflake) 스테이지로 복사("스테이징")된 다음 테이블에 로드돼요. | | | Amazon S3 | 사용자가 제공한 버킷에서 파일을 직접 로드할 수 있어요. | | | Google Cloud Storage | 사용자가 제공한 버킷에서 파일을 직접 로드할 수 있어요. | | | Microsoft Azure 클라우드 스토리지 (Blob storage, Data Lake Storage Gen2, General-purpose v1, General-purpose v2) | 사용자가 제공한 컨테이너에서 파일을 직접 로드할 수 있어요. | | 파일 형식 | 구분된 파일(CSV, TSV 등) | 유효한 구분 기호는 모두 지원되며 기본값은 쉼표(즉 CSV)예요. | | | 반정형 형식 (JSON, Avro, ORC, Parquet, XML) | | | | 비정형 형식 | | | 파일 인코딩 | 파일 형식별 | 구분된 파일(CSV, TSV 등)의 기본 문자 세트는 UTF-8이에요. 다른 문자 세트를 사용하려면 로드에 사용할 인코딩을 명시적으로 지정해야 해요. 지원되는 문자 세트 목록은 이 문서의 구분된 파일용 지원 문자 세트를 참고하세요. | | | | 반정형 파일 형식(JSON, Avro 등)의 경우 지원되는 유일한 문자 세트는 UTF-8이에요. | | | | Snowflake는 tar(tape archive) 파일에서 데이터 로드를 지원하지 않아요. |
구분된 파일용 지원 문자 세트
다음 표는 구분된 파일(CSV, TSV 등)에서 데이터를 로드할 때 지원되는 인코딩 문자 세트를 나열해요:
| 문자 세트 | ENCODING 값 | 지원 언어 | 참고 | | Big5 | BIG5 | 중국어 번체 | | | EUC-JP | EUCJP | 일본어 | | | EUC-KR | EUCKR | 한국어 | | | GB18030 | GB18030 | 중국어 | | | IBM420 | IBM420 | 아랍어 | | | IBM424 | IBM424 | 히브리어 | | | IBM949 | IBM949 | 한국어 | | | ISO-2022-CN | ISO2022CN | 중국어 간체 | | | ISO-2022-JP | ISO2022JP | 일본어 | | | ISO-2022-KR | ISO2022KR | 한국어 | | | ISO-8859-1 | ISO88591 | 덴마크어, 네덜란드어, 영어, 프랑스어, 독일어, 이탈리아어, 노르웨이어, 포르투갈어, 스웨덴어 | | | ISO-8859-2 | ISO88592 | 체코어, 헝가리어, 폴란드어, 루마니아어 | | | ISO-8859-5 | ISO88595 | 러시아어 | | | ISO-8859-6 | ISO88596 | 아랍어 | | | ISO-8859-7 | ISO88597 | 그리스어 | | | ISO-8859-8 | ISO88598 | 히브리어 | | | ISO-8859-9 | ISO88599 | 터키어 | | | ISO-8859-15 | ISO885915 | 덴마크어, 네덜란드어, 영어, 프랑스어, 독일어, 이탈리아어, 노르웨이어, 포르투갈어, 스웨덴어 | 유로 통화 기호를 포함한 8개 문자를 제외하고 ISO-8859-1과 동일해요. | | KOI8-R | KOI8R | 러시아어 | | | Shift_JIS | SHIFTJIS | 일본어 | | | UTF-8 | UTF8 | 모든 언어 | 구분된 파일(CSV, TSV 등)에서 데이터를 로드할 때 UTF-8이 기본값이에요. 다른 지원 파일 형식(JSON, Avro 등)에서 데이터를 로드하거나 데이터를 언로드할 때는 UTF-8이 유일하게 지원되는 문자 세트예요. | | UTF-16 | UTF16 | 모든 언어 | | | UTF-16BE | UTF16BE | 모든 언어 | | | UTF-16LE | UTF16LE | 모든 언어 | | | UTF-32 | UTF32 | 모든 언어 | | | UTF-32BE | UTF32BE | 모든 언어 | | | UTF-32LE | UTF32LE | 모든 언어 | | | windows-874 | WINDOWS874 | 태국어 | | | windows-949 | WINDOWS949 | 한국어 | | | windows-1250 | WINDOWS1250 | 체코어, 헝가리어, 폴란드어, 루마니아어 | | | windows-1251 | WINDOWS1251 | 러시아어 | | | windows-1252 | WINDOWS1252 | 덴마크어, 네덜란드어, 영어, 프랑스어, 독일어, 이탈리아어, 노르웨이어, 포르투갈어, 스웨덴어 | | | windows-1253 | WINDOWS1253 | 그리스어 | | | windows-1254 | WINDOWS1254 | 터키어 | | | windows-1255 | WINDOWS1255 | 히브리어 | | | windows-1256 | WINDOWS1256 | 아랍어 | |
스테이징된 파일의 압축
다음 표는 로딩을 위해 Snowflake가 데이터 파일 압축을 어떻게 처리하는지 설명해요. 파일이 스테이징된 상태, 압축되지 않은 상태, 이미 압축된 상태에 따라 옵션이 달라져요:
| 기능 | 지원 | 참고 | | 압축되지 않은 파일 | gzip | Snowflake 스테이지에 압축되지 않은 파일을 스테이징하면 압축을 명시적으로 비활성화하지 않는 한 파일이 gzip으로 자동 압축돼요. | | 이미 압축된 파일 | gzip, bzip2, deflate, raw_deflate, Brotli, Zstandard | Snowflake는 이 압축 방법 중 하나를 자동 감지하거나, 파일을 압축하는 데 사용된 방법을 명시적으로 지정할 수 있어요. Brotli 압축 파일은 자동 감지가 지원되지 않아요. Brotli 압축 파일을 스테이징하거나 로드할 때는 사용된 압축 방법을 명시적으로 지정해야 해요. Snowflake는 압축된 tar(tape archive) 파일의 업로드를 지원하지 않아요. |
스테이징된 파일의 암호화
다음 표는 로딩을 위해 Snowflake가 데이터 파일 암호화를 어떻게 처리하는지 설명해요. 파일이 스테이징된 상태가 암호화되지 않았는지, 이미 암호화되었는지에 따라 옵션이 달라져요:
| 기능 | 지원 | 참고 | | 암호화되지 않은 파일 | 128비트 또는 256비트 키 | 데이터 로딩 및 언로딩 작업을 위해 내부 스테이지에 저장된 모든 파일은 서버 측에서 AES-256 강력 암호화로 자동 암호화돼요. 기본적으로 Snowflake는 128비트 키(256비트 키 구성 옵션 포함)로 추가적인 클라이언트 측 암호화를 제공해요. | | 이미 암호화된 파일 | 사용자 제공 키 | 이미 암호화된 파일은 외부 클라우드 스토리지에서 Snowflake로 로드할 수 있어요. 파일을 암호화하는 데 사용된 키는 Snowflake에 제공해야 해요. |