第2章 JDBC データソースの設定

手順

1. Quarkus プロジェクトディレクトリーに移動します。

2. quarkus-agroal エクステンションをプロジェクトに追加します。

   ./mvnw quarkus:add-extension -Dextensions="agroal"

   Copy to Clipboard Toggle word wrap

3. 適切なタイプのリレーショナルデータベースドライバーの Quarkus エクステンションをアプリケーションに追加します。

   ./mvnw quarkus:add-extension -Dextensions="<extension>"

   Copy to Clipboard Toggle word wrap

   たとえば、PostgreSQL データベースドライバーエクステンションを追加するには、以下を使用します。

   ./mvnw quarkus:add-extension -Dextensions="jdbc-postgresql"

   Copy to Clipboard Toggle word wrap

手順

1. Quarkus プロジェクトディレクトリーに移動します。
2. src/main/resources/application.properties ファイルを開きます。

3. データソースの JDBC URL に一致するように、quarkus.datasource.jdbc.url プロパティーの値を設定します。

   quarkus.datasource.jdbc.url=<JDBC_URL>

   Copy to Clipboard Toggle word wrap

   たとえば、PostgreSQL データソースの JDBC URL を設定するには、以下を使用します。

   quarkus.datasource.jdbc.url=jdbc:postgresql://localhost:5432/hibernate_orm_test

   Copy to Clipboard Toggle word wrap

手順

1. Quarkus プロジェクトディレクトリーに移動します。
2. src/main/resources/application.properties ファイルを開きます。

3. quarkus.datasource.jdbc プロパティーを false に設定して JDBC データソースを無効にします。

   quarkus.datasource.jdbc=false

   Copy to Clipboard Toggle word wrap

手順

1. Quarkus プロジェクトディレクトリーに移動します。
2. src/main/resources/application.properties ファイルを開きます。

3. db-kind プロパティーの値を other に設定します。

   quarkus.datasource.db-kind=other

   Copy to Clipboard Toggle word wrap

4. 使用するドライバーエクステンションのタイプに一致するように、quarkus.datasource.jdbc.driver プロパティーの値を設定します。

   quarkus.datasource.jdbc.driver=<driver>

   Copy to Clipboard Toggle word wrap

5. データソースの JDBC URL に一致するように、quarkus.datasource.jdbc.url プロパティーの値を設定します。

   quarkus.datasource.jdbc.url=<JDBC_URL>

   Copy to Clipboard Toggle word wrap

   たとえば、Quarkus は OpenTracing ドライバーのビルトインドライバーエクステンションを提供しません。opentracing-jdbc アーティファクトを pom.xml ファイルに追加し、application.properties ファイルに以下のプロパティーを設定して OpenTracing ドライバーを設定します。

   quarkus.datasource.db-kind=postgresql
   quarkus.datasource.jdbc.url=jdbc:tracing:postgresql://localhost:5432/mydatabase
   quarkus.datasource.jdbc.driver=io.opentracing.contrib.jdbc.TracingDriver
   quarkus.hibernate-orm.dialect=org.hibernate.dialect.PostgreSQLDialect

   Copy to Clipboard Toggle word wrap

手順

1. Quarkus プロジェクトディレクトリーに移動します。

2. src/main/resources/application.properties ファイルで、各データソースに以下のプロパティーを設定します。

   • データソースの名前(たとえば、データソースの名前に users を選択した場合、データソースの完全修飾参照は quarkus.datasource.users になります)
   • データソースのタイプに一致する db-kind プロパティー
   • データソースのユーザー名を指定する quarkus.datasource.username
   • データソースの JDBC 接続 URL を指定する quarkus.datasource.jdbc.url
   • データソースの接続プールで保持される接続の最小数を指定する quarkus.datasource.jdbc.min-size プロパティー

   • データソースの接続プールで保持される接続の最大数を指定する quarkus.datasource.jdbc.max-size プロパティー

     以下の例は、3 つの JDBC データソースの完全な設定を示しています。

     quarkus.datasource.db-kind=h2
     quarkus.datasource.username=username-default
     quarkus.datasource.jdbc.url=jdbc:h2:tcp://localhost/mem:default
     quarkus.datasource.jdbc.min-size=3
     quarkus.datasource.jdbc.max-size=13
     
     quarkus.datasource.users.db-kind=h2
     quarkus.datasource.users.username=username1
     quarkus.datasource.users.jdbc.url=jdbc:h2:tcp://localhost/mem:users
     quarkus.datasource.users.jdbc.min-size=1
     quarkus.datasource.users.jdbc.max-size=11
     
     quarkus.datasource.inventory.db-kind=h2
     quarkus.datasource.inventory.username=username2
     quarkus.datasource.inventory.jdbc.url=jdbc:h2:tcp://localhost/mem:inventory
     quarkus.datasource.inventory.jdbc.min-size=2
     quarkus.datasource.inventory.jdbc.max-size=12

     Copy to Clipboard Toggle word wrap

3. @Inject アノテーションを各クラスプロパティーに追加して、複数のデータソースを注入します。アプリケーションに複数のデータソースを設定する場合は、データソースの名前を持つ io.quarkus.agroal.DataSource 修飾子を値として各 DataSource クラスに追加してください。

   import javax.inject.Inject;
   import io.agroal.api.AgroalDataSource;
   import io.quarkus.agroal.DataSource;
   
   @Inject
   AgroalDataSource defaultDataSource;
   
   @Inject
   @DataSource("users")
   AgroalDataSource usersDataSource;
   
   @Inject
   @DataSource("inventory")
   AgroalDataSource inventoryDataSource;

   Copy to Clipboard Toggle word wrap