CSV로 내보내기
이 문서는 GitLab 코드베이스에서 CSV 내보내기의 다양한 구현을 나열합니다.
내보내기 유형 | 작동 방식 | 장점 | 단점 | 기존 예시 |
---|---|---|---|---|
스트리밍 | - 데이터를 배치로 쿼리하고 응답 스트림으로 전달합니다. - 다운로드가 즉시 시작됩니다. |
- 보고서가 즉시 제공됩니다. | - 진행 표시기가 없습니다. - 신뢰할 수 있는 연결이 필요합니다. |
감사 이벤트 로그 내보내기 |
다운로드 | - 데이터를 배치로 쿼리하고 임시 파일에 씁니다. - 파일을 메모리에 로드합니다. - 파일을 클라이언트로 전송합니다. |
- 보고서가 즉시 제공됩니다. | - 대량의 데이터로 인해 요청 시간이 초과될 수 있습니다. - 메모리 집약적입니다. - 사용자가 다른 페이지로 이동하면 요청이 만료됩니다. |
- 책임 연대 보고서 내보내기 - 라이선스 사용 파일 내보내기 |
이메일 첨부 파일로 | - 백그라운드 작업으로 쿼리를 비동기적으로 처리합니다. - 이메일은 내보내기를 첨부 파일로 사용합니다. |
- 비동기 처리. | - 사용자가 CSV를 다운로드하기 위해 다른 앱(이메일)을 사용해야 합니다. - 이메일 제공자가 첨부 파일 크기를 제한할 수 있습니다. |
- 문제 내보내기 - 병합 요청 내보내기 |
이메일의 다운로드 링크(*)로 | - 백그라운드 작업으로 쿼리를 비동기적으로 처리합니다. - 이메일은 내보내기 링크를 사용합니다. |
- 비동기 처리. - 이메일 제공자의 첨부 파일 크기 제한을 우회합니다. |
- 사용자가 다른 앱(이메일)을 사용해야 합니다. - 추가 저장소 및 정리가 필요합니다. |
사용자 권한 내보내기 |
폴링(비지속 상태) | - 백그라운드 작업으로 쿼리를 비동기적으로 처리합니다. - 프론트엔드(FE)가 CSV 파일이 준비되었는지 몇 초마다 폴링합니다. |
- 비동기 처리. - 완료 시 로컬 머신으로 자동 다운로드됩니다. - 인앱 솔루션. |
- 비지속 요청 - 사용자가 다른 페이지로 이동하면 요청이 만료됩니다. - 각 폴링 요청에 대해 API가 처리됩니다. |
취약점 내보내기 |
폴링(지속 상태)(*) | - 백그라운드 작업으로 쿼리를 비동기적으로 처리합니다. - 백엔드(BE)가 내보내기 상태를 유지합니다. - FE는 상태를 확인하기 위해 몇 초마다 폴링합니다. - 내보내기가 준비되면 FE에 ‘다운로드 링크’가 표시됩니다. - 사용자는 보고서를 다운로드하거나 새로 생성할 수 있습니다. |
- 비동기 처리. - 폴링 요청 동안 데이터베이스 호출이 이루어지지 않습니다 (HTTP 304 상태는 내보내기 상태가 변경될 때까지 반환됩니다). - 내보내기가 완료될 때까지 사용자가 페이지에 머물 필요가 없습니다. - 인앱 솔루션. - 대시보드 / CSV API와 같은 일반 CSV 기능으로 확장될 수 있습니다. |
- DB에서 내보내기 상태를 유지해야 합니다. - CSV 내보내기를 로컬 머신에 자동 다운로드하지 않으며, 사용자가 ‘다운로드’를 선택해야 합니다. |
병합 커밋 보고서 내보내기 |
참고: *로 표시된 내보내기 유형은 현재 작업 중입니다.