diff --git a/doc/pgjdbc.xml b/doc/pgjdbc.xml index a13d320..10d7e5f 100644 --- a/doc/pgjdbc.xml +++ b/doc/pgjdbc.xml @@ -812,6 +812,31 @@ openssl pkcs8 -topk8 -in client.key -out client.pk8 -outform DER -v1 PBE-SHA1-3D + + Connection Fail-over + + + To support simple connection fail-over it is possible to define multiple + endpoints (host and port pairs) in the connection url separated by commas. + The driver will try to once connect to each of them in order until the + connection succeeds. If none succeed, a normal connection exception is + thrown. + + + The syntax for the connection url is: + +jdbc:postgresql://host1:port1,host2:port2/database + + + + + The simple connection fail-over is useful when running against + a high availability postgres installation that has identical data on each node. + For example streaming replication postgres that only accepts connection on the master + node or postgres-xc cluster. + + +