第2章 JDBC データソースの設定
JDBC は、Java ベースのアプリケーションで最も一般的に使用されているデータベース接続 API です。JDBC データソースドライバーを使用して、アプリケーションをリレーショナルデータベースに接続できます。
JDBC データソースを設定するには、以下を行う必要があります。
-
quarkus-agroal
エクステンションのアプリケーションへの追加 -
アプリケーションへの
db-kind
エクステンションの追加 - アプリケーションがデータソースにアクセスするために使用する JDBC URL の指定
以下の例は、postgresql
データソースをアプリケーションに接続し、データベースのアクセス認証情報と JDBC URL を指定する方法を示しています。JDBC URL の指定方法に関する詳細は、データソースの JDBC URL の設定 を参照してください。
JDBC データソースの設定例
2.1. JDBC データソースの Quarkus エクステンションのインストール リンクのコピーリンクがクリップボードにコピーされました!
JDBC データソースを設定するには、quarkus-agroal
エクステンションおよび Quarkus JDBC データベースドライバーエクステンションをインストールする必要があります。追加する JDBC データベースドライバーは、使用する JDBC データベースのタイプと一致する必要があります。
以下の手順では、JDBC データソースの Quarkus エクステンションをインストールする方法を説明します。
前提条件
- Quarkus Maven プロジェクトが存在する。
-
データソースの
db-kind
プロパティーを設定している。
手順
- Quarkus プロジェクトディレクトリーに移動します。
quarkus-agroal
エクステンションをプロジェクトに追加します。./mvnw quarkus:add-extension -Dextensions="agroal"
./mvnw quarkus:add-extension -Dextensions="agroal"
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 適切なタイプのリレーショナルデータベースドライバーの Quarkus エクステンションをアプリケーションに追加します。
./mvnw quarkus:add-extension -Dextensions="<extension>"
./mvnw quarkus:add-extension -Dextensions="<extension>"
Copy to Clipboard Copied! Toggle word wrap Toggle overflow たとえば、PostgreSQL データベースドライバーエクステンションを追加するには、以下を使用します。
./mvnw quarkus:add-extension -Dextensions="jdbc-postgresql"
./mvnw quarkus:add-extension -Dextensions="jdbc-postgresql"
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Hibernate ORM を使用している場合は、Agroal エクステンションの依存関係を明示的に追加する必要はありません。Agroal は、Hibernate ORM エクステンションの推移的な依存関係です。Hibernate ORM で JDBC データソースドライバーを使用する必要があります。