Java Webアプリケーションをローカル環境のSAP HANAに接続する設定方法

概要

ローカル環境で動作しているJava WebアプリケーションからSAP HANAデータベースに接続するには、ローカルTomcatサーバーの接続設定ファイルを編集し、HANAデータベースを参照するように変更する必要があります。

connection.propertiesファイルの編集手順

まず、以下のパスにあるconnection.propertiesファイルを開きます。このファイルは、EclipseやSAP Development Toolsを使用している場合、Serversビューから該当サーバーを選択することでもアクセスできます。

Server > Java Web Tomcat 8 Server-config/config_master/connection_data/connection.properties

このファイルを編集して、接続先としてHANAデータベースを指定します。

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: HANAへの接続に使用するJDBCドライバクラス名です。SAP HANAの標準ドライバであるcom.sap.db.jdbc.Driver（ngdbc.jar）を指定します。
• javax.persistence.jdbc.url: 接続URLです。<host>にはHANAサーバーのホスト名またはIPアドレス、<port>にはインスタンス番号に対応するSQLポート番号（例：30015）を指定します。reconnect=trueにより接続断時の自動再接続が有効になり、autocommit=falseによりトランザクションを明示的に制御できます。
• javax.persistence.jdbc.user / javax.persistence.jdbc.password: データベースへ接続するためのユーザー名とパスワードです。セキュリティのため、本番環境では適切な権限管理を行ってください。
• eclipselink.target-database: JPAプロバイダとしてEclipseLinkを使用する場合に、ターゲットデータベースをHANAとして指定します。これによりHANA固有のSQL方言が適用されます。

注意点

設定変更後は、Tomcatサーバーを再起動して変更を反映させてください。また、接続に失敗する場合は、ホスト・ポートの指定ミス、ファイアウォールによる通信ブロック、ngdbc.jarがクラスパスに含まれていないことなどが主な原因として考えられます。