영속화

11.1 저장소

서비스는 상태를 내장 SQLite 데이터베이스에 보관하는 것이 좋다. 제안하는 테이블 구성은 다음과 같다.

모델 파일은 데이터베이스 밖에 두어야 한다. 데이터베이스에는 메타데이터와 내용 다이제스트만 담는다.

테이블 이름과 레이아웃은 구현이 선택한다. 클라이언트가 관찰할 수 있고 상호 운용되어야 하는 것은 다음 두 절의 동작이다.

11.2 규칙

서비스는 어떤 저장소를 쓰든 다음을 지킨다.

• 202 Accepted를 반환하기 전에 작업을 영속화해야 한다.
• 이벤트 순번과 작업 상태를 같은 트랜잭션에서 갱신해야 한다.
• 취소 전이를 원자적으로 만들어, 작업이 취소된 뒤 완료되는 경합을 피해야 한다.
• 끝난 작업과 이벤트를 설정할 수 있는 보존 기간 동안 보관하는 것이 좋다.
• 로그를 정리할 때 미완료 작업을 삭제해서는 안 된다.
• 시작할 때 남아 있는 queued, loading, running, cancelling 작업을 훑어, 각각의 재시작 정책을 적용해야 한다(7.5절).

11.3 시작 시 복구

아래 표는 남아 있던 작업이 on_restart 정책에 따라 옮겨 가는 상태를 보여 준다.

failed로 옮겨진 작업은 오류 코드 server_restarted와 response.failed 이벤트를 받는다. cancelled로 옮겨진 작업은 response.cancelled 이벤트를 받는다. 새 상태와 그 이벤트는 하나의 트랜잭션으로 기록된다(11.2절).