12.3. データソースの作成
データソースは管理コンソールまたは管理 CLI を使用して作成できます。
JBoss EAP 7 では、enabled
属性などのデータソース属性値を式で使用することができます。設定で式を使用する場合の詳細は、プロパティーの置換 の項を参照してください。
12.3.1. 非 XA データソースの作成
管理 CLI または管理コンソールを使用して、非 XA データソース作成できます。
管理コンソールを使用した非 XA データソースの定義
- Configuration → Subsystems → Datasources & Drivers → Datasources と選択します。
- 追加 (+) ボタンをクリックし、Add Datasource を選択します。
- データソースタイプを選択できる Add Datasource ウィザードが表示されたら、Next をクリックします。これにより、データベースのテンプレートが作成されます。ウィザードの以下のページには、選択したデータソースに固有する値が自動的に入力されています。これにより、データソースの作成プロセスが簡単になります。
- データソースの作成を終了する前に、Test Connection ページで接続をテストできます。
- 詳細を確認し、Finish をクリックしてデータソースを作成します。
管理 CLI を使用した非 XA データソースの定義
data-source add
管理 CLI コマンドを使用すると、非 XA データソースを定義できます。
- JDBC ドライバーをコアモジュールとしてインストールおよび登録していない場合は、コアモジュールとしての JDBC ドライバーのインストール を参照してインストールと登録を行ってください。
適切な引数の値を指定し、
data-source add
コマンドを使用してデータソースを定義します。data-source add --name=DATASOURCE_NAME --jndi-name=JNDI_NAME --driver-name=DRIVER_NAME --connection-url=CONNECTION_URL
注記管理対象ドメインでは、
--profile=PROFILE_NAME
引数を指定する必要があります。これらのパラメーター値については、以下の データソースパラメーター の項を参照してください。
詳細な例は、サポート対象データベースの データソース設定例 を参照してください。
データソースのパラメーター
- jndi-name
-
データソースの JNDI 名は、
java:/
またはjava:jboss/
で始まる必要があります。たとえば、java:jboss/datasources/ExampleDS
になります。 - driver-name
ドライバー名の値は、JDBC ドライバーがコアモジュールまたは JAR デプロイメントとしてインストールされたかによって異なります。
- コアモジュールでは、ドライバー名の値は登録時に指定した JDBC ドライバーの名前になります。
JAR デプロイメントでは、
/META-INF/services/java.sql.Driver
ファイルに 1 つのクラスのみがある場合はドライバー名が JAR の名前になります。複数のクラスがリストされている場合は値がJAR_NAME
+ "_" +DRIVER_CLASS_NAME
+ "_" +MAJOR_VERSION
+ "_" +MINOR_VERSION
(例:mysql-connector-java-5.1.36-bin.jar_com.mysql.cj.jdbc.Driver_5_1
) になります。また、JDBC JAR がデプロイされると JBoss EAP サーバーログにドライバー名がリストされます。
WFLYJCA0018: Started Driver service with driver-name = mysql-connector-java-5.1.36-bin.jar_com.mysql.cj.jdbc.Driver_5_1
- connection-url
- サポートされるデータベースの接続 URL 形式の詳細は、データソース接続 URL のリストを参照してください。
利用できるデータソース属性の完全リストは、データソース属性 を参照してください。