Générateur de chaînes de connexion SQL Server
Créez une chaîne de connexion SQL Server ou Azure SQL pour ADO.NET (Microsoft.Data.SqlClient), ODBC Driver 18, JDBC, Go et SQLAlchemy à partir d'un seul formulaire, ou collez-en une pour voir à quoi sert chaque mot-clé et ce qui est risqué. Tout fonctionne dans votre navigateur : rien de ce que vous tapez n'est envoyé quelque part.
Ouvrir cette connexion dans SQLly
Ouvre l'éditeur de connexion de SQLly, prérempli.
Ouvrir cette connexion dans SQLly
Privé par conception. Le constructeur et le décodeur sont du JavaScript pur fonctionnant dans cet onglet. La page n'envoie aucune requête avec ce que vous tapez, ne stocke rien (pas même dans votre navigateur) et continue de fonctionner hors ligne une fois chargée. Le lien Ouvrir dans SQLly va directement de votre navigateur à l'application sur votre ordinateur.
Formats de chaînes de connexion SQL Server
Les pilotes SQL Server partagent un style mot-clé=valeur, mais pas les mots-clés : ADO.NET dit User ID et Connect Timeout, ODBC dit Uid et ConnectTimeout, JDBC dit user et loginTimeout, et Go utilise une URL. Ils partagent aussi un piège : un port se place après une virgule (host,1433), pas un deux-points, partout sauf pour JDBC et Go.
L’autre piège, c’est le chiffrement. Microsoft.Data.SqlClient 4.0, ODBC Driver 18 et JDBC Driver 10.2 chiffrent tous par défaut et valident le certificat du serveur, donc des chaînes qui fonctionnaient depuis des années ont commencé à échouer après une mise à niveau. Le générateur indique Encrypt explicitement, et le décodeur vous dit ce qu'une valeur non définie Encrypt signifie pour chaque pilote.
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 Pilote ODBC 18 pour 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 Pilote JDBC Microsoft pour SQL Server
jdbc:sqlserver://sql01.example.com;databaseName=Sales;user=app_user;password=your_password;encrypt=true;
URL Go github.com/microsoft/go-mssqldb
sqlserver://app_user:[email protected]?database=Sales&encrypt=true
URL SQLAlchemy Python SQLAlchemy avec pyodbc
mssql+pyodbc://app_user:[email protected]/Sales?driver=ODBC+Driver+18+for+SQL+Server&Encrypt=yes
Authentification Windows (ADO.NET) Sécurité intégrée
Server=sql01.example.com;Database=Sales;Integrated Security=True;Encrypt=True;
Azure SQL avec Microsoft Entra ID (ADO.NET) Identité gérée, Azure CLI ou connexion Visual Studio
Server=myserver.database.windows.net;Database=Sales;Authentication=Active Directory Default;Encrypt=True;
Espaces réservés tels que your_password sont exactement cela : construisez votre propre chaîne avec le formulaire ci-dessus. Pour en savoir plus sur la connexion de SQLly à SQL Server : SQLly pour SQL Server.
Mots-clés Microsoft.Data.SqlClient (ADO.NET)
Les mots-clés ne tiennent pas compte de la casse, les espaces autour d'eux sont ignorés, et lorsqu'un mot-clé (ou un de ses synonymes) apparaît deux fois, c'est la dernière valeur qui l'emporte. Un mot-clé inconnu génère une erreur Keyword not supported. Mettez une valeur entre guillemets dans " ou ' lorsqu'elle contient ;, ou commence ou se termine par un espace ou un guillemet ; à l'intérieur des guillemets, doublez le guillemet.
| Mot-clé | Synonymes | Par défaut | Ce que cela fait |
|---|---|---|---|
Server |
Data Source, Address, Addr, Network Address | - | host, host\instance, host,port, ou tcp:host,port. . et (local) signifie cette machine ; (localdb)\MSSQLLocalDB est LocalDB. Une instance nommée est trouvée via SQL Server Browser sur le port UDP 1434. |
Database |
Initial Catalog | la base de données par défaut de la connexion | Base de données à utiliser une fois connecté. |
User ID |
UID, Utilisateur | - | Connexion SQL, ou le nom d'utilisateur Entra pour Active Directory Password / Interactive. |
Password |
PWD | - | Ignoré lorsque Integrated Security est activé. |
Integrated Security |
Trusted_Connection | faux | true, yes ou sspi se connecte avec le compte Windows sous lequel le processus s'exécute (Kerberos ou NTLM). |
Authentication |
- | non défini | 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 (obsolète). À partir de la version 7.0, les méthodes Entra nécessitent le Microsoft.Data.SqlClient.Extensions.Azure package. |
Encrypt |
- | true (Obligatoire) dans 4.0+; false dans les versions 3.x et antérieures |
true/yes/Mandatory, false/no/Optional, ou Strict (5.x+, TDS 8.0 : SQL Server 2022+ et Azure SQL). Avec Optional le paquet de connexion est toujours chiffré, le reste ne l'est pas. |
TrustServerCertificate |
Faire confiance au certificat du serveur | faux | true ignore la validation du certificat. Ignoré (considéré comme faux) avec Encrypt=Strict. |
HostNameInCertificate |
Host Name In Certificate | - | 5.0+. Le nom attendu dans le certificat du serveur lorsqu'il diffère de Server, par exemple lors d'une connexion via un alias ou une adresse IP. |
ServerCertificate |
Server Certificate | - | 5.1+. Chemin vers un fichier de certificat auquel le certificat du serveur doit correspondre exactement. |
Connect Timeout |
Délai d'attente de connexion, Délai d'attente | 15 | Secondes d'attente d'une connexion avant échec. |
Command Timeout |
- | 30 | 2.1+. Par défaut SqlCommand.CommandTimeout en secondes ; 0 attend indéfiniment. |
Application Name |
Application | Core Microsoft SqlClient Data Provider (.NET) |
S'affiche comme program_name dans sys.dm_exec_sessions et dans le Profiler / Événements étendus. |
ApplicationIntent |
Intention de l'application | LectureÉcriture | ReadOnly dirige vers un secondaire lisible d'un groupe de disponibilité ou une réplique en lecture dans Azure SQL. |
MultiSubnetFailover |
Basculement multi-sous-réseau | faux | Définir sur true lors de la connexion à un écouteur de groupe de disponibilité qui s'étend sur plusieurs sous-réseaux, pour une bascule plus rapide. |
MultipleActiveResultSets |
Jeux de résultats actifs multiples | faux | MARS : plusieurs lecteurs ouverts sur une seule connexion. |
Pooling |
- | vrai | Pool de connexions. |
Max Pool Size |
- | 100 | Nombre maximum de connexions mises en pool par chaîne de connexion distincte. |
Min Pool Size |
- | 0 | Connexions maintenues ouvertes dans le pool. |
ConnectRetryCount |
Nombre de tentatives de reconnexion | 1 | 0 à 255 tentatives de reconnexion après la rupture d'une connexion inactive. |
ConnectRetryInterval |
Intervalle de reconnexion | 10 | 1 à 60 secondes entre ces tentatives. |
Persist Security Info |
PersistSecurityInfo | faux | true laisse le mot de passe lisible dans ConnectionString après l’ouverture. Laissez-le désactivé. |
Mots-clés du pilote ODBC 18 pour SQL Server
Utilisé par pyodbc, R, PHP, Excel et tout autre programme utilisant ODBC. Encadrez les valeurs qui contiennent des caractères spéciaux ([]{}(),;?*=!@) entre accolades. Contrairement à ADO.NET, lorsque un mot-clé se répète, c'est la première occurrence qui prévaut.
| Mot-clé | Synonymes | Par défaut | Ce que cela fait |
|---|---|---|---|
Driver |
- | - | {ODBC Driver 18 for SQL Server} (ou 17). Doit correspondre au nom indiqué par le gestionnaire de pilotes. |
Server |
Adresse, Addr | - | [tcp:]host[\instance][,port]. |
Database |
- | Connexion par défaut | Nom de la base de données. |
UID / PWD |
- | - | Connexion SQL et mot de passe. |
Trusted_Connection |
- | non | yes utilise l'authentification Windows. |
Authentication |
- | - | SqlPassword, ActiveDirectoryIntegrated, ActiveDirectoryInteractive (Windows), ActiveDirectoryMsi, ActiveDirectoryServicePrincipal, ActiveDirectoryPassword (obsolète). Il n'y a pas de ActiveDirectoryDefault dans ODBC. |
Encrypt |
- | oui (Pilote 18), non (17 et plus anciens) | yes/mandatory, no/optional, strict (18.1.2.1+). |
TrustServerCertificate |
- | non | yes ignore la validation du certificat ; ignoré avec Encrypt=strict. |
HostnameInCertificate |
- | - | 18.0+. Nom d'hôte attendu du certificat. |
ServerCertificate |
- | - | 18.1+. Fichier de certificat auquel le certificat du serveur doit correspondre. |
ConnectTimeout |
- | 15 | 18.7+. Délai de connexion en secondes ; 0 signifie pas de limite. Les anciens pilotes prennent seulement SQL_ATTR_LOGIN_TIMEOUT de code. |
APP |
- | - | Nom de l'application. |
ApplicationIntent |
- | LectureÉcriture | ReadOnly pour les secondaires lisibles. |
MultiSubnetFailover |
- | Non | Yes pour les groupes de disponibilité multi-sous-réseaux. |
Propriétés du pilote JDBC Microsoft pour SQL Server
Forme de l’URL : jdbc:sqlserver://[serverName[\instanceName][:portNumber]][;property=value...]. Les noms de propriété ne sont pas sensibles à la casse. Une valeur contenant ; va entre accolades, et à partir du pilote 8.4, une accolade fermante à l'intérieur des accolades est doublée : password={pass;}}word}.
| Mot-clé | Synonymes | Par défaut | Ce que cela fait |
|---|---|---|---|
databaseName |
base de données | - | Nom de la base de données. |
user |
nomUtilisateur | - | Nom de connexion. |
password |
- | - | Mot de passe. |
integratedSecurity |
- | faux | Authentification Windows. Sous Windows, il faut mssql-jdbc_auth-<version>.dll; ailleurs, ajoutez authenticationScheme=JavaKerberos. |
authentication |
- | NotSpecified | SqlPassword, ActiveDirectoryPassword, ActiveDirectoryIntegrated, ActiveDirectoryInteractive (9.2+), ActiveDirectoryServicePrincipal (9.2+), ActiveDirectoryManagedIdentity (12.2+; ActiveDirectoryMSI avant). |
encrypt |
- | vrai (10.2+) ; faux (9.4 et versions antérieures) | true, false, ou strict (11.2+). |
trustServerCertificate |
- | faux | true ignore la validation du certificat. |
hostNameInCertificate |
- | - | Nom d'hôte attendu du certificat. |
serverCertificate |
- | - | 11.2+. Fichier de certificat à faire correspondre, utilisé avec strict. |
loginTimeout |
- | 30 (11.2+), 15 (plus anciennes) | Secondes d'attente de l'authentification. |
queryTimeout |
- | -1 (sans limite) | Délai d'expiration de requête par défaut en secondes. |
applicationName |
- | Pilote JDBC Microsoft pour SQL Server | Nom de l'application. |
applicationIntent |
- | LectureÉcriture | ReadOnly pour les secondaires lisibles. |
multiSubnetFailover |
- | faux | Groupes de disponibilité multi-sous-réseaux. |
instanceName |
- | - | Instance nommée, comme alternative à host\instance dans l'URL. |
Paramètres de l'URL go-mssqldb
Forme de l’URL : sqlserver://user:password@host:port?database=... ou sqlserver://user:password@host/instance?.... Le chemin est le nom de l'instance, jamais la base de données. Encodez en pourcentage les caractères spéciaux dans l'utilisateur et le mot de passe. Les noms de paramètres ne sont pas sensibles à la casse.
| Mot-clé | Synonymes | Par défaut | Ce que cela fait |
|---|---|---|---|
database |
- | - | Nom de la base de données. |
encrypt |
- | false (paquet de connexion seulement) | strict, disable (pas de TLS du tout), false, true. Notez que la valeur par défaut diffère de celle des pilotes propres à Microsoft. |
TrustServerCertificate |
- | false lorsque encrypt est activé, true lorsqu'il ne l'est pas | true ignore la validation du certificat. |
app name |
- | go-mssqldb | Nom de l'application (écrivez-le app+name ou app%20name dans l'URL). |
connection timeout |
- | 0 (aucun) | Secondes pour l'ensemble de la connexion. |
dial timeout |
- | 15 par protocole enregistré | Secondes pour l'établissement de la connexion TCP. |
fedauth |
- | - | Méthodes Entra (ActiveDirectoryDefault, ActiveDirectoryManagedIdentity, ActiveDirectoryPassword, ...) avec le azuread package et le azuresql nom du pilote. |
Erreurs de connexion SQL Server courantes
The certificate chain was issued by an authority that is not trusted.
Pourquoi : Microsoft.Data.SqlClient 4.0+, ODBC Driver 18 et JDBC 10.2+ chiffrent par défaut et valident le certificat du serveur. Le serveur utilise le certificat auto-signé qu'il a généré lui-même, ou un certificat d'une CA privée que votre machine ne reconnaît pas.
Correction : Installez un certificat d'une autorité de certification (CA) de confiance sur le serveur (ou faites confiance à votre CA interne sur le client). Si le certificat est valide mais pour un autre nom, définissez HostNameInCertificate. Pour un serveur de développement local uniquement, TrustServerCertificate=True vous permet de démarrer.
Login failed for user 'app_user'. (Error 18456)
Pourquoi : Mot de passe incorrect, une connexion SQL sur un serveur qui n'autorise que l'authentification Windows, une connexion désactivée, ou une base de données par défaut que la connexion ne peut pas ouvrir. Le journal du serveur enregistre la véritable raison sous forme de numéro d'état.
Correction : Vérifiez le mot de passe, activez le mode d'authentification SQL Server et Windows si vous utilisez des connexions SQL, et définissez Database sur une base de données que la connexion peut ouvrir. L'état dans le journal des erreurs du serveur (par exemple State 8 = mot de passe incorrect, State 38 = base de données non disponible) permet de l'identifier.
Keyword not supported: 'host'.
Pourquoi : Microsoft.Data.SqlClient n'accepte que ses propres mots-clés. Host, Username et Port sont des mots-clés Npgsql/MySQL ; Provider= appartient aux chaînes de connexion OLE DB ; une faute de frappe comme Databse échoue de la même manière.
Correction : Utilisez Server, User ID, et host,port. Collez la chaîne dans le décodeur ci-dessus : chaque mot-clé inconnu est signalé.
Format of the initialization string does not conform to specification starting at index 42.
Pourquoi : Une valeur contient ; ou un guillemet et n'était pas entre guillemets, donc l'analyseur divise la chaîne au mauvais endroit. Les mots de passe en sont généralement la cause.
Correction : Enveloppez la valeur entre guillemets doubles et doublez tout guillemet double à l'intérieur : Password="p;a""ss". Le générateur échappe les valeurs pour vous.
The target principal name is incorrect. Cannot generate SSPI context.
Pourquoi : La sécurité intégrée utilise Kerberos, et le nom principal de service (SPN) pour le service SQL Server est manquant, dupliqué ou enregistré pour un autre compte, ou vous vous êtes connecté par adresse IP ou alias.
Correction : Connectez-vous avec le nom entièrement qualifié du serveur, et demandez à un administrateur d'enregistrer le SPN (setspn -L <service account> les énumère). En cas de non-correspondance du nom du certificat, vérifiez également HostNameInCertificate.
FAQ sur la chaîne de connexion SQL Server
Quel est le port par défaut pour SQL Server ?
1433 pour l'instance par défaut. Les instances nommées utilisent généralement un port dynamique dont le SQL Server Browser (UDP 1434) informe le client, c'est pourquoi host\instance fonctionne sans port. Dans ADO.NET et ODBC, le port se place après une virgule : Server=host,1433.
Dois-je utiliser Encrypt=True ou TrustServerCertificate=True ?
Utilisez Encrypt=True (ou Strict sur SQL Server 2022 et Azure SQL) avec un certificat que vos clients approuvent. TrustServerCertificate=True garde le trafic chiffré mais empêche le client de vérifier à qui il parle, donc quiconque peut intercepter la connexion peut se faire passer pour le serveur. À réserver au développement local.
Qu'est-ce qui a changé avec Encrypt dans Microsoft.Data.SqlClient 4.0 ?
La valeur par défaut pour Encrypt a changé de false en true, et le pilote valide le certificat du serveur par défaut. Le pilote ODBC 18 et le pilote JDBC 10.2 ont effectué le même changement. Les chaînes sans mot-clé Encrypt qui se connectaient auparavant sans TLS nécessitent maintenant un certificat de confiance sur le serveur.
Comment puis-je me connecter à Azure SQL Database avec Microsoft Entra ID ?
Ajouter Authentication=Active Directory Default (utilise une identité gérée, des informations d'identification de l'environnement ou votre connexion Azure CLI / Visual Studio) et omettez le mot de passe. Utilisez Active Directory Managed Identity dans les applications hébergées sur Azure et Active Directory Interactive pour une connexion via navigateur. Azure SQL n'accepte pas Integrated Security=SSPI.
Quelle est la différence entre Data Source et Server, ou Initial Catalog et Database ?
Aucune. Ce sont des synonymes dans Microsoft.Data.SqlClient, tout comme User ID / UID / User et Password / PWD. Si les deux orthographes apparaissent, la dernière l'emporte.
System.Data.SqlClient utilise-t-il la même chaîne de connexion ?
Pour la plupart. Il accepte les mots-clés classiques mais pas les plus récents comme Command Timeout, Encrypt=Strict, HostNameInCertificate ou la plupart des valeurs de Authentication les valeurs, et il utilise par défaut Encrypt=False. Microsoft recommande de passer à Microsoft.Data.SqlClient.
Autres moteurs
- Chaînes de connexion PostgreSQL
- Chaînes de connexion MySQL
- Chaînes de connexion MariaDB
- Chaînes de connexion SQLite
- Chaînes de connexion Oracle
- Chaînes de connexion Redis
- Chaînes de connexion ClickHouse
- Chaînes de connexion DuckDB
- Chaînes de connexion libSQL
- Tous les moteurs et formats
- Formateur SQL
- Tous les outils gratuits
Connectez-vous une fois. Ensuite, écrivez simplement du SQL.
SQLly est un atelier SQL natif pour macOS, Windows et Linux. Collez une chaîne de connexion dans son éditeur de connexion, gardez les mots de passe dans votre trousseau système et profitez d'un IntelliSense conscient du schéma sur SQL Server et plus encore.