ORA-03049: SQL 키워드가 ... 다음에 구문적으로 유효하지 않습니다
ORA-03049: SQL 키워드 'LIMIT'은(는) '...emp ORDER BY salary DESC ' 다음에 구문적으로 유효하지 않습니다.ORA-03049: SQL keyword 'LIMIT' is not syntactically valid following '...emp ORDER BY salary DESC '문법상 올 수 없는 자리에 단어가 나왔어요.
실제 DB 검증Oracle AI Database 26ai Free 23.26.3.0.0에서 재현·해결 확인 · 2026-11-13
ORA-03049는 오라클 23ai에서 새로 생긴 구문 에러예요. 예전 버전에서는 같은 실수가 대개 ORA-00933 등으로 나왔어요. 메시지에 문제 단어와 그 바로 앞 문장이 같이 나와서 위치 찾기가 쉬워요.
이름은 "SQL 키워드"지만 진짜 키워드가 아닐 수도 있어요. 이 실습에서도 SALARY, DEPT_ID 같은 컬럼명이 키워드로 표시됐어요. "따옴표 안 문장 뒤에 이 단어가 올 수 없다"로 읽으면 돼요.
원인별 해결 방법
1ORDER BY 뒤에 MySQL/PostgreSQL의 LIMIT
오라클에는 LIMIT 절이 없어요. 그래서 ORDER BY salary DESC 뒤의 LIMIT에서 에러가 나요.
표준 행 제한 절 FETCH FIRST 2 ROWS ONLY를 쓰세요. 급여 상위 2명(Park 6100, Kim 5000)이 나왔어요. 페이징은 OFFSET 1 ROWS FETCH NEXT 2 ROWS ONLY로 첫 행을 건너뛰고 Kim, Lee가 나왔어요.
사전 준비
CREATE TABLE emp (emp_id NUMBER PRIMARY KEY, name VARCHAR2(20), dept_id NUMBER, salary NUMBER);
INSERT INTO emp VALUES (1, 'Kim', 10, 5000);
INSERT INTO emp VALUES (2, 'Lee', 10, 4200);
INSERT INTO emp VALUES (3, 'Park', 20, 6100);
INSERT INTO emp VALUES (4, 'Choi', 20, 3900);
COMMIT;Table created.
1 row created.
1 row created.
1 row created.
1 row created.
Commit complete.SELECT name, salary
FROM emp
ORDER BY salary DESC
LIMIT 2; LIMIT 2
*
ERROR at line 4:
ORA-03049: SQL keyword 'LIMIT' is not syntactically valid following '...emp
ORDER BY salary DESC
'
Help: https://docs.oracle.com/error-help/db/ora-03049/SELECT name, salary
FROM emp
ORDER BY salary DESC
OFFSET 1 ROWS FETCH NEXT 2 ROWS ONLY;NAME SALARY
------------------------------ ----------
Kim 5000
Lee 4200
2 rows selected.ORDER BY 없이 SELECT ... LIMIT n으로 쓰면 다른 에러 ORA-03047이 나요. LIMIT을 테이블 별칭으로 읽고 뒤의 숫자에서 걸리기 때문이에요.
SELECT name, salary
FROM emp
ORDER BY salary DESC
FETCH FIRST 2 ROWS ONLY;NAME SALARY
------------------------------ ----------
Park 6100
Kim 5000
2 rows selected.2WHERE 조건 두 개 사이에 AND가 빠짐
WHERE dept_id = 10 다음 줄에 salary >= 4500을 쓰면서 AND를 빼먹었어요. 메시지가 ...WHERE dept_id = 10 뒤의 SALARY를 가리켜요.
두 번째 조건 앞에 AND를 넣으면 1건(Kim)이 조회됐어요.
사전 준비
CREATE TABLE emp (emp_id NUMBER PRIMARY KEY, name VARCHAR2(20), dept_id NUMBER, salary NUMBER);
INSERT INTO emp VALUES (1, 'Kim', 10, 5000);
INSERT INTO emp VALUES (2, 'Lee', 10, 4200);
INSERT INTO emp VALUES (3, 'Park', 20, 6100);
INSERT INTO emp VALUES (4, 'Choi', 20, 3900);
COMMIT;Table created.
1 row created.
1 row created.
1 row created.
1 row created.
Commit complete.SELECT emp_id, name
FROM emp
WHERE dept_id = 10
salary >= 4500; salary >= 4500
*
ERROR at line 4:
ORA-03049: SQL keyword 'SALARY' is not syntactically valid following '...WHERE dept_id = 10
'
Help: https://docs.oracle.com/error-help/db/ora-03049/SELECT COUNT(*) AS cnt FROM emp WHERE dept_id = 10; CNT
----------
2
1 row selected.SELECT emp_id, name
FROM emp
WHERE dept_id = 10
AND salary >= 4500; EMP_ID NAME
---------- ------------------------------
1 Kim
1 row selected.3UPDATE ... SET 컬럼 사이 쉼표가 빠짐
SET name = 'Kim2' 다음 줄 dept_id = 20 사이에 쉼표가 없어요. 오라클은 ...SET name = 'Kim2' 뒤의 DEPT_ID를 가리켜요.
마지막 것 빼고 각 대입 뒤에 쉼표를 넣으면 1건이 Kim2 / 20으로 바뀌었어요(실습에서는 확인 후 ROLLBACK).
사전 준비
CREATE TABLE emp (emp_id NUMBER PRIMARY KEY, name VARCHAR2(20), dept_id NUMBER, salary NUMBER);
INSERT INTO emp VALUES (1, 'Kim', 10, 5000);
INSERT INTO emp VALUES (2, 'Lee', 10, 4200);
INSERT INTO emp VALUES (3, 'Park', 20, 6100);
INSERT INTO emp VALUES (4, 'Choi', 20, 3900);
COMMIT;Table created.
1 row created.
1 row created.
1 row created.
1 row created.
Commit complete.UPDATE emp
SET name = 'Kim2'
dept_id = 20
WHERE emp_id = 1; dept_id = 20
*
ERROR at line 3:
ORA-03049: SQL keyword 'DEPT_ID' is not syntactically valid following '...SET name = 'Kim2'
'
Help: https://docs.oracle.com/error-help/db/ora-03049/SELECT emp_id, name, dept_id FROM emp WHERE emp_id = 1; EMP_ID NAME DEPT_ID
---------- ------------------------------ ----------
1 Kim 10
1 row selected.UPDATE emp
SET name = 'Kim2',
dept_id = 20
WHERE emp_id = 1;
SELECT emp_id, name, dept_id FROM emp WHERE emp_id = 1;
ROLLBACK;1 row updated.
EMP_ID NAME DEPT_ID
---------- ------------------------------ ----------
1 Kim2 20
1 row selected.
Rollback complete.4MySQL에서 쓰던 DELETE ... LIMIT n
MySQL은 DELETE ... LIMIT 1이 되지만 오라클은 안 돼요. WHERE 조건 뒤의 LIMIT에서 에러가 나요.
WHERE에 AND ROWNUM <= 1을 붙이세요. 부서 20의 2건 중 1건이 지워져 건수가 2에서 1이 됐어요.
사전 준비
CREATE TABLE emp (emp_id NUMBER PRIMARY KEY, name VARCHAR2(20), dept_id NUMBER, salary NUMBER);
INSERT INTO emp VALUES (1, 'Kim', 10, 5000);
INSERT INTO emp VALUES (2, 'Lee', 10, 4200);
INSERT INTO emp VALUES (3, 'Park', 20, 6100);
INSERT INTO emp VALUES (4, 'Choi', 20, 3900);
COMMIT;Table created.
1 row created.
1 row created.
1 row created.
1 row created.
Commit complete.DELETE FROM emp
WHERE dept_id = 20
LIMIT 1; LIMIT 1
*
ERROR at line 3:
ORA-03049: SQL keyword 'LIMIT' is not syntactically valid following '...FROM emp
WHERE dept_id = 20
'
Help: https://docs.oracle.com/error-help/db/ora-03049/SELECT COUNT(*) AS cnt FROM emp WHERE dept_id = 20; CNT
----------
2
1 row selected.ROWNUM은 오라클이 먼저 읽은 행을 고를 뿐, 특정 행을 고르지 않아요. 지울 행이 정해져 있다면 WHERE에 키 값을 쓰세요.
DELETE FROM emp
WHERE dept_id = 20
AND ROWNUM <= 1;
SELECT COUNT(*) AS cnt FROM emp WHERE dept_id = 20;
ROLLBACK;1 row deleted.
CNT
----------
1
1 row selected.
Rollback complete.자주 묻는 질문
오라클 23ai에서는 LIMIT 쓸 수 있어요?
아니요. 이 23ai 실습에서 ORDER BY ... LIMIT 2와 DELETE ... LIMIT 1 모두 에러가 났어요. SELECT는 FETCH FIRST n ROWS ONLY, DELETE는 ROWNUM <= n을 쓰세요.
ORA-03049가 왜 컬럼명을 키워드라고 해요?
그 자리에 예상하지 못한 단어를 모두 "SQL 키워드"라고 표시해요. 따옴표 안 앞 문장의 끝을 보면 대개 AND나 쉼표가 빠져 있어요.
ORA-03049와 ORA-03048은 뭐가 달라요?
둘 다 23ai 구문 에러예요. ORA-03049는 올 수 없는 키워드·이름을, ORA-03048은 AS, ORDER, ) 같은 예약어·기호를 가리켜요.
오라클에서 페이징(OFFSET/LIMIT)은 어떻게 해요?
ORDER BY ... OFFSET m ROWS FETCH NEXT n ROWS ONLY를 쓰세요. 이 실습에서 OFFSET 1 ROWS FETCH NEXT 2 ROWS ONLY는 정렬 결과의 2·3번째 행을 돌려줬어요.
검증 방법
시나리오마다 새 DB 사용자를 만들어 시작해요. 스크립트가 사전 준비 → 에러 재현(에러 코드 일치 확인) → 해결 → 원래 문장 재실행 순서로 실행하고, 화면의 출력은 DB가 실제로 낸 결과를 스크립트가 그대로 저장한 거예요.
lab_a, lab_b는 테스트용 일반 사용자, system은 DBA 계정이에요. Oracle AI Database 26ai Free Release 23.26.3.0.0 - Develop, Learn, and Run for Free