SAP 플랫폼에서 Java 웹 애플리케이션을 개발할 때 로컬 Tomcat 서버를 SAP HANA 데이터베이스에 연결하려면, 데이터베이스 접속 정보가 담긴 connection.properties 파일을 수정해야 합니다. 이 글에서는 해당 파일의 위치와 반드시 설정해야 하는 핵심 파라미터를 단계별로 살펴봅니다.
1. connection.properties 파일 찾기
로컬 Tomcat 서버의 설정 경로에서 파일을 열어야 합니다. 기본 경로는 다음과 같습니다.
Server > Java Web Tomcat 8 Server-config / config_master / connection_data
이 디렉터리 안의 connection.properties 파일을 편집기로 열면 데이터베이스 접속 관련 속성을 확인하고 수정할 수 있습니다.
2. HANA 데이터베이스 연결을 위한 필수 설정
HANA 데이터베이스에 연결하려면 아래와 같은 파라미터를 일반적으로 설정합니다.
javax.persistence.jdbc.driver=com.sap.db.jdbc.Driver javax.persistence.jdbc.url=jdbc:sap://<host>:<port>/?reconnect=true&autocommit=false javax.persistence.jdbc.user=db-user javax.persistence.jdbc.password=db-pass eclipselink.target-database=HANA
주요 파라미터 설명
- javax.persistence.jdbc.driver : SAP HANA 전용 JDBC 드라이버 클래스인
com.sap.db.jdbc.Driver를 지정합니다. - javax.persistence.jdbc.url :
jdbc:sap://형식의 URL에 실제 호스트와 포트 번호를 입력합니다.reconnect=true옵션은 연결이 끊겼을 때 자동으로 재접속을 시도하며,autocommit=false는 트랜잭션을 명시적으로 제어할 수 있도록 해줍니다. - javax.persistence.jdbc.user / password : HANA 데이터베이스에 접속할 사용자 계정과 비밀번호입니다.
- eclipselink.target-database : JPA 구현체인 EclipseLink가 대상 데이터베이스를 HANA로 인식하도록 지정하는 값입니다.
3. 설정 적용 및 연결 확인
파일을 저장한 뒤 Tomcat 서버를 재시작하면 애플리케이션이 HANA 데이터베이스에 정상적으로 연결됩니다. 만약 연결 오류가 발생한다면 다음 사항을 점검해 보세요.
- 호스트 주소와 포트 번호가 올바르게 입력되었는지 확인
- 사용자 계정에 해당 데이터베이스 스키마에 대한 접근 권한이 있는지 확인
- HANA JDBC 드라이버(
ngdbc.jar)가 클래스패스에 포함되어 있는지 확인
이 과정을 통해 SAP 플랫폼 환경에서도 EclipseLink(JPA) 기반의 Java 웹 애플리케이션이 HANA 데이터베이스와 안정적으로 통신할 수 있습니다.