8.2.3 connect(String url, Properties info)
(1) 機能
接続情報に従ってHADBサーバに接続します。
なお,connectメソッドを実行するにはCONNECT権限が必要です。
(2) 形式
public Connection connect(String url, Properties info) throws SQLException
(3) 引数
- String url:
-
接続用のURLを指定します。
接続用のURLの指定形式については,「7.3.1 DriverManagerクラスのgetConnectionメソッドでHADBサーバに接続する方法」の「(2) getConnectionメソッドによるHADBサーバへの接続」の「(a) 引数urlの指定内容(接続用のURLの指定)」を参照してください。
- Properties info:
-
接続引数としてのプロパティ名称と値のペアのリストを指定します。指定形式については,「7.3.1 DriverManagerクラスのgetConnectionメソッドでHADBサーバに接続する方法」の「(2) getConnectionメソッドによるHADBサーバへの接続」の「(d) 引数infoの指定内容(ユーザプロパティの指定)」を参照してください。
(4) 戻り値
Connectionオブジェクトが返却されます。
指定されたURLが不正な場合(URLに指定したデータベースに接続できない場合),nullが返却されます。
(5) 発生する例外
次に示す場合にSQLExceptionが投入されます。
-
データベースのアクセスエラーが発生した場合
-
指定した接続情報に誤りがある場合
(6) 留意事項
接続情報は,各プロパティやメソッドなど複数の個所で設定できます。適用される接続情報の優先順位については,「7.3.3 接続情報の優先順位」の「(1) HADBサーバへの接続時に必要となる接続情報」を参照してください。