SQL Server-Verbindungszeichenfolgen-Generator
Eine SQL Server- oder Azure SQL-Verbindungszeichenfolge für ADO.NET (Microsoft.Data.SqlClient), ODBC Driver 18, JDBC, Go und SQLAlchemy in einem Formular erstellen oder eine einfügen, um zu sehen, was jedes Schlüsselwort bewirkt und was riskant ist. Alles läuft in deinem Browser: Nichts, was du eingibst, wird irgendwohin gesendet.
Diese Verbindung in SQLly öffnen
Öffnet den Verbindungseditor von SQLly mit vorausgefüllten Angaben.
Diese Verbindung in SQLly öffnen
Privat von Grund auf. Der Builder und der Decoder sind einfaches JavaScript, das in diesem Tab läuft. Die Seite sendet keine Anfrage mit dem, was du eingibst, speichert nichts (nicht einmal in deinem Browser) und funktioniert weiter offline, sobald sie geladen ist. Der Link „In SQLly öffnen“ geht direkt von deinem Browser zur App auf deinem Computer.
SQL Server-Verbindungszeichenfolgen-Formate
SQL Server-Treiber folgen alle demselben keyword=value-Stil, verwenden aber nicht dieselben Keywords: ADO.NET sagt User ID und Connect Timeout, ODBC sagt Uid und ConnectTimeout, JDBC sagt user und loginTimeout, und Go nutzt eine URL. Eine Falle haben sie gemeinsam: Der Port steht nach einem Komma (host,1433, kein Doppelpunkt, überall außer bei JDBC und Go.
Die andere Sache, an der sich viele stoßen, ist die Verschlüsselung. Microsoft.Data.SqlClient 4.0, ODBC Driver 18 und JDBC Driver 10.2 verschlüsseln alle standardmäßig und prüfen das Serverzertifikat, sodass Verbindungszeichenfolgen, die jahrelang funktionierten, nach einem Upgrade plötzlich fehlschlugen. Beim Builder heißt es Encrypt explizit an, und der Decoder sagt Ihnen, was ein nicht gesetztes Encrypt für jeden Treiber bedeutet.
ADO.NET Microsoft.Data.SqlClient, System.Data.SqlClient, Entity Framework, Dapper
Server=sql01.example.com;Database=Sales;User ID=app_user;Password=your_password;Encrypt=True;
ODBC ODBC Driver 18 for SQL Server, pyodbc
Driver={ODBC Driver 18 for SQL Server};Server=sql01.example.com;Database=Sales;Uid=app_user;Pwd=your_password;Encrypt=yes;
JDBC Microsoft JDBC-Treiber für SQL Server
jdbc:sqlserver://sql01.example.com;databaseName=Sales;user=app_user;password=your_password;encrypt=true;
Go-URL github.com/microsoft/go-mssqldb
sqlserver://app_user:[email protected]?database=Sales&encrypt=true
SQLAlchemy-URL Python SQLAlchemy mit pyodbc
mssql+pyodbc://app_user:[email protected]/Sales?driver=ODBC+Driver+18+for+SQL+Server&Encrypt=yes
Windows-Authentifizierung (ADO.NET) Integrierte Sicherheit
Server=sql01.example.com;Database=Sales;Integrated Security=True;Encrypt=True;
Azure SQL mit Microsoft Entra ID (ADO.NET) Verwaltete Identität, Azure CLI oder Anmeldung über Visual Studio
Server=myserver.database.windows.net;Database=Sales;Authentication=Active Directory Default;Encrypt=True;
Platzhalter wie your_password sind genau das: Stell deine eigene Verbindungszeichenfolge mit dem Formular oben zusammen. Mehr dazu, wie du SQLly mit SQL Server verbindest: SQLly für SQL Server.
Schlüsselwörter für Microsoft.Data.SqlClient (ADO.NET)
Schlüsselwörter sind unabhängig von Groß- und Kleinschreibung, Leerzeichen um sie herum werden ignoriert, und wenn ein Schlüsselwort (oder eines seiner Synonyme) zweimal auftaucht, gewinnt der letzte Wert. Ein unbekanntes Schlüsselwort wirft Keyword not supported. Setze einen Wert in " oder ' , wenn er ;, oder mit einem Leerzeichen oder Anführungszeichen beginnt oder endet; innerhalb der Anführungszeichen verdoppelst du das Anführungszeichen.
| Schlüsselwort | Synonyme | Standard | Was es bewirkt |
|---|---|---|---|
Server |
Data Source, Address, Addr, Network Address | - | host, host\instance, host,port, oder tcp:host,port. . und (local) bedeutet diese Maschine; (localdb)\MSSQLLocalDB ist LocalDB. Eine benannte Instanz wird über SQL Server Browser auf UDP 1434 gefunden. |
Database |
Initialkatalog | die Standarddatenbank des Logins | Datenbank, die nach dem Verbinden verwendet wird. |
User ID |
UID, Benutzer | - | SQL-Login oder der Entra-Benutzername für Active Directory Password / Interactive. |
Password |
PWD | - | Wird ignoriert, wenn Integrated Security aktiviert ist. |
Integrated Security |
Trusted_Connection | falsch | true, yes oder sspi meldet sich als das Windows-Konto an, das den Prozess ausführt (Kerberos oder NTLM). |
Authentication |
- | nicht gesetzt | Sql Password, Active Directory Integrated, Active Directory Interactive, Active Directory Default, Active Directory Managed Identity (Alias Active Directory MSI), Active Directory Service Principal, Active Directory Device Code Flow, Active Directory Workload Identity (5.2+), Active Directory Password (veraltet). Ab Version 7.0 erfordern die Entra-Methoden die Microsoft.Data.SqlClient.Extensions.Azure Paket. |
Encrypt |
- | true (Pflicht) in 4.0+; false in 3.x und früher |
true/yes/Mandatory, false/no/Optional, oder Strict (5.x+, TDS 8.0: SQL Server 2022+ und Azure SQL). Mit Optional ist das Login-Paket weiterhin verschlüsselt, der Rest nicht. |
TrustServerCertificate |
Serverzertifikat vertrauen | falsch | true überspringt die Zertifikatsprüfung. Wird ignoriert (als falsch behandelt) mit Encrypt=Strict. |
HostNameInCertificate |
Hostnamen im Zertifikat | - | 5.0+. Der Name, der im Serverzertifikat erwartet wird, wenn er sich von Server, zum Beispiel beim Verbinden über einen Alias oder eine IP-Adresse. |
ServerCertificate |
Serverzertifikat | - | 5.1+. Pfad zu einer Zertifikatsdatei, mit der das Serverzertifikat exakt übereinstimmen muss. |
Connect Timeout |
Verbindungs-Timeout, Timeout | 15 | Sekunden, um auf eine Verbindung zu warten, bevor ein Fehler auftritt. |
Command Timeout |
- | 30 | 2.1+. Standard SqlCommand.CommandTimeout in Sekunden; 0 wartet unbegrenzt. |
Application Name |
App | Core Microsoft SqlClient Data Provider (.NET) |
Wird angezeigt als program_name in sys.dm_exec_sessions und im Profiler / Extended Events. |
ApplicationIntent |
Anwendungsabsicht | ReadWrite | ReadOnly leitet an ein lesbares Sekundärreplikat einer Verfügbarkeitsgruppe oder an ein Lesereplikat in Azure SQL weiter. |
MultiSubnetFailover |
Multi-Subnet-Failover | falsch | Setzen auf true wenn du eine Verbindung mit einem Verfügbarkeitsgruppen-Listener herstellst, der sich über mehrere Subnetze erstreckt, für ein schnelleres Failover. |
MultipleActiveResultSets |
Mehrere aktive Ergebnismengen | falsch | MARS: mehrere offene Reader auf einer Verbindung. |
Pooling |
- | wahr | Verbindungs-Pooling. |
Max Pool Size |
- | 100 | Größte Anzahl an Pool-Verbindungen pro eindeutiger Verbindungszeichenfolge. |
Min Pool Size |
- | 0 | Verbindungen, die im Pool offen gehalten werden. |
ConnectRetryCount |
Anzahl der Verbindungswiederholungen | 1 | 0 bis 255 Wiederverbindungsversuche, nachdem eine inaktive Verbindung abgebrochen ist. |
ConnectRetryInterval |
Intervall der Verbindungswiederholung | 10 | 1 bis 60 Sekunden zwischen diesen Versuchen. |
Persist Security Info |
PersistSecurityInfo | falsch | true lässt das Passwort lesbar in ConnectionString nach dem Öffnen. Lass es ausgeschaltet. |
Schlüsselwörter des ODBC Driver 18 for SQL Server
Verwendet von pyodbc, R, PHP, Excel und allem anderen über ODBC. Werte, die Sonderzeichen enthalten ([]{}(),;?*=!@) in geschweifte Klammern setzen. Im Gegensatz zu ADO.NET gewinnt bei wiederholten Schlüsselwörtern das erste Vorkommen.
| Schlüsselwort | Synonyme | Standard | Was es bewirkt |
|---|---|---|---|
Driver |
- | - | {ODBC Driver 18 for SQL Server} (oder 17). Muss mit dem Namen übereinstimmen, den der Treiber-Manager auflistet. |
Server |
Adresse, Addr | - | [tcp:]host[\instance][,port]. |
Database |
- | Standard-Login | Datenbankname. |
UID / PWD |
- | - | SQL-Login und Passwort. |
Trusted_Connection |
- | nein | yes verwendet Windows-Authentifizierung. |
Authentication |
- | - | SqlPassword, ActiveDirectoryIntegrated, ActiveDirectoryInteractive (Windows), ActiveDirectoryMsi, ActiveDirectoryServicePrincipal, ActiveDirectoryPassword (veraltet). Es gibt kein ActiveDirectoryDefault in ODBC. |
Encrypt |
- | ja (Treiber 18), nein (17 und älter) | yes/mandatory, no/optional, strict (18.1.2.1+). |
TrustServerCertificate |
- | nein | yes überspringt die Zertifikatsprüfung; wird ignoriert mit Encrypt=strict. |
HostnameInCertificate |
- | - | 18.0+. Erwarteter Hostname im Zertifikat. |
ServerCertificate |
- | - | 18.1+. Zertifikatsdatei, mit der das Serverzertifikat übereinstimmen muss. |
ConnectTimeout |
- | 15 | 18.7+. Anmelde-Timeout in Sekunden; 0 bedeutet keine Begrenzung. Ältere Treiber nehmen nur SQL_ATTR_LOGIN_TIMEOUT aus dem Code. |
APP |
- | - | Anwendungsname. |
ApplicationIntent |
- | ReadWrite | ReadOnly für lesbare sekundäre Replikate. |
MultiSubnetFailover |
- | Nein | Yes für Multi-Subnet-Verfügbarkeitsgruppen. |
Eigenschaften des Microsoft JDBC-Treibers für SQL Server
URL-Format: jdbc:sqlserver://[serverName[\instanceName][:portNumber]][;property=value...]. Eigenschaftsnamen unterscheiden nicht zwischen Groß- und Kleinschreibung. Ein Wert, der ; enthält, kommt in geschweifte Klammern, und ab Treiber 8.4 wird eine schließende Klammer innerhalb der Klammern verdoppelt: password={pass;}}word}.
| Schlüsselwort | Synonyme | Standard | Was es bewirkt |
|---|---|---|---|
databaseName |
Datenbank | - | Datenbankname. |
user |
Benutzername | - | Anmeldename. |
password |
- | - | Passwort. |
integratedSecurity |
- | falsch | Windows-Authentifizierung. Unter Windows braucht es mssql-jdbc_auth-<version>.dll; an anderer Stelle ergänze authenticationScheme=JavaKerberos. |
authentication |
- | Nicht angegeben | SqlPassword, ActiveDirectoryPassword, ActiveDirectoryIntegrated, ActiveDirectoryInteractive (9.2+), ActiveDirectoryServicePrincipal (9.2+), ActiveDirectoryManagedIdentity (12.2+; ActiveDirectoryMSI davor). |
encrypt |
- | true (10.2+); false (9.4 und älter) | true, false, oder strict (11.2+). |
trustServerCertificate |
- | falsch | true überspringt die Zertifikatsprüfung. |
hostNameInCertificate |
- | - | Erwarteter Zertifikats-Hostname. |
serverCertificate |
- | - | 11.2+. Zertifikatsdatei zum Abgleich, wird mit strict verwendet. |
loginTimeout |
- | 30 (11.2+), 15 (ältere Versionen) | Sekunden, um auf die Anmeldung zu warten. |
queryTimeout |
- | -1 (keine Begrenzung) | Standard-Timeout für Abfragen in Sekunden. |
applicationName |
- | Microsoft JDBC-Treiber für SQL Server | Anwendungsname. |
applicationIntent |
- | ReadWrite | ReadOnly für lesbare sekundäre Replikate. |
multiSubnetFailover |
- | falsch | Multi-Subnet-Verfügbarkeitsgruppen. |
instanceName |
- | - | Benannte Instanz, als Alternative zu host\instance im URL. |
go-mssqldb URL-Parameter
URL-Format: sqlserver://user:password@host:port?database=... oder sqlserver://user:password@host/instance?.... Der Pfad ist der Instanzname, niemals die Datenbank. Prozentkodiere Sonderzeichen in Benutzer und Passwort. Parameternamen unterscheiden nicht zwischen Groß- und Kleinschreibung.
| Schlüsselwort | Synonyme | Standard | Was es bewirkt |
|---|---|---|---|
database |
- | - | Datenbankname. |
encrypt |
- | false (nur Login-Paket) | strict, disable (gar kein TLS), false, true. Beachte, dass der Standardwert von Microsofts eigenen Treibern abweicht. |
TrustServerCertificate |
- | false, wenn encrypt gesetzt ist, true, wenn es nicht gesetzt ist | true überspringt die Zertifikatsprüfung. |
app name |
- | go-mssqldb | Anwendungsname (schreibe ihn app+name oder app%20name im URL). |
connection timeout |
- | 0 (keine) | Sekunden für die gesamte Verbindung. |
dial timeout |
- | 15 pro registriertem Protokoll | Sekunden für den TCP-Verbindungsaufbau. |
fedauth |
- | - | Entra-Methoden (ActiveDirectoryDefault, ActiveDirectoryManagedIdentity, ActiveDirectoryPassword, ...) mit dem azuread Paket und dem azuresql Treibernamen. |
Häufige SQL Server-Verbindungsfehler
The certificate chain was issued by an authority that is not trusted.
Warum: Microsoft.Data.SqlClient 4.0+, ODBC-Treiber 18 und JDBC 10.2+ verschlüsseln standardmäßig und prüfen das Serverzertifikat. Der Server verwendet sein automatisch generiertes selbstsigniertes Zertifikat oder ein Zertifikat einer privaten CA, der dein Computer nicht vertraut.
Lösung: Installiere ein Zertifikat von einer vertrauenswürdigen CA auf dem Server (oder vertraue deiner internen CA auf dem Client). Wenn das Zertifikat gültig, aber für einen anderen Namen ausgestellt ist, setze HostNameInCertificate. Nur für einen lokalen Entwicklungsserver TrustServerCertificate=True bringt dich in Gang.
Login failed for user 'app_user'. (Error 18456)
Warum: Falsches Passwort, ein SQL-Login auf einem Server, der nur Windows-Authentifizierung zulässt, ein deaktiviertes Login oder eine Standarddatenbank, die das Login nicht öffnen kann. Das Serverprotokoll zeichnet den eigentlichen Grund als Statusnummer auf.
Lösung: Prüfe das Passwort, aktiviere den SQL Server- und Windows-Authentifizierungsmodus, wenn du SQL-Logins verwendest, und setze Database auf eine, die das Login öffnen kann. Der Status im Serverfehlerprotokoll (zum Beispiel Status 8 = falsches Passwort, Status 38 = Datenbank nicht verfügbar) zeigt dies genau an.
Keyword not supported: 'host'.
Warum: Microsoft.Data.SqlClient akzeptiert nur seine eigenen Schlüsselwörter. Host, Username und Port sind Npgsql/MySQL-Schlüsselwörter; Provider= gehört zu OLE DB-Verbindungszeichenfolgen; ein Tippfehler wie Databse schlägt auf die gleiche Weise fehl.
Lösung: Verwende Server, User ID, und host,port. Füge die Zeichenfolge in den Decoder oben ein: Jedes unbekannte Schlüsselwort wird markiert.
Format of the initialization string does not conform to specification starting at index 42.
Warum: Ein Wert enthält ; oder ein Anführungszeichen und wurde nicht in Anführungszeichen gesetzt, sodass der Parser die Zeichenfolge an der falschen Stelle teilt. Passwörter sind der übliche Schuldige.
Lösung: Setze den Wert in doppelte Anführungszeichen und verdopple jedes doppelte Anführungszeichen darin: Password="p;a""ss". Der Builder maskiert Werte für dich.
The target principal name is incorrect. Cannot generate SSPI context.
Warum: Integrierte Sicherheit verwendet Kerberos, und der Dienstprinzipalname (SPN) für den SQL Server-Dienst fehlt, ist doppelt vorhanden oder für ein anderes Konto registriert, oder du hast die Verbindung über eine IP-Adresse oder einen Alias aufgebaut.
Lösung: Verbinde dich mit dem vollqualifizierten Namen des Servers und lass einen Administrator den SPN registrieren (setspn -L <service account> listet sie auf). Bei einer Abweichung beim Zertifikatsnamen prüfe auch HostNameInCertificate.
FAQ zu SQL Server-Verbindungszeichenfolgen
Was ist der Standardport für SQL Server?
1433 für die Standardinstanz. Benannte Instanzen verwenden normalerweise einen dynamischen Port, über den der SQL Server Browser (UDP 1434) den Client informiert, weshalb host\instance ohne Port funktioniert. In ADO.NET und ODBC folgt der Port nach einem Komma: Server=host,1433.
Soll ich Encrypt=True oder TrustServerCertificate=True verwenden?
Verwende Encrypt=True (oder Strict auf SQL Server 2022 und Azure SQL) mit einem Zertifikat, dem deine Clients vertrauen. TrustServerCertificate=True hält den Verkehr verschlüsselt, hindert den Client aber daran zu prüfen, mit wem er spricht, sodass jeder, der die Verbindung abfangen kann, sich als Server ausgeben kann. Für die lokale Entwicklung ist das in Ordnung.
Was hat sich bei Encrypt in Microsoft.Data.SqlClient 4.0 geändert?
Der Standard für Encrypt hat sich geändert von false zu true, und der Treiber validiert standardmäßig das Serverzertifikat. ODBC-Treiber 18 und JDBC-Treiber 10.2 haben dieselbe Änderung vorgenommen. Verbindungszeichenfolgen ohne Encrypt Schlüsselwort, die früher ohne TLS verbunden wurden, benötigen jetzt ein vertrauenswürdiges Zertifikat auf dem Server.
Wie verbinde ich mich mit Azure SQL Database über Microsoft Entra ID?
Hinzufügen Authentication=Active Directory Default (nimmt eine verwaltete Identität, Umgebungsanmeldeinformationen oder deine Azure CLI / Visual Studio-Anmeldung) und lässt das Passwort weg. Verwende Active Directory Managed Identity in Azure-gehosteten Apps und Active Directory Interactive für eine Browser-Anmeldung. Azure SQL akzeptiert Integrated Security=SSPI.
Was ist der Unterschied zwischen Data Source und Server oder Initial Catalog und Database?
Keiner. Es sind Synonyme in Microsoft.Data.SqlClient, ebenso wie User ID / UID / User und Password / PWD. Tauchen beide Schreibweisen auf, gewinnt die letzte.
Verwendet System.Data.SqlClient dieselbe Verbindungszeichenfolge?
Meistens. Es akzeptiert die klassischen Schlüsselwörter, aber nicht neuere wie Command Timeout, Encrypt=Strict, HostNameInCertificate oder die meisten Authentication Werte, und es verwendet standardmäßig Encrypt=False. Microsoft empfiehlt den Umstieg auf Microsoft.Data.SqlClient.
Andere Engines
- PostgreSQL-Verbindungszeichenfolgen
- MySQL-Verbindungszeichenfolgen
- MariaDB-Verbindungszeichenfolgen
- SQLite-Verbindungszeichenfolgen
- Oracle-Verbindungszeichenfolgen
- Redis-Verbindungszeichenfolgen
- ClickHouse-Verbindungszeichenfolgen
- DuckDB-Verbindungszeichenfolgen
- libSQL-Verbindungszeichenfolgen
- Alle Engines und Formate
- SQL-Formatter
- Alle kostenlosen Tools
Einmal verbinden. Dann einfach SQL schreiben.
SQLLY ist eine native SQL-Workbench für macOS, Windows und Linux. Füge eine Verbindungszeichenfolge in den Verbindungseditor ein, speichere Passwörter in deinem System-Schlüsselbund, und erhalte schemabewusstes IntelliSense für SQL Server und mehr.