#내보내기 Pro

This feature is provided by the commercial plugin «액션: 기록 내보내기 Pro», please purchase to use

#소개

내보내기 Pro 플러그인은 일반 내보내기 기능에 더해 향상된 기능을 제공합니다.

#설치

이 플러그인은 비동기 작업 관리 플러그인에 의존합니다. 사용하기 전에 비동기 작업 관리 플러그인을 먼저 활성화해야 합니다.

#기능 향상

• 비동기 내보내기 작업을 지원하며, 독립적인 스레드에서 실행되어 대량의 데이터를 내보낼 수 있습니다.
• 첨부 파일 내보내기를 지원합니다.

#사용 안내

#내보내기 모드 설정

내보내기 버튼에서 내보내기 모드를 설정할 수 있으며, 다음 세 가지 모드를 선택할 수 있습니다:

• 자동: 내보내기 시 데이터 양에 따라 내보내기 모드를 결정합니다. 데이터 양이 1,000개 미만(첨부 파일 내보내기 시 100개 미만)이면 동기 내보내기를 사용하고, 1,000개 초과(첨부 파일 내보내기 시 100개 초과)이면 비동기 내보내기를 사용합니다.
• 동기: 동기 내보내기를 사용하며, 내보내기 시 메인 스레드에서 실행됩니다. 소규모 데이터에 적합하며, 동기 모드에서 대규모 데이터를 내보내면 시스템이 블록되거나 멈추고 다른 사용자 요청을 처리할 수 없게 될 수 있습니다.
• 비동기: 비동기 내보내기를 사용하며, 내보내기 시 독립적인 백그라운드 스레드에서 실행되어 현재 시스템 사용을 방해하지 않습니다.

#비동기 내보내기

내보내기를 실행하면 내보내기 프로세스가 독립적인 백그라운드 스레드에서 실행되므로 사용자가 수동으로 설정할 필요가 없습니다. 사용자 인터페이스에서 내보내기 작업을 실행한 후, 오른쪽 상단에 현재 실행 중인 내보내기 작업이 표시되며 실시간으로 작업 진행 상황을 보여줍니다.

내보내기가 완료되면 내보내기 작업 목록에서 내보낸 파일을 다운로드할 수 있습니다.

#동시 내보내기

동시 내보내기 작업이 많아지면 서버 구성의 영향을 받아 시스템 응답이 느려질 수 있습니다. 따라서 시스템 개발자는 최대 동시 내보내기 작업 수(기본값 3)를 설정하는 것을 권장합니다. 설정된 동시 작업 수를 초과하면 작업이 대기열에 추가됩니다.

동시 작업 수 설정 방법: 환경 변수 ASYNC_TASK_MAX_CONCURRENCY=동시_작업_수

다양한 설정과 데이터 복잡도에 대한 종합 테스트 결과, 권장 동시 작업 수는 다음과 같습니다:

• 2코어 CPU, 동시 작업 수 3
• 4코어 CPU, 동시 작업 수 5

#성능 관련

내보내기 프로세스가 비정상적으로 느리다고 느껴지신다면(아래 참고), 컬렉션 구조로 인해 발생하는 성능 문제일 수 있습니다.

데이터 특성	인덱스 유형	데이터 양	내보내기 시간
관계형 필드 없음	기본 키 / 고유 제약 조건	100만	3~6분
관계형 필드 없음	일반 인덱스	100만	6~10분
관계형 필드 없음	복합 인덱스(비고유)	100만	30분
관계형 필드 (일대일, 일대다, 다대일, 다대다)	기본 키 / 고유 제약 조건	50만	15~30분

효율적인 내보내기를 위해 다음을 권장합니다:

1. 컬렉션은 다음 조건을 충족해야 합니다:

조건 유형	필수 조건	기타 참고 사항
컬렉션 구조 (최소 한 가지 충족)	기본 키가 있어야 함 고유 제약 조건이 있어야 함 인덱스(고유, 일반, 복합)가 있어야 함	우선순위: 기본 키 > 고유 제약 조건 > 인덱스
필드 특성	기본 키 / 고유 제약 조건 / 인덱스 (이 중 하나)는 정렬 가능한 특성을 가져야 합니다. 예: 자동 증가 ID, 스노우플레이크 ID, UUID v1, 타임스탬프, 숫자 등 (참고: UUID v3/v4/v5, 일반 문자열 등 정렬 불가능한 필드는 성능에 영향을 미칩니다.)	없음

2. 불필요하게 내보내는 필드, 특히 관계형 필드 수를 줄이십시오. (관계형 필드로 인한 성능 문제는 계속 최적화 중입니다.)
3. 위 조건을 모두 충족했음에도 내보내기가 여전히 느리다면, 로그 분석을 수행하거나 공식 팀에 피드백을 제공해 주십시오.

• 연동 규칙: 버튼을 동적으로 표시/숨김;
• 버튼 편집: 버튼의 제목, 유형, 아이콘 편집;