Query execution was interrupted (max_statement_time exceeded)

오류 식별

현재 화면 또는 로그의 오류 코드와 메시지를 MariaDB 공식 오류 코드 참조와 대조합니다.

• 오류 코드가 1969인지 확인합니다.
• 오류 이름이 ER_STATEMENT_TIMEOUT인지 확인합니다.
• 오류 메시지가 Query execution was interrupted (max_statement_time exceeded)와 정확히 같은지 확인합니다.

세 항목이 일치하면 MariaDB 오류 코드 1969으로 식별할 수 있습니다.

출처: MariaDB Error Code Reference (새 창에서 열림)

진단 기록

먼저 문제가 발생한 URL 또는 화면, 표시 시각, 사용한 플랫폼과 배포 버전을 기록합니다. 화면과 로그에서 오류 문자열이 일부만 보이면 앞뒤 문장을 포함해 원문을 보존하고, 민감한 값은 가립니다.

다음 순서로 관찰값을 대조합니다.

1. 현재 화면 또는 로그에 오류 코드 1969가 표시되는지 확인합니다.
2. 현재 화면 또는 로그에 ER_STATEMENT_TIMEOUT이 표시되는지 확인합니다.
3. 현재 화면 또는 로그의 메시지가 "Query execution was interrupted (max_statement_time exceeded)"와 정확히 일치하는지 확인합니다.

각 항목은 확인한 값과 확인하지 못한 이유를 함께 기록해야 합니다. 이 문서의 조건과 실제 관찰값이 다르면 원인을 단정하지 말고, 문제 해결 시작 가이드에서 더 넓은 분기를 선택하십시오.

판정 기준

오류 문자열이 일치한다는 사실만으로 원인이 확정되지는 않습니다. 같은 문구가 여러 환경에서 나타날 수 있으므로 웹서버·런타임·운영체제·최근 변경 사항을 함께 비교합니다. 한 단계에서 기대한 값이 나오지 않으면 다음 단계로 넘어가지 말고 해당 환경의 공식 문서를 우선 확인합니다.

안전한 다음 단계

검사 전에 백업과 변경 이력을 확인하고, 비밀번호·세션 쿠키·인증 토큰·개인정보를 공개 로그나 문의 내용에 넣지 않습니다. 설정·권한·데이터를 변경해야 한다면 영향 범위와 되돌리는 방법을 먼저 기록한 뒤 운영 시간과 승인 절차에 맞춰 진행합니다.

원인 분포

[Observation] 수집된 3건의 사례에서는 문 실행 제한 시간이 쿼리를 중단한 원인으로 확인되거나 지목되었습니다.

• [Observation] 서버 또는 사용자 계정 수준의 timeout 설정이 대용량 조회를 중단한 사례가 있습니다.
• [Observation] Connector/ODBC 5.3 계열이 60초의 max_execution_time을 유지해 장기 쿼리를 중단시킨 정황이 있습니다.
• [Observation] 세션 제한보다 짧은 문별 MAX_EXECUTION_TIME(5000) 제한으로 중단이 재현된 사례가 있습니다.

[Hypothesis] 이 문서의 수집 사례 범위에서는 서버·계정·클라이언트 드라이버·문 단위 설정을 우선적인 원인 후보로 확인할 수 있습니다. 이는 실제 발생 빈도 집계가 아니라 관측된 사례 기준입니다.

오진 함정

• [Observation] 오류 메시지에 표시된 변수 이름만으로 실제 적용된 제한 범위를 판단하기 어려운 사례가 있습니다. 문별 제한 시간이 세션 max_statement_time보다 짧았지만 오류 메시지는 변수 이름만 가리켰습니다.
• [Observation] 애플리케이션 또는 데이터베이스 자체 문제로 보일 수 있지만, 사례 1에서는 서버 쪽 MySQL/HeidiSQL 문 실행 제한 시간이 원인으로 확인되었습니다.
• [Observation] Connector/ODBC 설정이 장기 쿼리를 중단시킬 수 있으므로 데이터베이스 설정만 확인하면 원인을 놓칠 수 있습니다.

환경 매트릭스

환경 또는 제한 범위	관측된 사실	근거
Spotfire Server 7.0 이상, MySQL 또는 HeidiSQL	대용량 조회 중 서버 쪽 문 실행 제한 시간으로 오류 발생	[Observation] 사례 1
Windows Server 2012, IIS 8, MySQL 5.7.11, Connector/ODBC 5.3 계열	max_execution_time 60초가 장기 쿼리를 중단시킨 정황	[Observation] 사례 2
MySQL 5.7.7-rc	문별 제한 시간이 세션 max_statement_time보다 짧을 때 오류 메시지가 제한 변수 이름만 표시	[Observation] 사례 3
MySQL 5.7.8 및 5.8.0	더 일반적인 timeout 메시지로 변경된 기록	[Observation] 사례 3

진단 순서

1. [Observation] 오류가 발생한 데이터베이스 버전과 연결 경로를 확인합니다. 사례에는 Spotfire Server, MySQL, HeidiSQL, IIS, Connector/ODBC가 포함되어 있습니다.
2. [Observation] 서버 수준과 사용자 계정 수준의 timeout 설정을 확인합니다.
3. [Observation] 클라이언트 드라이버가 유지하는 max_execution_time 값을 확인합니다. 사례 2에서는 Connector/ODBC 5.3 계열의 60초 설정이 정황으로 제시되었습니다.
4. [Observation] 세션 max_statement_time과 문별 MAX_EXECUTION_TIME 또는 MAX_EXECUTION_TIME(5000) 적용 여부를 각각 확인합니다.
5. [Observation] 오류 메시지의 변수 이름만으로 제한 범위를 확정하지 않습니다. 사례 3에서는 실제 제한이 문별 값이었습니다.
6. [Observation] 설정 변경 또는 쿼리 힌트 적용 전 해당 사례의 안내 범위와 실행 환경을 대조합니다. 사례 1은 데이터베이스 또는 사용자 계정 수준 timeout 재구성을 안내했고, 사례 2는 쿼리 힌트와 전역 timeout 설정을 제시했습니다.