 |
JDBC: Connectstring (Auszüge aus der Microsoft Online-Hilfe) |
Zurück
|
Erläuterungen zum JDBC-Connectstring für SQL
jdbc:sqlserver://[serverName[\instanceName][:portNumber]][;property=value[;property=value]]
- jdbc:sqlserver:// (erforderlich) Konstantes Subprotokoll.
- serverName (optional) Adresse des Servers, zu dem eine Verbindung hergestellt werden soll. Es kann
sich um eine DNS oder IP-Adresse bzw. "localhost" oder "127.0.0.1" für den lokalen Computer handeln. Wenn der
Servername nicht im connectstring angegeben wird, muss er in der properties-Auflistung aufgeführt sein.
- instanceName (optional) Bezeichnet die Instanz auf "serverName", zu der eine Verbindung
hergestellt werden soll. Ohne Angabe wird eine Verbindung zur Standardinstanz erstellt.
- portNumber (optional) Bezeichnet den Port auf "serverName", zu dem eine Verbindung hergestellt
werden soll. Der Default ist 1433. Wenn der Default verwendet wird, muss der Port und der davor stehende Doppelpunkt
nicht im Connectstring angegeben werden.
Hinweis: Um eine optimale Leistung der Verbindung zu gewährleisten, sollte "portNumber" festgelegt werden,
wenn eine Verbindung zu einer benannten Instanz hergestellt wird. Dadurch werden Roundtrips zum Server, um
die Portnummer zu ermitteln, vermieden. Wenn "portNumber" und "instanceName" verwendet werden, hat "portNumber"
Vorrang und "instanceName" wird ignoriert.
- property (optional) Optionale Verbindungseigenschaft.
Maskieren von Werten
Bestimmte Teile von Werten müssen aufgrund enthaltener Sonderzeichen (Leerzeichen, Semikola, Anführungszeichen)
maskiert werden. Der JDBC-Treiber unterstützt die Maskierung, indem sie in geschweifte Klammern gesetzt werden. So
maskiert {;} beispielweise ein Semikolon.
Maskierte Werte können Sonderzeichen enthalten (insbesondere '=', ';', '[]' und Leerzeichen), dürfen aber keine
geschweiften Klammern enthalten. Werte, die maskiert werden müssen und geschweifte Klammern enthalten, müssen zu
einer properties-Auflistung hinzugefügt werden.
Hinweis: Leerräume innerhalb der Klammern sind literal und werden nicht gekürzt.