io_max_workers

asynchronous I/O를 처리하는 I/O worker process의 최대 수를 정합니다. PostgreSQL 19(beta)에서 추가된 파라미터로, 기본값은 8입니다.

io_method가 worker일 때만 효과가 있고, postgresql.conf 파일이나 서버 커맨드라인에서만 설정할 수 있습니다. PostgreSQL 19에서 자동 조절 방식으로 바뀐 I/O worker pool 구조와 관련 파라미터 네 개의 관계는 io_min_workers에 정리했습니다.

상한은 인스턴스 전체 기준입니다. I/O 대기가 몰리면 pool이 이 값까지 커지고, 부하가 빠지면 io_worker_idle_timeout에 따라 다시 줄어듭니다.

노트

운영 노트: I/O 대기가 길게 관찰되는데 pool이 상한에 붙어 있다면 값을 올려볼 수 있습니다. 다만 I/O worker도 process이므로 CPU·메모리 여유와 storage가 감당할 수 있는 동시 I/O 수준을 함께 봐야 합니다.

출처: PostgreSQL 19 문서