2026/11/19

오늘의 이야기

Oracle JDBC PreparedStatement의 실제 실행 SQL 확인 방법


jdbc sql log



 


Oracle JDBC를 사용하다 보면 PreparedStatement에 파라미터를 설정한 후 실제로 어떤 SQL이 실행되는지 확인하고 싶은 경우가 많다.


예를 들어 다음과 같은 코드가 있다고 가정하자.



String sql = "SELECT * FROM EMP WHERE EMPNO = ? AND ENAME = ?";

PreparedStatement pstmt = conn.prepareStatement(sql);

pstmt.setInt(1, 7369);
pstmt.setString(2, "SMITH");

ResultSet rs = pstmt.executeQuery();

개발자가 확인하고 싶은 SQL은 다음과 같은 형태일 것이다.



SELECT *
FROM EMP
WHERE EMPNO = 7369
AND ENAME = 'SMITH';



Oracle JDBC의 특징


MySQL이나 일부 JDBC 드라이버는 PreparedStatement.toString() 호출 시 파라미터가 치환된 SQL을 보여주기도 한다.


하지만 Oracle JDBC는 대부분 실제 SQL을 보여주지 않는다.



System.out.println(pstmt);

출력 예시



oracle.jdbc.driver.OraclePreparedStatementWrapper@2a139a55

또는 단순히 SQL 템플릿만 출력될 수 있다.



SELECT * FROM EMP WHERE EMPNO = ? AND ENAME = ?

즉, Oracle JDBC만으로는 바인드 값이 포함된 최종 SQL을 직접 얻기 어렵다.




방법 1. 파라미터를 별도로 로그 출력하기


가장 단순하고 많이 사용하는 방법이다.



String sql =
"SELECT * FROM EMP WHERE EMPNO = ? AND ENAME = ?";

int empno = 7369;
String ename = "SMITH";

PreparedStatement pstmt = conn.prepareStatement(sql);

pstmt.setInt(1, empno);
pstmt.setString(2, ename);

System.out.println("SQL : " + sql);
System.out.println("EMPNO : " + empno);
System.out.println("ENAME : " + ename);

출력 결과



SQL : SELECT * FROM EMP WHERE EMPNO = ? AND ENAME = ?
EMPNO : 7369
ENAME : SMITH



방법 2. 디버그용 SQL 생성하기


실행 전에 디버깅용 SQL 문자열을 만들어 출력하는 방법이다.



String sql =
"SELECT * FROM EMP WHERE EMPNO = ? AND ENAME = ?";

int empno = 7369;
String ename = "SMITH";

String debugSql = sql
.replaceFirst("\\\\?", String.valueOf(empno))
.replaceFirst("\\\\?", "'" + ename + "'");

System.out.println(debugSql);

출력 결과



SELECT * FROM EMP WHERE EMPNO = 7369 AND ENAME = 'SMITH'

단, 문자열에 작은따옴표('), 날짜 타입, NULL 값 등이 있는 경우에는 정확한 처리가 필요하므로 운영 코드보다는 디버깅 용도로 사용하는 것이 좋다.




방법 3. 재사용 가능한 유틸 메서드 만들기


PreparedStatement 파라미터가 많은 경우에는 별도 유틸을 만들어 사용할 수 있다.



public static String makeSql(String sql, Object... params) {

for (Object param : params) {

String value;

if (param instanceof String) {
value = "'" + param + "'";
} else {
value = String.valueOf(param);
}

sql = sql.replaceFirst("\\\\?", value);
}

return sql;
}

사용 예시



String debugSql = makeSql(
"SELECT * FROM EMP WHERE EMPNO = ? AND ENAME = ?",
7369,
"SMITH"
);

System.out.println(debugSql);

출력 결과



SELECT * FROM EMP WHERE EMPNO = 7369 AND ENAME = 'SMITH'



방법 4. Oracle Trace 사용하기


DBA 권한 또는 적절한 권한이 있다면 Oracle Trace를 통해 실제 바인드 값을 확인할 수 있다.



ALTER SESSION SET SQL_TRACE = TRUE;

또는 다음과 같이 Trace를 활성화할 수 있다.



CallableStatement cs =
conn.prepareCall(
"BEGIN DBMS_MONITOR.SESSION_TRACE_ENABLE(waits=>TRUE, binds=>TRUE); END;"
);

cs.execute();

Trace 파일에서는 다음과 같이 SQL과 바인드 값을 확인할 수 있다.



SELECT * FROM EMP WHERE EMPNO = :1

Bind#1
value=7369



p6spy / log4jdbc를 사용할 수 있다면?


외부 라이브러리 사용이 가능한 환경이라면 p6spy 또는 log4jdbc를 사용하는 것이 가장 편리하다.


다음과 같이 실제 SQL이 로그에 출력된다.



SELECT *
FROM EMP
WHERE EMPNO = 7369
AND ENAME = 'SMITH'

하지만 레거시 환경, 폐쇄망 환경, 라이브러리 추가가 불가능한 환경에서는 직접 디버그 SQL을 생성하는 방식을 가장 많이 사용한다.




정리



  • Oracle JDBC는 바인드 값이 포함된 최종 SQL을 직접 제공하지 않는다.

  • PreparedStatement.toString()으로는 대부분 확인할 수 없다.

  • 외부 라이브러리 사용 가능 시 p6spy 또는 log4jdbc를 사용하는 것이 가장 편리하다.

  • 외부 라이브러리 사용이 불가능하면 디버그용 SQL 생성 유틸을 만들어 사용하는 것이 현실적인 방법이다.

  • 정확한 실행 정보를 확인하려면 Oracle Trace를 활용할 수 있다.





댓글 없음:

댓글 쓰기

오늘의 이야기

Oracle JDBC PreparedStatement의 실제 실행 SQL 확인 방법 jdbc sql log   Oracle JDBC를 사용하다 보면 PreparedStatement 에 파라미터를 ...