Generador de cadenas de conexión de SQL Server
Crea una cadena de conexión de SQL Server o Azure SQL para ADO.NET (Microsoft.Data.SqlClient), ODBC Driver 18, JDBC, Go y SQLAlchemy desde un solo formulario, o pega una para ver qué hace cada palabra clave y qué es arriesgado. Todo se ejecuta en tu navegador: nada de lo que escribas se envía a ningún lugar.
Abrir esta conexión en SQLly
Abre el editor de conexiones de SQLly con los datos ya rellenados.
Abrir esta conexión en SQLly
Privado por diseño. El constructor y el decodificador son JavaScript puro que se ejecuta en esta pestaña. La página no envía ninguna solicitud con lo que escribes, no almacena nada (ni siquiera en tu navegador) y sigue funcionando sin conexión una vez cargada. El enlace Abrir en SQLly va directamente desde tu navegador a la aplicación en tu computadora.
Formatos de cadenas de conexión de SQL Server
Los controladores de SQL Server comparten el estilo keyword=valor, pero no las palabras clave: ADO.NET dice User ID y Connect Timeout, ODBC dice Uid y ConnectTimeout, JDBC dice user y loginTimeout, y Go usa una URL. También comparten una trampa: un puerto va después de una coma (host,1433), no de dos puntos, en todas partes salvo en JDBC y Go.
Lo otro que confunde a la gente es el cifrado. Microsoft.Data.SqlClient 4.0, ODBC Driver 18 y JDBC Driver 10.2 cifran por defecto y validan el certificado del servidor, así que cadenas de conexión que llevaban años funcionando empezaron a fallar tras una actualización. El constructor indica Encrypt explícitamente, y el decodificador te dice qué Encrypt significa para cada controlador.
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 para 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 Driver para 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
URL de SQLAlchemy Python SQLAlchemy con pyodbc
mssql+pyodbc://app_user:[email protected]/Sales?driver=ODBC+Driver+18+for+SQL+Server&Encrypt=yes
Autenticación de Windows (ADO.NET) Seguridad integrada
Server=sql01.example.com;Database=Sales;Integrated Security=True;Encrypt=True;
Azure SQL con Microsoft Entra ID (ADO.NET) Identidad administrada, Azure CLI o inicio de sesión en Visual Studio
Server=myserver.database.windows.net;Database=Sales;Authentication=Active Directory Default;Encrypt=True;
Los marcadores de posición como your_password son eso mismo: construye tu propia cadena con el formulario de arriba. Más sobre cómo conectar SQLly a SQL Server: SQLly para SQL Server.
Palabras clave de Microsoft.Data.SqlClient (ADO.NET)
Las palabras clave no distinguen entre mayúsculas y minúsculas, se ignoran los espacios a su alrededor, y cuando una palabra clave (o uno de sus sinónimos) aparece dos veces, prevalece el último valor. Una palabra clave desconocida genera Keyword not supported. Entrecomilla un valor en " o ' cuando contiene ;, o empieza o termina con un espacio o una comilla; dentro de las comillas, dobla el carácter de comilla.
| Palabra clave | Sinónimos | Predeterminado | Lo que hace |
|---|---|---|---|
Server |
Data Source, Address, Addr, Network Address | - | host, host\instance, host,port, o tcp:host,port. . y (local) significa esta máquina; (localdb)\MSSQLLocalDB es LocalDB. Una instancia con nombre se encuentra mediante SQL Server Browser en UDP 1434. |
Database |
Initial Catalog | la base de datos predeterminada del inicio de sesión | Base de datos a usar una vez conectado. |
User ID |
UID, Usuario | - | Inicio de sesión SQL, o el nombre de usuario de Entra para Active Directory Password / Interactive. |
Password |
PWD | - | Se ignora cuando Integrated Security está activado. |
Integrated Security |
Trusted_Connection | falso | true, yes o sspi inicia sesión como la cuenta de Windows que ejecuta el proceso (Kerberos o NTLM). |
Authentication |
- | no establecido | 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 (obsoleto). Desde la versión 7.0, los métodos de Entra necesitan el Microsoft.Data.SqlClient.Extensions.Azure paquete. |
Encrypt |
- | true (Obligatorio) en 4.0+; false en 3.x y anteriores |
true/yes/Mandatory, false/no/Optional, o Strict (5.x+, TDS 8.0: SQL Server 2022+ y Azure SQL). Con Optional el paquete de inicio de sesión sigue estando cifrado, el resto no. |
TrustServerCertificate |
Confiar en el certificado del servidor | falso | true omite la validación del certificado. Ignorado (tratado como falso) con Encrypt=Strict. |
HostNameInCertificate |
Nombre de host en el certificado | - | 5.0+. El nombre que se espera en el certificado del servidor cuando difiere de Server, por ejemplo, cuando te conectas mediante un alias o una dirección IP. |
ServerCertificate |
Certificado del servidor | - | 5.1+. Ruta del archivo de certificado con el que debe coincidir exactamente el certificado del servidor. |
Connect Timeout |
Tiempo de espera de conexión, Timeout | 15 | Segundos para esperar una conexión antes de fallar. |
Command Timeout |
- | 30 | 2.1+. Predeterminado SqlCommand.CommandTimeout en segundos; 0 espera indefinidamente. |
Application Name |
Aplicación | Core Microsoft SqlClient Data Provider (.NET) |
Se muestra como program_name en sys.dm_exec_sessions y en Profiler / Eventos extendidos. |
ApplicationIntent |
Intención de la aplicación | Lectura/Escritura | ReadOnly ruta hacia un secundario legible de un grupo de disponibilidad o una réplica de lectura en Azure SQL. |
MultiSubnetFailover |
Conmutación por error en múltiples subredes | falso | Configúralo en true al conectarte a un listener de grupo de disponibilidad que abarca subredes, para una conmutación por error más rápida. |
MultipleActiveResultSets |
Conjuntos de resultados activos múltiples | falso | MARS: varios lectores abiertos en una conexión. |
Pooling |
- | verdadero | Agrupación de conexiones. |
Max Pool Size |
- | 100 | Número máximo de conexiones agrupadas por cadena de conexión distinta. |
Min Pool Size |
- | 0 | Conexiones que se mantienen abiertas en el grupo. |
ConnectRetryCount |
Número de reintentos de conexión | 1 | 0 a 255 intentos de reconexión después de que se cae una conexión inactiva. |
ConnectRetryInterval |
Intervalo de reintento de conexión | 10 | 1 a 60 segundos entre esos intentos. |
Persist Security Info |
PersistSecurityInfo | falso | true deja la contraseña legible en ConnectionString después de abrirla. Déjalo desactivado. |
Palabras clave del controlador ODBC 18 para SQL Server
Usado por pyodbc, R, PHP, Excel y cualquier otra herramienta que use ODBC. Encierra los valores que contengan caracteres especiales ([]{}(),;?*=!@) entre llaves. A diferencia de ADO.NET, si se repite una palabra clave, gana la primera aparición.
| Palabra clave | Sinónimos | Predeterminado | Lo que hace |
|---|---|---|---|
Driver |
- | - | {ODBC Driver 18 for SQL Server} (o 17). Debe coincidir con el nombre que lista el administrador de controladores. |
Server |
Dirección, Dir | - | [tcp:]host[\instance][,port]. |
Database |
- | inicio de sesión predeterminado | Nombre de la base de datos. |
UID / PWD |
- | - | Inicio de sesión y contraseña de SQL. |
Trusted_Connection |
- | no | yes usa autenticación de Windows. |
Authentication |
- | - | SqlPassword, ActiveDirectoryIntegrated, ActiveDirectoryInteractive (Windows), ActiveDirectoryMsi, ActiveDirectoryServicePrincipal, ActiveDirectoryPassword (obsoleto). No hay ActiveDirectoryDefault en ODBC. |
Encrypt |
- | sí (Controlador 18), no (17 y anteriores) | yes/mandatory, no/optional, strict (18.1.2.1+). |
TrustServerCertificate |
- | no | yes omite la validación del certificado; se ignora con Encrypt=strict. |
HostnameInCertificate |
- | - | 18.0+. Nombre de host esperado en el certificado. |
ServerCertificate |
- | - | 18.1+. Archivo de certificado con el que debe coincidir el certificado del servidor. |
ConnectTimeout |
- | 15 | 18.7+. Tiempo de espera de inicio de sesión en segundos; 0 significa sin límite. Los controladores antiguos solo aceptan SQL_ATTR_LOGIN_TIMEOUT desde el código. |
APP |
- | - | Nombre de la aplicación. |
ApplicationIntent |
- | Lectura/Escritura | ReadOnly para secundarios legibles. |
MultiSubnetFailover |
- | No | Yes para grupos de disponibilidad de múltiples subredes. |
Propiedades del controlador JDBC de Microsoft para SQL Server
Formato de URL: jdbc:sqlserver://[serverName[\instanceName][:portNumber]][;property=value...]. Los nombres de las propiedades no distinguen mayúsculas de minúsculas. Un valor que contiene ; va entre llaves, y desde el controlador 8.4 una llave de cierre dentro de llaves se duplica: password={pass;}}word}.
| Palabra clave | Sinónimos | Predeterminado | Lo que hace |
|---|---|---|---|
databaseName |
base de datos | - | Nombre de la base de datos. |
user |
userName | - | Nombre de inicio de sesión. |
password |
- | - | Contraseña. |
integratedSecurity |
- | falso | Autenticación de Windows. En Windows se necesita mssql-jdbc_auth-<version>.dll; en otros lugares, añade authenticationScheme=JavaKerberos. |
authentication |
- | NotSpecified | SqlPassword, ActiveDirectoryPassword, ActiveDirectoryIntegrated, ActiveDirectoryInteractive (9.2+), ActiveDirectoryServicePrincipal (9.2+), ActiveDirectoryManagedIdentity (12.2+; ActiveDirectoryMSI antes). |
encrypt |
- | true (10.2+); false (9.4 y anteriores) | true, false, o strict (11.2+). |
trustServerCertificate |
- | falso | true omite la validación del certificado. |
hostNameInCertificate |
- | - | Nombre de host esperado en el certificado. |
serverCertificate |
- | - | 11.2+. Archivo de certificado con el que debe coincidir; se usa con strict. |
loginTimeout |
- | 30 (11.2+), 15 (anteriores) | Segundos de espera por el inicio de sesión. |
queryTimeout |
- | -1 (sin límite) | Tiempo de espera predeterminado de la consulta en segundos. |
applicationName |
- | Microsoft JDBC Driver para SQL Server | Nombre de la aplicación. |
applicationIntent |
- | Lectura/Escritura | ReadOnly para secundarios legibles. |
multiSubnetFailover |
- | falso | Grupos de disponibilidad de múltiples subredes. |
instanceName |
- | - | Instancia con nombre, como alternativa a host\instance en la URL. |
parámetros de URL de go-mssqldb
Formato de URL: sqlserver://user:password@host:port?database=... o sqlserver://user:password@host/instance?.... El path es el nombre de la instancia, nunca el de la base de datos. Aplica codificación porcentual a los caracteres especiales del usuario y la contraseña. Los nombres de los parámetros no distinguen mayúsculas de minúsculas.
| Palabra clave | Sinónimos | Predeterminado | Lo que hace |
|---|---|---|---|
database |
- | - | Nombre de la base de datos. |
encrypt |
- | falso (solo paquete de inicio de sesión) | strict, disable (sin TLS en absoluto), false, true. Fíjate en que el valor predeterminado no coincide con el de los propios controladores de Microsoft. |
TrustServerCertificate |
- | falso cuando encrypt está activado, verdadero cuando no lo está | true omite la validación del certificado. |
app name |
- | go-mssqldb | Nombre de la aplicación (escríbelo app+name o app%20name en la URL). |
connection timeout |
- | 0 (ninguno) | Segundos para toda la conexión. |
dial timeout |
- | 15 por protocolo registrado | Segundos para establecer la conexión TCP. |
fedauth |
- | - | Métodos de Entra (ActiveDirectoryDefault, ActiveDirectoryManagedIdentity, ActiveDirectoryPassword, ...) con el azuread paquete y el azuresql nombre del controlador. |
Errores comunes de conexión a SQL Server
The certificate chain was issued by an authority that is not trusted.
Por qué: Microsoft.Data.SqlClient 4.0+, ODBC Driver 18 y JDBC 10.2+ cifran por defecto y validan el certificado del servidor. El servidor está usando su certificado autofirmado generado automáticamente, o un certificado de una CA privada en la que tu máquina no confía.
Solución: Instala un certificado de una CA confiable en el servidor (o confía en tu CA interna en el cliente). Si el certificado es válido pero para otro nombre, establece HostNameInCertificate. Solo para un servidor de desarrollo local, TrustServerCertificate=True te pone en marcha.
Login failed for user 'app_user'. (Error 18456)
Por qué: Contraseña incorrecta, un inicio de sesión de SQL en un servidor que solo permite autenticación de Windows, un inicio de sesión deshabilitado o una base de datos predeterminada que el inicio de sesión no puede abrir. El registro del servidor anota la razón real como un número de estado.
Solución: Verifica la contraseña, habilita el modo de Autenticación de SQL Server y Windows si usas inicios de sesión de SQL, y establece Database en uno que el inicio de sesión pueda abrir. El estado en el registro de errores del servidor (por ejemplo, Estado 8 = contraseña incorrecta, Estado 38 = base de datos no disponible) lo indica.
Keyword not supported: 'host'.
Por qué: Microsoft.Data.SqlClient solo acepta sus propias palabras clave. Host, Username y Port son palabras clave de Npgsql/MySQL; Provider= pertenece a las cadenas de conexión OLE DB; un error tipográfico como Databse falla de la misma manera.
Solución: Usar Server, User ID, y host,port. Pega la cadena en el decodificador de arriba: cada palabra clave desconocida queda marcada.
Format of the initialization string does not conform to specification starting at index 42.
Por qué: Un valor contiene ; o una comilla y no estaba entre comillas, así que el analizador divide la cadena donde no debe. Las contraseñas son el caso típico.
Solución: Envuelve el valor entre comillas dobles y duplica cualquier comilla doble que contenga: Password="p;a""ss". El generador escapa los valores por ti.
The target principal name is incorrect. Cannot generate SSPI context.
Por qué: La seguridad integrada utiliza Kerberos, y el nombre principal del servicio (SPN) para el servicio de SQL Server falta, está duplicado o registrado para otra cuenta, o te conectaste mediante dirección IP o alias.
Solución: Conéctate con el nombre totalmente calificado del servidor y haz que un administrador registre el SPN (setspn -L <service account> los lista). Con una discrepancia en el nombre del certificado, también verifica HostNameInCertificate.
FAQ de las cadenas de conexión de SQL Server
¿Cuál es el puerto predeterminado de SQL Server?
1433 para la instancia predeterminada. Las instancias con nombre generalmente usan un puerto dinámico que SQL Server Browser (UDP 1434) comunica al cliente, por lo que host\instance funciona sin puerto. En ADO.NET y ODBC el puerto va después de una coma: Server=host,1433.
¿Debo usar Encrypt=True o TrustServerCertificate=True?
Usar Encrypt=True (o Strict en SQL Server 2022 y Azure SQL) con un certificado en el que confíen tus clientes. TrustServerCertificate=True mantiene el tráfico cifrado, pero impide que el cliente verifique con quién está hablando, así que cualquiera que pueda interceptar la conexión puede suplantar al servidor. Resérvalo para desarrollo local.
¿Qué cambió con Encrypt en Microsoft.Data.SqlClient 4.0?
El valor predeterminado para Encrypt cambió de false a true, y el controlador valida el certificado del servidor por defecto. ODBC Driver 18 y JDBC Driver 10.2 hicieron el mismo cambio. Las cadenas sin un Encrypt palabra clave que antes se conectaban sin TLS ahora necesitan un certificado confiable en el servidor.
¿Cómo me conecto a Azure SQL Database con Microsoft Entra ID?
Añadir Authentication=Active Directory Default (toma una identidad administrada, las credenciales del entorno o tu inicio de sesión de Azure CLI / Visual Studio) y omite la contraseña. Usa Active Directory Managed Identity en aplicaciones alojadas en Azure y Active Directory Interactive para un inicio de sesión en el navegador. Azure SQL no acepta Integrated Security=SSPI.
¿Cuál es la diferencia entre Data Source y Server, o Initial Catalog y Database?
Ninguna. Son sinónimos en Microsoft.Data.SqlClient, al igual que User ID / UID / User y Password / PWD. Si aparecen las dos formas, gana la última.
¿Usa System.Data.SqlClient la misma cadena de conexión?
En su mayoría. Acepta las palabras clave clásicas pero no las más recientes como Command Timeout, Encrypt=Strict, HostNameInCertificate o la mayoría de los valores de Authentication valores, y por defecto usa Encrypt=False. Microsoft recomienda migrar a Microsoft.Data.SqlClient.
Otros motores
- Cadenas de conexión de PostgreSQL
- Cadenas de conexión de MySQL
- Cadenas de conexión de MariaDB
- Cadenas de conexión de SQLite
- Cadenas de conexión de Oracle
- Cadenas de conexión de Redis
- Cadenas de conexión de ClickHouse
- Cadenas de conexión de DuckDB
- Cadenas de conexión de libSQL
- Todos los motores y formatos
- Formateador SQL
- Todas las herramientas gratuitas
Conéctate una vez. Luego solo escribe SQL.
SQLly es un entorno de trabajo SQL nativo para macOS, Windows y Linux. Pega una cadena de conexión en su editor de conexiones, guarda las contraseñas en el llavero del sistema y obtén IntelliSense que entiende el esquema en SQL Server, entre otros.