데이터베이스 오류 코드
데이터베이스 서버 또는 클라이언트가 연결·질의·트랜잭션·무결성 처리 결과를 구분해 반환하는 코드와 메시지입니다.
정상 동작 조건
요약
확인 절차
데이터베이스 오류 코드는 서버나 클라이언트가 연결, 권한, 질의, 트랜잭션, 무결성 검증 결과를 구분해 반환하는 식별자입니다.
같은 SQLSTATE나 숫자 코드가 있어도 제품별 메시지와 조치 범위는 다를 수 있습니다. 현재 화면 또는 로그의 코드·메시지를 제품 공식 문서와 비교한 뒤, 해당 제품의 연결 정보와 실행 환경을 추가로 확인해야 합니다.
MySQL은 이 구성요소가 적용되는 데이터베이스 제품 중 하나입니다.
관련 오류
Cannot truncate a table referenced in a foreign key constraint (%s)
MariaDB 오류 코드 1701의 오류 메시지를 로그 또는 클라이언트 출력에서 식별하는 문서입니다.
Connection was killed
MariaDB 오류 코드 1927의 메시지를 확인하는 문서입니다.
Query execution was interrupted (max_statement_time exceeded)
MariaDB 오류 코드 1969(ER_STATEMENT_TIMEOUT)의 오류 메시지 식별 문서입니다.
Access denied for user '%s'@'%s' to database '%s'
MySQL 오류 1044(ER_DBACCESS_DENIED_ERROR)를 화면 또는 로그의 오류 코드·SQLSTATE·메시지로 식별합니다.
Cannot add or update a child row: a foreign key constraint fails
MariaDB 또는 MySQL에서 오류 코드 1216과 함께 표시되는 외래 키 제약 조건 오류 메시지를 식별합니다.
Can't create database '%s'; database exists
MySQL에서 이미 존재하는 데이터베이스를 생성하려 할 때 표시되는 오류입니다.
Can't drop database '%s'; database doesn't exist
MySQL 오류 번호 1008(ER_DB_DROP_EXISTS)을 화면 또는 로그의 메시지와 대조하는 문서입니다.
Can't write; duplicate key in table '%s'
MySQL ER_DUP_KEY 오류 메시지를 오류 번호와 SQLSTATE로 대조해 식별합니다.
Column '%s' cannot be null
MariaDB/MySQL 오류 코드 1048의 오류 메시지를 식별합니다.
Column '%s' in %s is ambiguous
MySQL 오류 1052에서 열 참조가 모호할 때 표시되는 메시지의 확인 및 쿼리 수정 방법입니다.
Table '%s' is read only
MySQL 오류 1036(ER_OPEN_AS_READONLY)의 메시지 형식을 확인하는 문서입니다.
'%s' isn't in GROUP BY
MySQL 오류 번호 1055와 메시지 형식을 대조해 GROUP BY 관련 오류를 식별합니다.
No database selected
MySQL 오류 번호 1046(ER_NO_DB_ERROR, SQLSTATE 3D000)의 메시지를 식별합니다.
Out of range value for column '%s' at row %ld
MariaDB 오류 코드 1264와 SQLSTATE 22003의 오류 문자열을 로그 또는 클라이언트 출력에서 식별합니다.
Subquery returns more than 1 row
MySQL 오류 1242(ER_SUBQUERY_NO_1_ROW)를 화면 또는 로그의 오류 문자열로 식별합니다.
Table '%s' already exists
MySQL 오류 번호 1050(ER_TABLE_EXISTS_ERROR)의 메시지 형식을 확인합니다.
Table '%s.%s' doesn't exist
MariaDB 오류 코드 1146과 SQLSTATE 42S02에 해당하는 테이블 미존재 오류 메시지를 식별합니다.
You must SET PASSWORD before executing this statement
MariaDB/MySQL 오류 코드 1820의 오류 메시지를 식별합니다.
unique_violation
PostgreSQL SQLSTATE 23505는 unique_violation 조건을 나타내는 오류 코드입니다.
42883
PostgreSQL SQLSTATE 42883은 undefined_function 조건 이름에 해당합니다.
53300
PostgreSQL SQLSTATE 53300은 too_many_connections 조건을 나타냅니다.
Prisma needs to perform transactions, which requires your MongoDB server to be run as a replica set. See details: https://pris.ly/d/mongodb-replica-set
Prisma P2031 오류 메시지로 MongoDB replica set 실행 요구를 식별합니다.
Authentication failed against database server at {database_host}, the provided database credentials for {database_user} are not valid. Please make sure to provide valid database credentials for the database server at {database_host}.
Prisma P1000 오류 메시지를 대조하여 제공된 데이터베이스 자격 증명이 유효하지 않은 경우를 식별합니다.
The database server at {database_host}:{database_port} was reached but timed out. Please try again. Please make sure your database server is running at {database_host}:{database_port}.
Prisma P1002 오류 메시지를 확인해 데이터베이스 서버에 도달한 뒤 시간 초과된 상태를 식별합니다.
Database {database_name} already exists on the database server at {database_host}:{database_port}
Prisma P1009 오류 메시지가 데이터베이스 서버에 같은 이름의 데이터베이스가 이미 있음을 나타내는지 확인합니다.
User {database_user} was denied access on the database {database_name}
Prisma P1010 오류 메시지를 화면 또는 로그에서 확인하는 문서입니다.
The provided database string is invalid. {details}
Prisma 오류 코드 P1013의 메시지를 현재 로그 또는 화면의 오류 문자열과 비교해 식별합니다.
The underlying {kind} for model {model} does not exist.
Prisma 오류 코드 P1014는 지정된 모델의 기반 {kind}가 존재하지 않음을 나타냅니다.
Your Prisma schema is using features that are not supported for the version of the database. Database version: {database_version} Errors: {errors}
Prisma P1015 오류 메시지를 현재 로그와 대조해 데이터베이스 버전에서 지원되지 않는 Prisma schema 기능이 포함되었는지 식별합니다.
Your raw query had an incorrect number of parameters. Expected: {expected}, actual: {actual}.
Prisma P1016 오류 메시지가 표시될 때 raw query의 기대 매개변수 수와 실제 매개변수 수를 확인합니다.
Server has closed the connection.
Prisma 오류 코드 P1017의 메시지를 화면 또는 로그에서 식별하는 문서입니다.
The provided value for the column is too long for the column's type. Column: {column_name}
Prisma Client Query Engine의 P2000 오류 메시지 식별 문서입니다.
The record searched for in the where condition ({model_name}.{argument_name} = {argument_value}) does not exist
Prisma Client Query Engine의 P2001 오류 메시지를 식별하는 문서입니다.
Unique constraint failed on the {constraint}
Prisma Client Query Engine의 P2002 오류 메시지를 식별하는 문서입니다.
Foreign key constraint failed on the field: {field_name}
Prisma Client의 P2003 오류 메시지를 로그 또는 화면에서 대조해 외래 키 제약 조건 실패를 식별합니다.
A constraint failed on the database: {database_error}
Prisma Client P2004 오류 메시지를 확인하고 공식 오류 참조와 대조합니다.
The value {field_value} stored in the database for the field {field_name} is invalid for the field's type
Prisma Client의 P2005 오류 메시지를 확인하는 문서입니다.
The provided value {field_value} for {model_name} field {field_name} is not valid
Prisma P2006 오류 메시지를 로그 또는 화면에서 대조해 식별합니다.
Data validation error {database_error}
Prisma Client Query Engine의 P2007 오류 메시지를 식별하는 문서입니다.
Failed to parse the query {query_parsing_error} at {query_position}
Prisma Client Query Engine의 P2008 오류 메시지를 화면 또는 로그에서 대조해 쿼리 구문 분석 실패를 식별합니다.
Failed to validate the query: {query_validation_error} at {query_position}
Prisma Client Query Engine의 P2009 오류 메시지를 식별하는 문서입니다.
Raw query failed. Code: {code}. Message: {message}
Prisma P2010 오류 메시지를 현재 로그 또는 화면의 문자열과 대조해 Raw query 실패를 식별합니다.
Missing a required value at {path}
Prisma Client Query Engine의 P2012 오류 메시지를 코드와 문자열로 식별합니다.
Missing the required argument {argument_name} for field {field_name} on {object_name}.
Prisma P2013 오류 메시지로 필수 인수가 누락된 위치를 식별합니다.
The change you are trying to make would violate the required relation '{relation_name}' between the {model_a_name} and {model_b_name} models.
Prisma Client의 P2014 오류 메시지를 로그 또는 화면의 메시지와 대조해 필수 관계 위반 오류인지 식별합니다.
A related record could not be found. {details}
Prisma Client Query Engine의 P2015 오류 메시지를 식별하는 문서입니다.
Query interpretation error. {details}
Prisma Client Query Engine에서 P2016과 함께 표시되는 쿼리 해석 오류 메시지를 식별합니다.
The records for relation {relation_name} between the {parent_name} and {child_name} models are not connected.
Prisma Client에서 관계 레코드가 연결되지 않았음을 나타내는 P2017 오류 메시지 식별 방법입니다.
The required connected records were not found. {details}
Prisma Client의 P2018 오류는 필수로 연결되어야 하는 레코드를 찾지 못했음을 나타냅니다.
Input error. {details}
Prisma P2019 오류 메시지를 원문 형식과 대조해 식별합니다.
Value out of range for the type. {details}
Prisma Client Query Engine의 P2020 오류 메시지를 식별하는 문서입니다.
The table {table} does not exist in the current database.
Prisma P2021 오류 메시지로 현재 데이터베이스에 없는 테이블을 식별합니다.
The column {column} does not exist in the current database.
Prisma Client의 P2022 오류 메시지로 현재 데이터베이스에 없는 열을 식별합니다.
Inconsistent column data: {message}
Prisma P2023 오류 메시지를 원문 템플릿과 대조해 식별합니다.
Timed out fetching a new connection from the connection pool. (More info: http://pris.ly/d/connection-pool (Current connection pool timeout: {timeout}, connection limit: {connection_limit})
Prisma P2024 오류 메시지를 현재 로그 또는 화면의 문자열과 대조해 연결 풀에서 새 연결을 가져오는 시간 초과인지 확인합니다.
An operation failed because it depends on one or more records that were required but not found. {cause}
Prisma Client의 P2025 오류 메시지를 식별하고 의미를 확인합니다.
The current database provider doesn't support a feature that the query used: {feature}
Prisma Client에서 현재 데이터베이스 제공자가 쿼리에 사용된 기능을 지원하지 않을 때 표시되는 P2026 오류 메시지입니다.
Multiple errors occurred on the database during query execution: {errors}
Prisma P2027 오류 메시지를 대조하여 쿼리 실행 중 데이터베이스에서 복수 오류가 발생했는지 확인합니다.
Transaction API error: {error}
Prisma Client Query Engine의 P2028 오류 메시지를 코드와 문자열로 식별합니다.
Query parameter limit exceeded error: {message}
Prisma Client에서 P2029 오류 메시지가 표시될 때 오류 코드를 식별하는 문서입니다.
Cannot find a fulltext index to use for the search, try adding a @@fulltext([Fields...]) to your schema
Prisma P2030 오류 메시지를 확인해 전체 텍스트 검색에 사용할 fulltext index를 찾지 못한 오류를 식별합니다.
A number used in the query does not fit into a 64 bit signed integer. Consider using BigInt as field type if you're trying to store large integers
Prisma P2033 오류 메시지를 원문과 대조해 쿼리에 사용한 숫자가 64비트 signed integer 범위를 벗어났는지 식별합니다.
Transaction failed due to a write conflict or a deadlock. Please retry your transaction
Prisma P2034 오류 메시지를 현재 로그 또는 화면의 문자열과 대조해 식별합니다.
Assertion violation on the database: {database_error}
Prisma 오류 코드 P2035는 데이터베이스 assertion 위반을 나타냅니다.
Too many database connections opened: {message}
Prisma Client Query Engine의 P2037 오류 메시지를 식별하는 문서입니다.
Failed to create database: {database_error}
Prisma Migrate에서 P3000 오류 메시지로 데이터베이스 생성 실패를 식별합니다.
You have an error in your SQL syntax; check the manual that corresponds to your MariaDB server version for the right syntax to use
MariaDB 공식 원문에 표시된 You have an error in your SQL syntax; check the manual that corresponds to your MariaDB server version for the right syntax to use 항목의 문구를 확인하는 문서입니다.
Unknown character set: '%s'
MariaDB 공식 원문에 표시된 Unknown character set: '%s' 항목의 문구를 확인하는 문서입니다.
Unknown or incorrect time zone: '%s'
MariaDB 공식 원문에 표시된 Unknown or incorrect time zone: '%s' 항목의 문구를 확인하는 문서입니다.
Unknown storage engine '%s'
MariaDB 공식 원문에 표시된 Unknown storage engine '%s' 항목의 문구를 확인하는 문서입니다.
Unknown table '%s'
MariaDB 공식 원문에 표시된 Unknown table '%s' 항목의 문구를 확인하는 문서입니다.
Variable '%s' can't be set to the value of '%s'
MariaDB 공식 원문에 표시된 Variable '%s' can't be set to the value of '%s' 항목의 문구를 확인하는 문서입니다.
참고 자료
확인 범위: sqlstate-error-codes, condition-identification · 확인일: 2026-07-24
확인 범위: server-error-code, message-identification · 확인일: 2026-07-24