追加の接続プロパティ

In addition to the standard connection parameters, the Advanced Server JDBC driver supports connection properties that control behavior specific to EnterpriseDB. You can specify these properties in the connection URL or as a Properties object parameter passed to DriverManager.getConnection(). Listing 1.2 demonstrates how to use a Properties object to specify additional connection properties:

リスト1.2

String url = "jdbc:edb://localhost/edb";
Properties props = new Properties();

props.setProperty("user", "enterprisedb");
props.setProperty("password", "enterprisedb");
props.setProperty("sslfactory", "com.edb.ssl.NonValidatingFactory");
props.setProperty("ssl", "true");

Connection con = DriverManager.getConnection(url, props);

注釈

By default the combination of SSL=true and setting the connection URL parameter sslfactory=org.postgresql.ssl.NonValidatingFactory encrypts the connection but does not validate the SSL certificate. To enforce certificate validation, you must use a Custom SSLSocketFactory. For more details about writing a Custom SSLSocketFactory, review the PostgreSQL JDBC driver documentation.

URLに追加の接続プロパティを指定するには、疑問符とキーワードと値のペアのアンパサンドで区切られたリストを追加します。

String url = /"jdbc:edb://localhost/edb?user=enterprisedb&ssl=true/";

追加の接続プロパティの一部を次の表に示します。

表5-2-追加の接続プロパティ

お名前	種類	説明
ユーザー	ひも	接続を確立するデータベースユーザー。
パスワード	ひも	データベースユーザーのパスワード。
ssl	ブール	認証済みの暗号化されたSSL接続を要求します
ログレベル	整数	loglevelの値は、LogStreamまたはLogWriterのDriverManagerの現在の値に出力される詳細の量を決定します。現在、次の値をサポートしています。 com.edb.Driver.DEBUG com.edb.Driver.INFO loglevelの値をINFOに設定してスパースログ情報を含めるか、DEBUGに設定して重要な詳細を生成します。
charSet	ひも	charSetの値は、データベースとの間で送受信されるデータに使用される文字セットを決定します。
prepareThreshold	整数	prepareThresholdの値は、サーバー側の準備済みステートメントに切り替える前に必要なPreparedStatementの実行回数を決定します。デフォルトは5です。
loadBalanceHosts	ブール	デフォルトモード（無効）では、ホストは指定された順序で接続されます。有効な場合、ホストは適切な候補のセットからランダムに選択されます。
targetServerType	ひも	必要な状態のサーバーのみへの接続を開くことができます。許可される値は、any、master、secondary、preferSecondary、preferSyncSecondaryです。現在、マスター/セカンダリの区別は、サーバーが書き込みを許可しているかどうかを観察することによって行われます。値preferSecondaryは、使用可能なセカンダリがある場合はセカンダリへの接続を試み、それ以外の場合はマスターへの接続を許可します。AdvancedServerJDBCConnectorはpreferSyncSecondaryをサポートします。これは、同期セカンダリがアクティブでない場合、同期セカンダリまたはマスターへの接続のみを許可します。preferSyncSecondaryについては、セクション5.2.2を参照してください。注:値slave、preferSlave、preferSyncSlaveは、``セカンダリ``値に置き換えられたため、非推奨になりました。``スレーブ``値は現在もサポートされており、``スレーブ``と``セカンダリ``という用語の使用は同じ機能を提供しますが、``セカンダリ``値を使用することをお勧めします。
skipQuotesOnReturning	ブール	trueに設定すると、RETURNING句の列名は引用されません。これにより、大文字と小文字が区別される列名の比較がなくなります。false（デフォルト設定）に設定すると、列名が引用されます。