CSV로 내보내기
GitLab v19.1요약
이 문서에서는 GitLab 코드베이스의 CSV 내보내기 구현 방식을 나열합니다. *로 표시된 내보내기 유형은 현재 작업 진행 중입니다.
이 문서에서는 GitLab 코드베이스의 CSV 내보내기 구현 방식을 나열합니다.
| 내보내기 유형 | 구현 방식 | 장점 | 단점 | 기존 사용 예 |
|---|---|---|---|---|
| 스트리밍 | - 데이터를 배치 단위로 조회하여 응답 스트림에 전달.- 다운로드가 즉시 시작됨. | - 보고서를 즉시 확인 가능. | - 진행 표시기 없음.- 안정적인 연결이 필요. | 감사 이벤트 로그 내보내기 |
| 다운로드 | - 데이터를 배치 단위로 조회하여 임시 파일에 기록.- 파일을 메모리에 로드.- 파일을 클라이언트에 전송. | - 보고서를 즉시 확인 가능. | - 대용량 데이터는 요청 타임아웃을 유발할 수 있음.- 메모리 사용량이 많음.- 사용자가 다른 페이지로 이동하면 요청이 만료됨. | - 관리 연속성 보고서 내보내기- 라이선스 사용 파일 내보내기 |
| 이메일 첨부 파일 | - 백그라운드 job으로 비동기적으로 쿼리를 처리.- 이메일에 내보낸 파일을 첨부. | - 비동기 처리. | - 사용자가 CSV를 다운로드하기 위해 별도 앱(이메일)을 사용해야 함.- 이메일 제공업체에서 첨부 파일 크기를 제한할 수 있음. | - 이슈 내보내기- 머지 리퀘스트 내보내기 |
| 이메일 내 다운로드 링크 (*) | - 백그라운드 job으로 비동기적으로 쿼리를 처리.- 이메일에 내보내기 링크를 사용. | - 비동기 처리.- 이메일 제공업체의 첨부 파일 크기 제한을 우회. | - 사용자가 별도 앱(이메일)을 사용해야 함.- 추가 스토리지 및 정리 작업이 필요. | 사용자 권한 내보내기 |
| 폴링 (비영속 상태) | - 백그라운드 job으로 비동기적으로 쿼리를 처리.- 프론트엔드(FE)가 몇 초마다 CSV 파일 준비 여부를 폴링. | - 비동기 처리.- 완료 시 로컬 머신에 자동 다운로드.- 인앱 솔루션. | - 비영속 요청 - 사용자가 다른 페이지로 이동하면 요청이 만료됨.- 각 폴링 요청마다 API가 처리됨. | 취약점 내보내기 |
| 폴링 (영속 상태) (*) | - 백그라운드 job으로 비동기적으로 쿼리를 처리.- 백엔드(BE)가 내보내기 상태를 유지.- FE가 몇 초마다 상태를 폴링.- 내보내기 준비 완료 시 FE에 '다운로드 링크'를 표시.- 사용자가 다운로드하거나 새 보고서를 재생성할 수 있음. | - 비동기 처리.- 폴링 요청 중 데이터베이스 호출 없음(내보내기 상태가 변경될 때까지 HTTP 304 상태 반환).- 내보내기가 완료될 때까지 사용자가 페이지에 머물 필요 없음.- 인앱 솔루션.- 범용 CSV 기능(대시보드/CSV API 등)으로 확장 가능. | - DB에서 내보내기 상태를 유지해야 함.- CSV 내보내기가 로컬 머신에 자동 다운로드되지 않으며, 사용자가 '다운로드'를 직접 선택해야 함. | 머지 커밋 보고서 내보내기 |
*로 표시된 내보내기 유형은 현재 작업 진행 중입니다.