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


JDBC は、Java ベースのアプリケーションで最も一般的に使用されているデータベース接続 API です。JDBC データソースドライバーを使用して、アプリケーションをリレーショナルデータベースに接続できます。

JDBC データソースを設定するには、以下を行う必要があります。

  • quarkus-agroal エクステンションのアプリケーションへの追加
  • アプリケーションへの db-kind エクステンションの追加
  • アプリケーションがデータソースにアクセスするために使用する JDBC URL の指定

以下の例は、postgresql データソースをアプリケーションに接続し、データベースのアクセス認証情報と JDBC URL を指定する方法を示しています。JDBC URL の指定方法に関する詳細は、データソースの JDBC URL の設定 を参照してください。

JDBC データソースの設定例

quarkus.datasource.db-kind=postgresql
quarkus.datasource.username=<your_username>
quarkus.datasource.password=<your_password>

quarkus.datasource.jdbc.url=jdbc:postgresql://localhost:5432/hibernate_orm_test
quarkus.datasource.jdbc.max-size=16
Copy to Clipboard Toggle word wrap

2.1. JDBC データソースの Quarkus エクステンションのインストール

JDBC データソースを設定するには、quarkus-agroal エクステンションおよび Quarkus JDBC データベースドライバーエクステンションをインストールする必要があります。追加する JDBC データベースドライバーは、使用する JDBC データベースのタイプと一致する必要があります。

以下の手順では、JDBC データソースの Quarkus エクステンションをインストールする方法を説明します。

前提条件

  • Quarkus Maven プロジェクトが存在する。
  • データソースの db-kind プロパティーを設定している。

手順

  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
注記

Hibernate ORM を使用している場合は、Agroal エクステンションの依存関係を明示的に追加する必要はありません。Agroal は、Hibernate ORM エクステンションの推移的な依存関係です。Hibernate ORM で JDBC データソースドライバーを使用する必要があります。

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat