// 오류 참조

MySQL 오류 코드

사람들이 가장 자주 만나는 MySQL 서버·클라이언트 오류 모음. 각 오류마다 MySQL 오류 레퍼런스의 메시지 텍스트와 심볼, SQLSTATE, 오류의 의미, 해결 방법을 담았습니다.

MySQL 오류 읽기

MySQL은 오류를 다음과 같이 보고합니다 ERROR 1062 (23000): Duplicate entry '7' for key 'users.PRIMARY'. 숫자는 MySQL 오류 코드이고, 대괄호 안의 다섯 글자는 SQLSTATE이며, 나머지는 자리 표시자가 채워진 메시지입니다.

1000번부터 1999번까지와 3000번 이상 코드는 서버에서 발생합니다. 2000번부터 2999번까지의 코드는 클라이언트 라이브러리에서 발생하며, 보통 연결이 이루어지지 않았거나 끊어진 경우이므로 서버가 해당 명령문을 보지 못했을 수도 있습니다.

실행 SHOW WARNINGS; 문장 뒤에서 경고와 노트를 볼 수 있는데, 둘 다 같은 번호를 씁니다. 1265나 1366 같은 데이터 오류 대부분은 비엄격 SQL 모드에서는 경고이고, 엄격 모드에서는 오류입니다.

이 참조의 모든 MySQL 오류

79개 코드, 전부 링크된 상세 설명 포함. 코드와 메시지의 출처는 MySQL 8.4 오류 메시지 참조.

연결 및 클라이언트

코드의미
2002 소켓을 통해 연결할 수 없음 CR_CONNECTION_ERROR 소켓 '%s' (%d)를 통해 로컬 MySQL 서버에 연결할 수 없음
2003 호스트의 MySQL 서버에 연결할 수 없음 CR_CONN_HOST_ERROR '%s:%u'의 MySQL 서버에 연결할 수 없음 (%d)
2005 알 수 없는 MySQL 서버 호스트 CR_UNKNOWN_HOST 알 수 없는 MySQL 서버 호스트 '%s' (%d)
2006 MySQL 서버와의 연결이 끊어짐 CR_SERVER_GONE_ERROR MySQL 서버와의 연결이 끊어짐
2013 쿼리 중 MySQL 서버와의 연결이 끊겼습니다 CR_SERVER_LOST 쿼리 중 MySQL 서버와의 연결이 끊겼습니다
2055 다음 단계에서 MySQL 서버와의 연결이 끊겼습니다 CR_SERVER_LOST_EXTENDED '%s' 단계에서 MySQL 서버와의 연결이 끊겼습니다. 시스템 오류: %d
2026 SSL 연결 오류 CR_SSL_CONNECTION_ERROR SSL 연결 오류: %s
2059 인증 플러그인을 불러올 수 없습니다 CR_AUTH_PLUGIN_CANNOT_LOAD 인증 플러그인 '%s'를 불러올 수 없습니다: %s
2061 인증 플러그인이 오류를 보고했습니다 CR_AUTH_PLUGIN_ERR 인증 플러그인 '%s'가 오류를 보고했습니다: %s
1251 클라이언트가 인증 프로토콜을 지원하지 않습니다 ER_NOT_SUPPORTED_AUTH_MODE 서버가 요청한 인증 프로토콜을 클라이언트가 지원하지 않습니다; MySQL 클라이언트 업그레이드를 고려하세요
3159 안전하지 않은 전송 금지 ER_SECURE_TRANSPORT_REQUIRED --require_secure_transport=ON 상태에서는 안전하지 않은 전송을 사용하는 연결이 금지됩니다.
1158 통신 패킷 읽기 오류 ER_NET_READ_ERROR 통신 패킷 읽기 중 오류 발생
1159 통신 패킷 읽기 시간 초과 발생 ER_NET_READ_INTERRUPTED 통신 패킷 읽기 시간 초과 발생
4031 비활성으로 인해 서버에서 연결이 끊김 ER_CLIENT_INTERACTION_TIMEOUT 클라이언트는 유휴 상태가 계속되자 서버가 연결을 끊었습니다. 이 동작을 설정하려면 wait_timeout 및 interactive_timeout을 참고하세요.

접근 및 권한

코드의미
1045 사용자 접근 거부 ER_ACCESS_DENIED_ERROR '%s'@'%s' 사용자에게 접근이 거부되었습니다 (비밀번호 사용: %s)
1044 사용자의 데이터베이스 접근이 거부되었습니다 ER_DBACCESS_DENIED_ERROR '%s'@'%s' 사용자가 데이터베이스 '%s'에 접근할 수 없습니다
1130 호스트의 연결이 허용되지 않습니다 ER_HOST_NOT_PRIVILEGED '%s' 호스트는 이 MySQL 서버에 연결이 허용되지 않습니다
1698 비밀번호 없이 사용자의 접근이 거부되었습니다 ER_ACCESS_DENIED_NO_PASSWORD_ERROR '%s'@'%s' 사용자의 접근이 거부되었습니다
1142 테이블에 대한 명령이 사용자에게 거부되었습니다 ER_TABLEACCESS_DENIED_ERROR %s 명령이 '%s'@'%s' 사용자에게 거부되었습니다: 테이블 '%s'
1143 열에 대한 명령이 사용자에게 거부되었습니다 ER_COLUMNACCESS_DENIED_ERROR %s 명령이 '%s'@'%s' 사용자에게 거부되었습니다: 테이블 '%s'의 열 '%s'
1227 접근 거부됨; 권한이 필요합니다 ER_SPECIFIC_ACCESS_DENIED_ERROR 접근 거부됨; 이 작업을 수행하려면 최소한 %s 권한(들) 중 하나가 필요합니다
1396 CREATE USER 작업이 실패했습니다 ER_CANNOT_USER %s 작업이 %s에 대해 실패했습니다
1419 바이너리 로깅에는 SUPER 권한 필요 ER_BINLOG_CREATE_ROUTINE_NEED_SUPER SUPER 권한이 없고 바이너리 로깅이 활성화되어 있습니다(덜 안전한 log_bin_trust_function_creators 변수를 쓰고 싶을 *수도* 있습니다)
1449 DEFINER 사용자가 존재하지 않습니다 ER_NO_SUCH_USER 정의자로 지정된 사용자('%s'@'%s')가 존재하지 않습니다

구문 및 명령문

코드의미
1064 SQL 문법에 오류가 있습니다 ER_PARSE_ERROR %s, '%s' 근처(%d행)
1149 SQL 문법 오류 ER_SYNTAX_ERROR SQL 구문에 오류가 있습니다; 사용할 올바른 구문은 MySQL 서버 버전에 해당하는 매뉴얼에서 확인하세요
1052 열이 모호합니다 ER_NON_UNIQ_ERROR %s의 열 '%s'이(가) 모호합니다
1055 식이 GROUP BY에 없습니다 ER_WRONG_FIELD_WITH_GROUP '%s'이(가) GROUP BY에 없습니다
1093 업데이트 대상 테이블을 지정할 수 없습니다 ER_UPDATE_TABLE_USED FROM 절에서 업데이트할 대상 테이블 '%s'을(를) 지정할 수 없습니다
1136 열 수가 값 수와 일치하지 않습니다 ER_WRONG_VALUE_COUNT_ON_ROW 행 %ld에서 열 수가 값 수와 일치하지 않습니다
1242 하위 쿼리가 2개 이상의 행을 반환합니다 ER_SUBQUERY_NO_1_ROW 하위 쿼리가 2개 이상의 행을 반환합니다
1248 모든 파생 테이블에는 자체 별칭이 있어야 합니다 ER_DERIVED_MUST_HAVE_ALIAS 모든 파생 테이블에는 자체 별칭이 있어야 합니다
1318 인수 개수가 올바르지 않습니다 ER_SP_WRONG_NO_OF_ARGS %s %s의 인수 개수가 올바르지 않습니다; 예상 %u, 받음 %u

데이터베이스, 테이블 및 열

코드의미
1049 알 수 없는 데이터베이스 ER_BAD_DB_ERROR 알 수 없는 데이터베이스 '%s'
1046 데이터베이스가 선택되지 않았습니다 ER_NO_DB_ERROR 데이터베이스가 선택되지 않았습니다
1054 필드 목록에 알 수 없는 열이 있습니다 ER_BAD_FIELD_ERROR 알 수 없는 열 '%s' ('%s')
1146 테이블이 존재하지 않습니다 ER_NO_SUCH_TABLE 테이블 '%s.%s'이(가) 존재하지 않습니다
1050 테이블이 이미 존재합니다 ER_TABLE_EXISTS_ERROR 테이블 '%s'이(가) 이미 존재합니다
1051 알 수 없는 테이블 ER_BAD_TABLE_ERROR 알 수 없는 테이블 '%s'
1060 중복된 열 이름 ER_DUP_FIELDNAME 중복된 열 이름 '%s'
1091 DROP할 수 없습니다; 해당 열/키가 존재하는지 확인하세요 ER_CANT_DROP_FIELD_OR_KEY '%s'를 DROP할 수 없습니다; 해당 열/키가 존재하는지 확인하세요
1305 함수 또는 프로시저가 존재하지 않습니다 ER_SP_DOES_NOT_EXIST %s %s가 존재하지 않습니다
1442 트리거는 자신의 테이블을 업데이트할 수 없습니다 ER_CANT_UPDATE_USED_TABLE_IN_SF_OR_TRG 저장 함수/트리거에서 테이블 '%s'를 업데이트할 수 없습니다. 이미 이 저장 함수/트리거를 호출한 문장에서 사용 중이기 때문입니다.

키 및 제약 조건

코드의미
1062 키에 대한 중복 항목 ER_DUP_ENTRY 키 %d에 대한 중복 항목 '%s'
1061 중복된 키 이름 ER_DUP_KEYNAME 중복된 키 이름 '%s'
1452 외래 키 실패: 자식 행을 추가할 수 없습니다 ER_NO_REFERENCED_ROW_2 자식 행을 추가하거나 업데이트할 수 없습니다: 외래 키 제약 조건 실패%s
1451 외래 키 실패: 부모 행을 삭제할 수 없습니다 ER_ROW_IS_REFERENCED_2 부모 행을 삭제하거나 업데이트할 수 없습니다: 외래 키 제약 조건 실패%s
1216 자식 행을 추가하거나 업데이트할 수 없습니다 ER_NO_REFERENCED_ROW 자식 행을 추가하거나 업데이트할 수 없습니다: 외래 키 제약 조건 실패
1217 부모 행을 삭제하거나 업데이트할 수 없습니다 ER_ROW_IS_REFERENCED 부모 행을 삭제하거나 업데이트할 수 없습니다: 외래 키 제약 조건 실패
1215 외래 키 제약 조건을 추가할 수 없습니다 ER_CANNOT_ADD_FOREIGN 외래 키 제약 조건을 추가할 수 없습니다
3780 외래 키 열이 호환되지 않습니다 ER_FK_INCOMPATIBLE_COLUMNS 외래 키 제약 조건 '%s'에서 참조 열 '%s'과(와) 피참조 열 '%s'이(가) 호환되지 않습니다.
1822 외래 키 제약 조건에 대한 인덱스가 없습니다 ER_FK_NO_INDEX_PARENT 외래 키 제약 조건을 추가하지 못했습니다. 참조된 테이블 '%s'에 대한 제약 조건 '%s'의 인덱스가 없습니다.
1824 참조된 테이블을 열지 못했습니다. ER_FK_CANNOT_OPEN_PARENT 참조된 테이블 '%s'을(를) 열지 못했습니다.
1048 열은 NULL일 수 없습니다. ER_BAD_NULL_ERROR '%s' 열은 NULL일 수 없습니다.
3819 CHECK 제약 조건이 위반되었습니다. ER_CHECK_CONSTRAINT_VIOLATED CHECK 제약 조건 '%s'이(가) 위반되었습니다.
1071 지정된 키가 너무 깁니다 ER_TOO_LONG_KEY 지정된 키가 너무 깁니다. 최대 키 길이는 %d바이트입니다
1075 자동 증가 열은 하나만 가능하며, 키여야 합니다. ER_WRONG_AUTO_KEY 잘못된 테이블 정의; 자동 증가 열은 하나만 있을 수 있으며 키로 정의해야 합니다
1701 외래 키가 있는 테이블은 잘라낼 수 없습니다 ER_TRUNCATE_ILLEGAL_FK 외래 키 제약 조건(%s)에서 참조되는 테이블은 비울 수 없습니다.
1586 키에 중복 항목이 있습니다(키 이름 포함) ER_DUP_ENTRY_WITH_KEY_NAME 키 '%s'에 대한 중복 항목 '%s'
1826 중복된 외래 키 제약 조건 이름 ER_FK_DUP_NAME 중복된 외래 키 제약 조건 이름 '%s'

데이터 값

코드의미
1364 필드에 기본값이 없습니다. ER_NO_DEFAULT_FOR_FIELD 필드 '%s'에 기본값이 없습니다.
1366 다음 열에 대한 값이 잘못되었습니다 ER_TRUNCATED_WRONG_VALUE_FOR_FIELD 열 '%s'의 행 %ld에서 잘못된 %s 값: '%s'
1406 열의 데이터가 너무 깁니다 ER_DATA_TOO_LONG 행 %ld의 열 '%s' 데이터가 너무 깁니다
1292 잘못된 값 잘림 ER_TRUNCATED_WRONG_VALUE 잘못된 %s 값 잘림: '%s'
1264 열의 값이 범위를 벗어남 ER_WARN_DATA_OUT_OF_RANGE 행 %ld의 열 '%s'에 대한 값이 범위를 벗어남
1265 열의 데이터가 잘렸습니다 WARN_DATA_TRUNCATED 행 %ld의 열 '%s' 데이터가 잘렸습니다
1067 잘못된 기본값 ER_INVALID_DEFAULT '%s'의 잘못된 기본값

트랜잭션과 잠금

코드의미
1205 잠금 대기 시간 초과 ER_LOCK_WAIT_TIMEOUT 잠금 대기 시간 초과; 트랜잭션을 다시 시작해 보십시오
1213 잠금을 얻으려는 중 데드락 발생 ER_LOCK_DEADLOCK 잠금을 얻으려는 중 데드락 발생; 트랜잭션을 다시 시작해 보세요
3572 NOWAIT으로 잠금을 획득할 수 없습니다. ER_LOCK_NOWAIT 잠금을 즉시 획득할 수 없고 NOWAIT이 설정되어 있기 때문에 문장이 중단되었습니다.
1206 잠금이 잠금 테이블 크기를 초과합니다. ER_LOCK_TABLE_FULL 잠금의 총 수가 잠금 테이블 크기를 초과합니다.
1792 읽기 전용 트랜잭션에서 쓰기 ER_CANT_EXECUTE_IN_READ_ONLY_TRANSACTION 읽기 전용 트랜잭션에서 문장을 실행할 수 없습니다.
3024 최대 문 실행 시간을 초과했습니다 ER_QUERY_TIMEOUT 최대 문 실행 시간을 초과해 쿼리 실행이 중단되었습니다

서버 제한 및 설정

코드의미
1040 연결이 너무 많습니다 ER_CON_COUNT_ERROR 연결이 너무 많습니다
1203 사용자가 최대 사용자 연결 수를 초과했습니다 ER_TOO_MANY_USER_CONNECTIONS 사용자 %s는 이미 'max_user_connections'를 초과하는 활성 연결을 가지고 있습니다
1153 max_allowed_packet보다 큰 패킷을 받았습니다 ER_NET_PACKET_TOO_LARGE 'max_allowed_packet' 바이트보다 큰 패킷을 받았습니다
1175 안전 업데이트 모드가 이 문을 차단했습니다 ER_UPDATE_WITHOUT_KEY_IN_SAFE_MODE 안전 업데이트 모드를 사용 중이고, KEY 열을 사용한 WHERE 없이 테이블을 업데이트하려고 했습니다. %s
1290 서버 옵션이 이 문을 차단합니다 ER_OPTION_PREVENTS_STATEMENT MySQL 서버가 %s 옵션으로 실행 중이므로 이 명령문을 실행할 수 없습니다
1114 테이블이 가득 찼습니다 ER_RECORD_FILE_FULL 테이블 '%s'이(가) 가득 찼습니다
// 하나의 클라이언트, 모든 엔진

MySQL과 더 빠르게 작업하는 방법

SQLly는 macOS, Windows, Linux용 네이티브 SQL 클라이언트로, 스키마 인식 IntelliSense와 위험한 명령문에 대한 안전장치를 갖추고 있습니다.