SFTP 서비스
SFTP(SSH File Transfer Protocol)는 SSH 프로토콜을 사용하여 데이터를 안전하게 전송하는 방법입니다. 주로 파일 전송에 사용되며, 클라이언트 서비스를 이용해 PC에서 파일을 다루는 것과 같은 방식으로 데이터를 이용할 수 있습니다.
특징
- 대용량 파일을 안전하게 전송하거 나, 정기적으로 백업 파일을 클라이언트에게 제공해야 하는 경우에 유용합니다.
- 많은 양의 데이터를 한 번에 배치로 전송하는 데 사용되며, 대용량 데이터 파일을 다루는 데 적합합니다.
활용 사례
-
백업 데이터 만들기: SFTP 서비스를 사용하면 대용량 데이터 파일을 효율적으로 관리할 수 있습니다. 데이터를 일괄적으로 다운로드하여 백업 저장소에 보관하거나 자체 분석 서비스에 활용할 수 있습니다.
-
빅데이터 분석, 데이터 실험하기: SFTP로 데이터를 다운로드한 후, 데이터를 자체 시스템이나 데이터 웨어하우스에 로딩하여 원하는 방식으로 관리하고 분석할 수 있습니다.
SFTP 서비스 이용 방법
- SFTP 서비스의 경우 접속 계정 발급 절차를 필요로 합니다. 문의 채널을 통해 서비스 이용을 신청하시면 SFTP에 접속 가능한 클라이언트 계정을 발급드립니다.
- 업무 담당자와 협의를 통해 네트워크 방화벽 설정 등 추가적인 보안 조치를 설정할 수 있습니다.
- SFTP는 클라이언트 프로그램, CLI, 또는 프로그래밍 방식 등 다양한 방법으로 사용할 수 있습니다.
- 아래에서는 가장 일반적인 방식인 SFTP 클라이언트 프로그램을 통한 사용 방법을 소개합니다.
SFTP 클라이언트
클라이언트 설치
대표적인 SFTP 클라이언트 프로그램은 다음과 같습니다.
- OpenSSH
- FileZilla
- PuTTY
이들 중 하나를 설치하여 사용할 수 있습니다.
인증 정보 입력
SFTP 서버에 접속하기 위해서는 인증 정보가 필요하며,
해당 정보는 서비스 이용 신청 후 발급됩니다.
인증 정보 구성 예시는 다음과 같습니다.
- 호스트: sftp://...
- 포트: 22
- 사용자명: (발급된 사용자명)
- 인증 수단: SSH 키 또는 비밀번호 (아래 참고)
인증 방식
계정마다 아래 두 가지 중 하나로 로그인합니다.
| 방식 | 준비할 것 | 비고 |
|---|---|---|
| SSH 키 인증 (권장) | 고객사에서 만든 SSH 키 쌍 중 공개키 | 공개키를 전달해 주시면 계정에 등록해 드립니다. 개인키는 고객사에서만 보관합니다. |
| 비밀번호 인증 | 발급된 비밀번호 | 보안 정책상 키 인증을 요구하시는 경우에는 비밀번호 로그인을 끄고 운영합니다. |
SSH 키 쌍은 공개키(.pub)와 개인키(확장자 없음)로 이루어집니다. 저희에게는 공개키만 보내 주시고, 개인키는 접속하는 PC나 서버에만 보관해 주세요.
클라이언트 IP 대역 요청
보안 강화를 위해 SFTP 서버에 접근 가능한 IP 대역을 제한할 수 있습니다.
필요할 경우 사용 중인 IP 대역을 전달해 주시면 보안 정책에 반영됩니다.
Windows에서 접속하기
Windows 10(1809 이후)과 Windows 11 기준으로, SSH 키를 만들고 접속해 데이터를 내려받는 순서를 안내합니다.
1) SSH 키 만들기
Windows 10·11에는 OpenSSH 클라이언트가 기본 포함되어 있어 별도 설치 없이 키를 만들 수 있습니다.
-
시작 메뉴에서 PowerShell을 엽니다.
-
아래 명령을 실행합니다.
mkdir "$env:USERPROFILE\.ssh" -Force
ssh-keygen -t rsa -b 4096 -f "$env:USERPROFILE\.ssh\mash_sftp" -
암호(passphrase)를 묻는 화면이 나오면 원하는 암호를 입력하거나, 그대로 Enter를 눌러 생략합니다.
-
C:\Users\{사용자}\.ssh\폴더에 두 파일이 만들어집니 다.mash_sftp— 개인키. 접속할 때 사용하며 외부로 보내지 않습니다.mash_sftp.pub— 공개키. 이 파일을 담당자에게 전달해 주세요.
공개키 등록이 끝나면 접속 정보(호스트, 사용자명)를 별도로 안내해 드립니다.
2) FileZilla로 접속하기
-
FileZilla 공식 사이트에서 FileZilla Client를 내려받아 설치합니다.
-
메뉴에서 파일 → 사이트 관리자를 열고 새 사이트를 누릅니다.
-
아래와 같이 입력합니다.
항목 입력값 프로토콜 SFTP - SSH File Transfer Protocol 호스트 안내받은 호스트 주소 포트 22 로그온 유형 키 파일 사용자 안내받은 사용자명 키 파일 C:\Users\{사용자}\.ssh\mash_sftp(개인키) -
연결을 누릅니다.
- 키 파일 선택 창에 파일이 보이지 않으면, 파일 형식을 모든 파일로 바꿔서 선택합니다.
- 키 형식을 변환할지 묻는 창이 나오면 예를 눌러 변환된 파일(
.ppk)을 저장한 뒤 그 파일을 사용합니다. - 처음 접속할 때 서버 인증서(호스트 키)를 신뢰할지 묻는 창이 나오면 확인을 누릅니다.
-
접속되면 오른쪽 리모트 사이트 창에
event/등 제공 폴더가 보입니다. 원하는 폴더나 파일을 왼쪽 로컬 사이트 창으로 끌어다 놓으면 내려받아집니다.
3) PowerShell(명령어)로 접속하기
프로그램 설치 없이 PowerShell에서 바로 접속할 수도 있습니다.
sftp -i "$env:USERPROFILE\.ssh\mash_sftp" {사용자명}@{호스트}
접속 후 자주 쓰는 명령은 다음과 같습니다.
| 명령 | 설명 |
|---|---|
ls | 현재 폴더 목록 보기 |
cd event | 폴더 이동 |
lcd C:\mash_data | 내려받을 내 PC 폴더 지정 |
get 2026-11-04.parquet | 파일 하나 내려받기 |
get -r {매장태그} | 폴더 통째로 내려받기 |
exit | 접속 종료 |
내려받은 데이터 열어보기
제공 파일은 .csv 또는 .parquet 형식입니다. .csv는 Excel에서 바로 열 수 있고, .parquet은 아래 방법으로 내용을 확인하거나 CSV로 바꿀 수 있습니다.
DuckDB (설치형 조회 도구)
-
PowerShell에서 DuckDB를 설치합니다.
winget install DuckDB.cli -
새 PowerShell 창에서
duckdb를 실행한 뒤 아래처럼 조회합니다.-- 파일 하나의 앞 10행 보기
SELECT * FROM 'C:/mash_data/2026-11-04.parquet' LIMIT 10;
-- 폴더 안의 parquet 파일을 모두 합쳐 CSV 로 저장
COPY (SELECT * FROM 'C:/mash_data/*.parquet')
TO 'C:/mash_data/merged.csv' (HEADER, DELIMITER ',');
Python
import pandas as pd # pip install pandas pyarrow
df = pd.read_parquet(r"C:\mash_data\2026-11-04.parquet")
print(df.head())
# Excel 에서 한글이 깨지지 않도록 utf-8-sig 로 저장
df.to_csv(r"C:\mash_data\2026-11-04.csv", index=False, encoding="utf-8-sig")
파일 시스템 구조
상위 문서에서 설명한 meta/ event/ 디렉터리 구조와 파일 구조를 따릅니다.