skip to main content
DataDirect Connect Drivers : Microsoft SQL Server Driver : Connection Properties : AlternateServers
  
AlternateServers
Purpose
A list of alternate database servers that is used to failover new or lost connections, depending on the failover method selected. See FailoverMode for information about choosing a failover method.
Valid Values
(servername1[:port1][;property=value[;...]][,servername2[:port2]
[;property=value[;...]]]...)
Behavior
The server name (servername1, servername2, and so on) is required for each alternate server entry. Port number (port1, port2, and so on) and connection properties (property=value) are optional for each alternate server entry. If the port is unspecified, the port number of the primary server is used. If a port number for the primary server is unspecified, a default port number of 1433 is used.
The driver allows only one optional connection property, DatabaseName.
Notes
*If using failover with Microsoft Cluster Server (MSCS), which determines the alternate server for failover instead of the driver, any alternate server specified must be the same as the primary server. For example:
jdbc:datadirect:sqlserver://server1:1433;DatabaseName=TEST;User=test; Password=secret;AlternateServers=(server1:1433;DatabaseName=TEST)
Example
The following URL contains alternate server entries for server2 and server3. The alternate server entries contain the optional DatabaseName property.
jdbc:datadirect:sqlserver://server1:1433;DatabaseName=TEST;User=test;
Password=secret;AlternateServers=(server2:1433;DatabaseName=TEST2,
server2:1433;DatabaseName=TEST3)
Default
None
Data type
String
See also
Configuring Failover