1.4. 参考資料
1.4.1. 共通データソース設定リファレンス
ビルド時に固定された設定プロパティー: その他の設定プロパティーはすべて実行時にオーバーライド可能
型 | デフォルト | |
smallrye-health エクステンションが存在する場合にヘルスチェックを公開するかどうか。 これはグローバル設定であり、データソース固有の設定ではありません。
環境変数: | boolean |
|
メトリクスエクステンションが存在する場合にデータソースメトリクスを公開するかどうか。 これはグローバル設定であり、データソース固有の設定ではありません。 注記 これは、データソースのメトリクス収集を有効にするために JDBC データソースレベルで設定する必要がある "jdbc.enable-metrics" プロパティーとは異なります。
環境変数: | boolean |
|
型 | デフォルト | |
接続先のデータベースの種類 (h2、postgresql など)。
環境変数: | string | |
接続先のデータベースのバージョン (例: '10.0'). 注意
ここで設定するバージョン番号は、データベースの JDBC ドライバーの 原則として、ここでは可能な限り高いバージョンを設定する必要がありますが、アプリケーションの接続先となるデータベースのバージョン以下でなければなりません。 バージョンが高いほどパフォーマンスが向上し、より多くの機能を使用できます (たとえば、Hibernate ORM はより効率的な SQL を生成し、回避策を回避し、より多くのデータベース機能を活用できます)。しかし、接続先のデータベースよりバージョンが高いと、ランタイム例外が発生する (たとえば、Hibernate ORM がデータベースが拒否する無効な SQL を生成する) 可能性があります。 一部のエクステンション (Hibernate ORM エクステンションなど) は、起動時にこのバージョンを実際のデータベースバージョンと照合しようとします。そのため、実際のバージョンが低いために起動に失敗するか、データベースにアクセスできずに警告が表示されます。 このプロパティーのデフォルトは各エクステンションにより異なり、Hibernate ORM エクステンションのデフォルトは最も古いサポート対象のバージョンです。
環境変数: | string | |
この Dev Service を dev モードまたはテストでアプリケーションで始まるかどうか。 接続設定 (JDBC URL やリアクティブクライアント URL など) が明示的に設定されていない限り、Dev Service はデフォルトで有効になります。
環境変数: | boolean | |
コンテナーベースの Dev Service プロバイダーのコンテナーイメージ名。 プロバイダーが H2 や Derby などのコンテナーベースのデータベースでない場合、これは効果がありません。
環境変数: | string | |
コンテナーに渡される環境変数。
環境変数: |
| |
追加のコンテナー設定に渡される汎用プロパティー。 ここで定義されるプロパティーはデータベース固有であり、各データベースの Dev Service 実装で解釈されます。
環境変数: |
| |
データベース接続 URL に追加される汎用プロパティー。
環境変数: |
| |
開発サービスがリッスンするオプションの固定ポート。 定義されていない場合、ポートはランダムに選択されます。
環境変数: | int | |
コンテナーベースの Dev Service プロバイダーに使用するコンテナー起動コマンド。 プロバイダーが H2 や Derby などのコンテナーベースのデータベースでない場合、これは効果がありません。
環境変数: | string | |
この Dev Service がオーバーライドをサポートする場合に使用するデータベース名。
環境変数: | string | |
この Dev Service がオーバーライドをサポートする場合に使用するユーザー名。
環境変数: | string | |
この Dev Service がオーバーライドをサポートする場合に使用するパスワード。
環境変数: | string | |
クラスパスからロードされ、Dev Service データベースに適用される SQL スクリプトへのパス。 プロバイダーが H2 や Derby などのコンテナーベースのデータベースでない場合、これは効果がありません。
環境変数: | string | |
コンテナーにマッピングされるボリューム。 マップキーはホストの場所に対応します。マップ値はコンテナーの場所です。ホストの場所が "classpath:" で始まる場合、マッピングは読み取り専用権限でクラスパスからリソースをロードします。 ファイルシステムの場所を使用する場合、ボリュームは読み取り/書き込み権限で生成されるため、ファイルシステムでデータの損失や変更が発生する可能性があります。 プロバイダーが H2 や Derby などのコンテナーベースのデータベースでない場合、これは効果がありません。
環境変数: |
| |
dev モードセッションまたはテストスイートの実行後 に Dev Service コンテナーを実行したままにして、次の dev モードセッションまたはテストスイートの実行で再利用するかどうか。 dev モードセッションまたはテストスイート実行中、Quarkus は、設定 (ユーザー名、パスワード、環境、ポートバインディングなど) が変更されていない限り、常に Dev Services を再利用します。この機能は、Quarkus が実行していないときに コンテナーを実行したままにして、実行間で再利用できるようにすることを目的としています。 警告
この機能は、
この設定プロパティーはデフォルトで
環境変数: | boolean |
|
データソースの一般的なヘルスチェックが有効になっている場合に、この特定のデータソースをヘルスチェックから除外するかどうか。 デフォルトでは、ヘルスチェックには設定されているすべてのデータソースが含まれます (有効になっている場合)。
環境変数: | boolean |
|
実行時にこのデータソースをアクティブにするかどうか。 ドキュメントのこのセクション を参照してください。 データソースがアクティブでない場合、アプリケーションでは起動されず、対応するデータソース CDI Bean へのアクセスは失敗します。つまり、特にこのデータソースのコンシューマー (Hibernate ORM 永続性ユニットなど) は、非アクティブでない限り起動に失敗します。
環境変数: | boolean |
|
データソースのユーザー名
環境変数: | string | |
データソースのパスワード
環境変数: | string | |
認証情報プロバイダー名
環境変数: | string | |
認証情報プロバイダーの Bean 名。
これは、
Vault の場合、認証情報プロバイダー Bean 名は
環境変数: | string |
1.4.2. JDBC 設定リファレンス
ビルド時に固定された設定プロパティー: その他の設定プロパティーはすべて実行時にオーバーライド可能
型 | デフォルト | |
データソースの URL
環境変数: | string | |
プールの初期サイズ。通常、初期サイズは少なくとも最小サイズに一致するように設定する必要がありますが、強制ではありません。これは、起動時に接続の遅延初期化を優先するアーキテクチャーを可能にし、一方で起動後に最小プールサイズを維持できるようにするためです。
環境変数: | int | |
データソースプールの最小サイズ
環境変数: | int |
|
データソースプールの最大サイズ
環境変数: | int |
|
バックグラウンドでアイドル状態の接続を検証する間隔。
バックグラウンド検証を無効にするには、
環境変数: |
| |
指定された間隔よりも長くアイドル状態になっている接続に対し、フォアグラウンド検証を実行します。
環境変数: | ||
新しい接続の取得をキャンセルするまでのタイムアウト
環境変数: |
| |
接続リークをチェックする間隔。
環境変数: |
| |
アイドル状態の接続の削除を試行する間隔。
環境変数: |
| |
接続の最大存続期間。
環境変数: |
| |
トランザクション分離レベル。
環境変数: |
| |
リークされた接続に関する追加のトラブルシューティング情報を収集して表示します。
環境変数: | boolean |
|
プールに返すときに接続をフラッシュできるようにします。デフォルトでは有効になっていません。
環境変数: | boolean |
|
有効にすると、開いているすべてのステートメントがアプリケーションにより閉じられないまま接続がプールに返された場合に、Agroal は警告を生成できるようになります。これは、オープン接続の追跡とは関係ありません。パフォーマンスを最大化するために無効にしますが、リークが発生していないという高い信頼性がある場合に限ります。
環境変数: | boolean |
|
接続の初回使用時に実行されるクエリー。
環境変数: | string | |
接続を検証するために実行されるクエリー。
環境変数: | string | |
接続の再利用を防ぐためにプーリングを無効にします。外部プールが接続のライフサイクルを管理する場合に使用します。
環境変数: | boolean |
|
接続の取得時にアクティブなトランザクションを要求します。実稼働環境で推奨されます。警告: 一部のエクステンションは、スキーマ更新やスキーマ検証などのトランザクションを保持せずに接続を取得します。その場合、これを STRICT に設定すると失敗する可能性があります。
環境変数: |
| |
JDBC トレーシングを有効にします。
環境変数: | boolean |
|
アクティブなスパンを持つコールのみをトレースします
環境変数: | boolean |
|
特定のクエリーがトレースされないようにします。
環境変数: | string |
|
OpenTelemetry JDBC インストルメンテーションを有効にします。
環境変数: | boolean |
|
新しい接続の作成時に JDBC ドライバーに渡される、その他の未指定のプロパティー。
環境変数: |
| |
型 | デフォルト | |
このデータソースの JDBC データソースを作成する場合。
環境変数: | boolean |
|
データソースドライバーのクラス名
環境変数: | string | |
通常の JDBC トランザクション、XA を使用するか、すべてのトランザクション機能を無効にするか。
XA を有効にする場合は、
環境変数: |
|
|
データソースメトリクスの収集を有効にします。指定しない場合、メトリクスエクステンションがアクティブであれば、デフォルトでメトリクス収集が有効になります。
環境変数: | boolean | |
JDBC トレーシングを有効にします。デフォルトでは無効になっています。
環境変数: | boolean |
|
OpenTelemetry JDBC インストルメンテーションを有効にします。
環境変数: | boolean |
|
型 | デフォルト | |
データソースの URL
環境変数: | string | |
プールの初期サイズ。通常、初期サイズは少なくとも最小サイズに一致するように設定する必要がありますが、強制ではありません。これは、起動時に接続の遅延初期化を優先するアーキテクチャーを可能にし、一方で起動後に最小プールサイズを維持できるようにするためです。
環境変数: | int | |
データソースプールの最小サイズ
環境変数: | int |
|
データソースプールの最大サイズ
環境変数: | int |
|
バックグラウンドでアイドル状態の接続を検証する間隔。
バックグラウンド検証を無効にするには、
環境変数: |
| |
指定された間隔よりも長くアイドル状態になっている接続に対し、フォアグラウンド検証を実行します。
環境変数: | ||
新しい接続の取得をキャンセルするまでのタイムアウト
環境変数: |
| |
接続リークをチェックする間隔。
環境変数: |
| |
アイドル状態の接続の削除を試行する間隔。
環境変数: |
| |
接続の最大存続期間。
環境変数: |
| |
トランザクション分離レベル。
環境変数: |
| |
リークされた接続に関する追加のトラブルシューティング情報を収集して表示します。
環境変数: | boolean |
|
プールに返すときに接続をフラッシュできるようにします。デフォルトでは有効になっていません。
環境変数: | boolean |
|
有効にすると、開いているすべてのステートメントがアプリケーションにより閉じられないまま接続がプールに返された場合に、Agroal は警告を生成できるようになります。これは、オープン接続の追跡とは関係ありません。パフォーマンスを最大化するために無効にしますが、リークが発生していないという高い信頼性がある場合に限ります。
環境変数: | boolean |
|
接続の初回使用時に実行されるクエリー。
環境変数: | string | |
接続を検証するために実行されるクエリー。
環境変数: | string | |
接続の再利用を防ぐためにプーリングを無効にします。外部プールが接続のライフサイクルを管理する場合に使用します。
環境変数: | boolean |
|
接続の取得時にアクティブなトランザクションを要求します。実稼働環境で推奨されます。警告: 一部のエクステンションは、スキーマ更新やスキーマ検証などのトランザクションを保持せずに接続を取得します。その場合、これを STRICT に設定すると失敗する可能性があります。
環境変数: |
| |
新しい接続の作成時に JDBC ドライバーに渡される、その他の未指定のプロパティー。
環境変数: |
| |
JDBC トレーシングを有効にします。
環境変数: | boolean |
|
アクティブなスパンを持つコールのみをトレースします
環境変数: | boolean |
|
特定のクエリーがトレースされないようにします。
環境変数: | string |
|
OpenTelemetry JDBC インストルメンテーションを有効にします。
環境変数: | boolean |
|
duration の値を書き込むには、標準の java.time.Duration
フォーマットを使用します。詳細は、Duration#parse() Java API ドキュメント を参照してください。
数字で始まる簡略化されたフォーマットも使用できます。
- 値が数値のみの場合は、秒単位の時間を表します。
-
数字の後に
ms
が続く値は、ミリ秒単位の時間を表します。
その他の場合は、解析のために簡略化されたフォーマットが java.time.Duration
フォーマットに変換されます。
-
数字の後に
h
、m
、またはs
が続く値には、接頭辞PT
が付きます。 -
数字の後に
d
が続く値は、接頭辞P
が付きます。
1.4.3. JDBC URL リファレンス
サポートされている各データベースには、異なる JDBC URL 設定オプションが含まれています。次のセクションでは、各データベース URL の概要と公式ドキュメントへのリンクを示します。
1.4.3.1. DB2
jdbc:db2://<serverName>[:<portNumber>]/<databaseName>[:<key1>=<value>;[<key2>=<value2>;]]
- 例
-
jdbc:db2://localhost:50000/MYDB:user=dbadm;password=dbadm;
URL 構文とその他のサポートされるオプションの詳細は、公式ドキュメント を参照してください。
1.4.3.2. Derby
jdbc:derby:[//serverName[:portNumber]/][memory:]databaseName[;property=value[;property=value]]
- 例
-
jdbc:derby://localhost:1527/myDB
,jdbc:derby:memory:myDB;create=true
Derby は、ファイルに基づきサーバーとして実行することも、完全にインメモリーで実行することもできる組み込みデータベースです。上記のオプションはすべて利用可能です。
詳細は、公式ドキュメント を参照してください。
1.4.3.3. H2
jdbc:h2:{ {.|mem:}[name] | [file:]fileName | {tcp|ssl}:[//]server[:port][,server2[:port]]/name }[;key=value…]
- 例
-
jdbc:h2:tcp://localhost/~/test
,jdbc:h2:mem:myDB
H2 は、組み込みモードまたはサーバーモードで実行できるデータベースです。ファイルストレージを使用することも、完全にインメモリーで実行することも可能です。上記のオプションはすべて利用可能です。
詳細は、公式ドキュメント を参照してください。
1.4.3.4. MariaDB
jdbc:mariadb:[replication:|failover:|sequential:|aurora:]//<hostDescription>[,<hostDescription>…]/[database][?<key1>=<value1>[&<key2>=<value2>]]
hostDescription:: <host>[:<portnumber>] or address=(host=<host>)[(port=<portnumber>)][(type=(master|slave))]
- 例
-
jdbc:mariadb://localhost:3306/test
詳細は、公式ドキュメント を参照してください。
1.4.3.5. Microsoft SQL サーバー
jdbc:sqlserver://[serverName[\instanceName][:portNumber]][;property=value[;property=value]]
- 例
-
jdbc:sqlserver://localhost:1433;databaseName=AdventureWorks
Microsoft SQL Server JDBC ドライバーは、基本的に他のドライバーと同じように動作します。
詳細は、公式ドキュメント を参照してください。
1.4.3.6. MySQL
jdbc:mysql:[replication:|failover:|sequential:|aurora:]//<hostDescription>[,<hostDescription>…]/[database][?<key1>=<value1>[&<key2>=<value2>]]
hostDescription:: <host>[:<portnumber>] or address=(host=<host>)[(port=<portnumber>)][(type=(master|slave))]
- 例
-
jdbc:mysql://localhost:3306/test
詳細は、公式ドキュメント を参照してください。
1.4.3.6.1. MySQL の制限事項
Quarkus アプリケーションをネイティブイメージにコンパイルする場合、JMX および Oracle Cloud Infrastructure (OCI) のインテグレーションに対する MySQL サポートは、GraalVM ネイティブイメージと互換性がないため無効になります。
- ネイティブモードで実行する場合に JMX サポートがないのは当然の結果であり、解決される見込みはありません。
- OCI とのインテグレーションはサポートされていません。
1.4.3.7. Oracle
jdbc:oracle:driver_type:@database_specifier
- 例
-
jdbc:oracle:thin:@localhost:1521/ORCL_SVC
詳細は、公式ドキュメント を参照してください。
1.4.3.8. PostgreSQL
jdbc:postgresql:[//][host][:port][/database][?key=value…]
- 例
-
jdbc:postgresql://localhost/test
各部分のデフォルトは次のとおりです。
host
- localhost
port
- 5432
database
- ユーザー名と同じ名前
追加パラメーターの詳細は、公式ドキュメント を参照してください。
1.4.4. Quarkus エクステンションとデータベースドライバーのリファレンス
次の表は、ビルトイン db-kind
値、対応する Quarkus エクステンション、およびそれらのエクステンションで使用される JDBC ドライバーを示しています。
ビルトインデータソースの種類のいずれかを使用する場合、JDBC ドライバーとリアクティブドライバーはこの表の値と一致するように自動的に解決されます。
データベースの種類 | Quarkus エクステンション | ドライバー |
---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
データベースの種類 | Quarkus エクステンション | ドライバー |
---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
ほとんどの場合、この自動解決を適用できるため、ドライバーの設定は必要ありません。
1.4.5. リアクティブデータソース設定リファレンス
ビルド時に固定された設定プロパティー: その他の設定プロパティーはすべて実行時にオーバーライド可能
型 | デフォルト | |
このデータソースに対してリアクティブデータソースを作成する場合。
環境変数: | boolean |
|
準備されたステートメントをクライアント側でキャッシュするかどうか。
環境変数: | boolean |
|
データソースの URL。 複数の値が設定されている場合、このデータソースは 1 つのサーバーではなくサーバーリストを含むプールを作成します。プールは、接続確立時のサーバー選択にラウンドロビン負荷分散を使用します。一部のドライバーは、このコンテキストで複数の値をサポートできない場合があることに注意してください。
環境変数: | 文字列のリスト | |
データソースプールの最大サイズ。
環境変数: | int |
|
新しい接続オブジェクトが作成されると、プールはそれにイベントループを割り当てます。
環境変数: | int | |
すべてのサーバー証明書を信頼するかどうか。
環境変数: | boolean |
|
デフォルトで、PEM Trust 設定は無効になっています。
環境変数: | boolean |
|
信頼証明書ファイルのコンマ区切りリスト (Pem フォーマット)。
環境変数: | 文字列のリスト | |
デフォルトで、JKS 設定は無効になっています。
環境変数: | boolean |
|
キーファイルのパス (JKS フォーマット)。
環境変数: | string | |
キーファイルのパスワード。
環境変数: | string | |
デフォルトで、PFX 設定は無効になっています。
環境変数: | boolean |
|
キーファイルへのパス (PFX フォーマット)。
環境変数: | string | |
キーのパスワード。
環境変数: | string | |
デフォルトで、PEM キー/証明書設定は無効になっています。
環境変数: | boolean |
|
キーファイルへのパスのコンマ区切りリスト (Pem フォーマット)。
環境変数: | 文字列のリスト | |
証明書ファイルへのパスのコンマ区切りリスト (Pem フォーマット)。
環境変数: | 文字列のリスト | |
デフォルトで、JKS 設定は無効になっています。
環境変数: | boolean |
|
キーファイルのパス (JKS フォーマット)。
環境変数: | string | |
キーファイルのパスワード。
環境変数: | string | |
デフォルトで、PFX 設定は無効になっています。
環境変数: | boolean |
|
キーファイルへのパス (PFX フォーマット)。
環境変数: | string | |
キーのパスワード。
環境変数: | string | |
プールされた接続が初回試行時に確立できなかった場合の再接続の試行回数。
環境変数: | int |
|
プールされた接続が初回試行時に確立できなかった場合の再接続の試行間隔。
環境変数: |
| |
サーバーのアイデンティティーをチェックする必要がある場合に使用するホスト名検証アルゴリズム。
環境変数: | string |
|
プール内で未使用の接続が閉じられるまでの、未使用状態の最大継続時間。
環境変数: |
| |
接続がプール内に留まる最大時間。この時間が経過すると接続は戻ったときに閉じられ、必要に応じて置き換えられます。
環境変数: |
| |
データソース間でプールを共有する場合は true に設定します。複数の共有プールを名前で区別できます。特定の名前を設定しない場合、
環境変数: | boolean |
|
プール名を設定します。この名前は、プールがデータソース間で共有される場合に使用され、それ以外では無視されます。
環境変数: | string | |
新しい接続の開始時に、リアクティブ SQL クライアントを介してデータベースに直接渡されるその他の未指定のプロパティー。
環境変数: |
| |
型 | デフォルト | |
このデータソースに対してリアクティブデータソースを作成する場合。
環境変数: | boolean |
|
準備されたステートメントをクライアント側でキャッシュするかどうか。
環境変数: | boolean |
|
データソースの URL。 複数の値が設定されている場合、このデータソースは 1 つのサーバーではなくサーバーリストを含むプールを作成します。プールは、接続確立時のサーバー選択にラウンドロビン負荷分散を使用します。一部のドライバーは、このコンテキストで複数の値をサポートできない場合があることに注意してください。
環境変数: | 文字列のリスト | |
データソースプールの最大サイズ。
環境変数: | int |
|
新しい接続オブジェクトが作成されると、プールはそれにイベントループを割り当てます。
環境変数: | int | |
すべてのサーバー証明書を信頼するかどうか。
環境変数: | boolean |
|
デフォルトで、PEM Trust 設定は無効になっています。
環境変数: | boolean |
|
信頼証明書ファイルのコンマ区切りリスト (Pem フォーマット)。
環境変数: | 文字列のリスト | |
デフォルトで、JKS 設定は無効になっています。
環境変数: | boolean |
|
キーファイルのパス (JKS フォーマット)。
環境変数: | string | |
キーファイルのパスワード。
環境変数: | string | |
デフォルトで、PFX 設定は無効になっています。
環境変数: | boolean |
|
キーファイルへのパス (PFX フォーマット)。
環境変数: | string | |
キーのパスワード。
環境変数: | string | |
デフォルトで、PEM キー/証明書設定は無効になっています。
環境変数: | boolean |
|
キーファイルへのパスのコンマ区切りリスト (Pem フォーマット)。
環境変数: | 文字列のリスト | |
証明書ファイルへのパスのコンマ区切りリスト (Pem フォーマット)。
環境変数: | 文字列のリスト | |
デフォルトで、JKS 設定は無効になっています。
環境変数: | boolean |
|
キーファイルのパス (JKS フォーマット)。
環境変数: | string | |
キーファイルのパスワード。
環境変数: | string | |
デフォルトで、PFX 設定は無効になっています。
環境変数: | boolean |
|
キーファイルへのパス (PFX フォーマット)。
環境変数: | string | |
キーのパスワード。
環境変数: | string | |
プールされた接続が初回試行時に確立できなかった場合の再接続の試行回数。
環境変数: | int |
|
プールされた接続が初回試行時に確立できなかった場合の再接続の試行間隔。
環境変数: |
| |
サーバーのアイデンティティーをチェックする必要がある場合に使用するホスト名検証アルゴリズム。
環境変数: | string |
|
プール内で未使用の接続が閉じられるまでの、未使用状態の最大継続時間。
環境変数: |
| |
接続がプール内に留まる最大時間。この時間が経過すると接続は戻ったときに閉じられ、必要に応じて置き換えられます。
環境変数: |
| |
データソース間でプールを共有する場合は true に設定します。複数の共有プールを名前で区別できます。特定の名前を設定しない場合、
環境変数: | boolean |
|
プール名を設定します。この名前は、プールがデータソース間で共有される場合に使用され、それ以外では無視されます。
環境変数: | string | |
新しい接続の開始時に、リアクティブ SQL クライアントを介してデータベースに直接渡されるその他の未指定のプロパティー。
環境変数: |
|
duration の値を書き込むには、標準の java.time.Duration
フォーマットを使用します。詳細は、Duration#parse() Java API ドキュメント を参照してください。
数字で始まる簡略化されたフォーマットも使用できます。
- 値が数値のみの場合は、秒単位の時間を表します。
-
数字の後に
ms
が続く値は、ミリ秒単位の時間を表します。
その他の場合は、解析のために簡略化されたフォーマットが java.time.Duration
フォーマットに変換されます。
-
数字の後に
h
、m
、またはs
が続く値には、接頭辞PT
が付きます。 -
数字の後に
d
が続く値は、接頭辞P
が付きます。
1.4.5.1. リアクティブ DB2 設定
ビルド時に固定された設定プロパティー: その他の設定プロパティーはすべて実行時にオーバーライド可能
型 | デフォルト | |
SSL/TLS が有効かどうか。
環境変数: | boolean |
|
1.4.5.2. リアクティブ MariaDB/MySQL 固有の設定
ビルド時に固定された設定プロパティー: その他の設定プロパティーはすべて実行時にオーバーライド可能
型 | デフォルト | |
接続の charset。
環境変数: | string | |
接続の照合。
環境変数: | string | |
サーバーへの接続に必要なセキュリティー状態。 MySQL Reference Manual を参照してください。
環境変数: |
|
|
接続タイムアウト (秒単位)
環境変数: | int | |
クライアントが使用する必要がある認証プラグイン。デフォルトでは、最初のハンドシェイクパケットでサーバーが指定したプラグイン名が使用されます。
環境変数: |
|
|
パイプライン化できる未完了のデータベースコマンドの最大数。デフォルトでは、パイプライン化は無効になっています。
環境変数: | int | |
実際に変更された行数ではなく、UPDATE ステートメントの WHERE 句に一致する行の数を返すかどうか。
環境変数: | boolean |
|
1.4.5.3. リアクティブ Microsoft SQL サーバー固有の設定
ビルド時に固定された設定プロパティー: その他の設定プロパティーはすべて実行時にオーバーライド可能
型 | デフォルト | |
TDS パケットの必要なサイズ (バイト単位)。
環境変数: | int | |
SSL/TLS が有効かどうか。
環境変数: | boolean |
|
1.4.5.4. リアクティブ Oracle 固有の設定
ビルド時に固定された設定プロパティー: その他の設定プロパティーはすべて実行時にオーバーライド可能
型 | デフォルト |
1.4.5.5. リアクティブ PostgreSQL 固有の設定
ビルド時に固定された設定プロパティー: その他の設定プロパティーはすべて実行時にオーバーライド可能
型 | デフォルト | |
パイプライン化できる未完了のデータベースコマンドの最大数。
環境変数: | int | |
クライアントの SSL 動作モード。 Protection Provided in Different Modes を参照してください。
環境変数: |
|
|
レベル 7 のプロキシーは、実際のデータベースへの複数の接続でクエリーの負荷を分散できます。これが起こると、クライアントはセッションアフィニティーの欠如によって混乱し、ERROR: unnamed prepared statement does not exist (26000) のような望ましくないエラーが発生する可能性があります。Using a level 7 proxy を参照してください。
環境変数: | boolean |
|
1.4.6. リアクティブデータソース URL リファレンス
1.4.6.1. DB2
db2://[user[:[password]]@]host[:port][/database][?<key1>=<value1>[&<key2>=<value2>]]
- 例
-
db2://dbuser:secretpassword@database.server.com:50000/mydb
現在、クライアントは次のパラメーターキーをサポートしています。
-
host
-
port
-
user
-
password
-
database
接続 URL でパラメーターを設定すると、デフォルトのプロパティーがオーバーライドされます。
1.4.6.2. Microsoft SQL サーバー
sqlserver://[user[:[password]]@]host[:port][/database][?<key1>=<value1>[&<key2>=<value2>]]
- 例
-
sqlserver://dbuser:secretpassword@database.server.com:1433/mydb
現在、クライアントは次のパラメーターキーをサポートしています。
-
host
-
port
-
user
-
password
-
database
接続 URL でパラメーターを設定すると、デフォルトのプロパティーがオーバーライドされます。
1.4.6.3. MySQL / MariaDB
mysql://[user[:[password]]@]host[:port][/database][?<key1>=<value1>[&<key2>=<value2>]]
- 例
-
mysql://dbuser:secretpassword@database.server.com:3211/mydb
現在、クライアントは次のパラメーターキーをサポートしています (大文字と小文字は区別されません)。
-
host
-
port
-
user
-
password
-
schema
-
socket
-
useAffectedRows
接続 URL でパラメーターを設定すると、デフォルトのプロパティーがオーバーライドされます。
1.4.6.4. Oracle
1.4.6.4.1. EZConnect フォーマット
oracle:thin:@[[protocol:]//]host[:port][/service_name][:server_mode][/instance_name][?connection properties]
- 例
-
oracle:thin:@mydbhost1:5521/mydbservice?connect_timeout=10sec
1.4.6.4.2. TNS エイリアスフォーマット
oracle:thin:@<alias_name>[?connection properties]
- 例
-
oracle:thin:@prod_db?TNS_ADMIN=/work/tns/
1.4.6.5. PostgreSQL
postgresql://[user[:[password]]@]host[:port][/database][?<key1>=<value1>[&<key2>=<value2>]]
- 例
-
postgresql://dbuser:secretpassword@database.server.com:5432/mydb
現在、クライアントは以下をサポートしています。
パラメーターキー:
-
host
-
port
-
user
-
password
-
dbname
-
sslmode
-
以下のような追加プロパティー:
-
application_name
-
fallback_application_name
-
search_path
-
options
-
接続 URL でパラメーターを設定すると、デフォルトのプロパティーがオーバーライドされます。