// outil gratuit

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.

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éSynonymesPar défautCe 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éSynonymesPar défautCe 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éSynonymesPar défautCe 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éSynonymesPar défautCe 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.

// sans passer par les chaînes de connexion

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.