Конструктор строк подключения SQL Server
Создавайте строку подключения SQL Server или Azure SQL для ADO.NET (Microsoft.Data.SqlClient), ODBC Driver 18, JDBC, Go и SQLAlchemy в одной форме или вставьте готовую, чтобы увидеть, что делает каждое ключевое слово и что здесь рискованно. Всё работает в вашем браузере: ничего из того, что вы вводите, никуда не отправляется.
Открыть это подключение в SQLly
Открывает редактор подключений SQLly с заполненными полями.
Открыть это подключение в SQLly
Приватность на уровне архитектуры. Конструктор и декодер — обычный JavaScript, работающий в этой вкладке. Страница никуда не отправляет то, что вы вводите, ничего не хранит (даже в вашем браузере) и продолжает работать офлайн после загрузки. Ссылка «Открыть в SQLly» ведёт из вашего браузера прямо в приложение на вашем компьютере.
Форматы строк подключения SQL Server
Драйверы SQL Server используют один формат «ключ=значение», но ключи у них разные: ADO.NET пишет User ID и Connect Timeout, у ODBC — Uid и ConnectTimeout, у JDBC — user и loginTimeout, а Go использует URL. У них одна общая ловушка: порт идёт после запятой (host,1433), а не двоеточие, везде, кроме JDBC и Go.
Ещё одно место, на котором все спотыкаются, — шифрование. Microsoft.Data.SqlClient 4.0, ODBC Driver 18 и JDBC Driver 10.2 по умолчанию шифруют подключение и проверяют сертификат сервера, поэтому строки подключения, работавшие годами, начали ломаться после обновления. Конструктор прямо указывает Encrypt , а декодер показывает, что означает неустановленное значение Encrypt означает для каждого драйвера.
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-драйвер 18 для 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-драйвер для 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 с pyodbc
mssql+pyodbc://app_user:[email protected]/Sales?driver=ODBC+Driver+18+for+SQL+Server&Encrypt=yes
Аутентификация Windows (ADO.NET) Интегрированная безопасность
Server=sql01.example.com;Database=Sales;Integrated Security=True;Encrypt=True;
Azure SQL с Microsoft Entra ID (ADO.NET) Управляемое удостоверение, вход через Azure CLI или Visual Studio
Server=myserver.database.windows.net;Database=Sales;Authentication=Active Directory Default;Encrypt=True;
Заполнители, такие как your_password — это лишь примеры: соберите свою строку в форме выше. Подробнее о подключении SQLly к SQL Server: SQLly для SQL Server.
Ключевые слова Microsoft.Data.SqlClient (ADO.NET)
Ключевые слова не зависят от регистра, пробелы вокруг них игнорируются, и если ключевое слово (или одно из его синонимов) встречается дважды, побеждает последнее значение. Неизвестное ключевое слово вызывает ошибку Keyword not supported. Заключите значение в " или ' если оно содержит ;, или начинается или заканчивается пробелом или кавычкой; внутри кавычек удвойте символ кавычки.
| Ключевое слово | Синонимы | По умолчанию | Что оно делает |
|---|---|---|---|
Server |
Data Source, Address, Addr, Network Address | - | host, host\instance, host,port, или tcp:host,port. . и (local) означают этот компьютер; (localdb)\MSSQLLocalDB — это LocalDB. Именованный экземпляр находится через SQL Server Browser на UDP 1434. |
Database |
Initial Catalog | база данных по умолчанию для логина | База данных для использования после подключения. |
User ID |
UID, Пользователь | - | Имя входа SQL или имя пользователя Entra для Active Directory Password / Interactive. |
Password |
PWD | - | Игнорируется, когда Integrated Security включено. |
Integrated Security |
Trusted_Connection | ложь | true, yes или sspi выполняет вход от учётной записи Windows, от имени которой работает процесс (Kerberos или NTLM). |
Authentication |
- | не установлено | Sql Password, Active Directory Integrated, Active Directory Interactive, Active Directory Default, Active Directory Managed Identity (псевдоним Active Directory MSI), Active Directory Service Principal, Active Directory Device Code Flow, Active Directory Workload Identity (5.2+), Active Directory Password (устаревший). С версии 7.0 методы Entra требуют Microsoft.Data.SqlClient.Extensions.Azure пакет. |
Encrypt |
- | true (Обязательно) в 4.0+; false в 3.x и ранее |
true/yes/Mandatory, false/no/Optional, или Strict (5.x+, TDS 8.0: SQL Server 2022+ и Azure SQL). С Optional пакет входа всё ещё зашифрован, остальное — нет. |
TrustServerCertificate |
Доверять сертификату сервера | ложь | true пропускает проверку сертификата. Игнорируется (расценивается как false) с Encrypt=Strict. |
HostNameInCertificate |
Имя хоста в сертификате | - | 5.0+. Имя, которое ожидается в сертификате сервера, когда оно отличается от Server, например, при подключении через алиас или IP-адрес. |
ServerCertificate |
Серверный сертификат | - | 5.1+. Путь к файлу сертификата, с которым должен совпасть серверный сертификат. |
Connect Timeout |
Тайм-аут подключения, Тайм-аут | 15 | Количество секунд ожидания подключения перед ошибкой. |
Command Timeout |
- | 30 | 2.1+. По умолчанию SqlCommand.CommandTimeout в секундах; 0 — ждать бесконечно. |
Application Name |
Приложение | Core Microsoft SqlClient Data Provider (.NET) |
Отображается как program_name в sys.dm_exec_sessions и в Profiler / Расширенных событиях. |
ApplicationIntent |
Назначение приложения | Чтение/запись | ReadOnly маршрутизируется на читаемую вторичную реплику группы доступности или реплику чтения в Azure SQL. |
MultiSubnetFailover |
Переключение между несколькими подсетями | ложь | Установить true при подключении к прослушивателю группы доступности, охватывающему несколько подсетей, для более быстрой отработки отказа. |
MultipleActiveResultSets |
Несколько активных наборов результатов | ложь | MARS: несколько открытых объектов чтения на одном соединении. |
Pooling |
- | истина | Пул подключений. |
Max Pool Size |
- | 100 | Наибольшее количество соединений в пуле для каждой отдельной строки подключения. |
Min Pool Size |
- | 0 | Подключения, удерживаемые открытыми в пуле. |
ConnectRetryCount |
Количество повторных попыток подключения | 1 | От 0 до 255 попыток переподключения после разрыва неактивного соединения. |
ConnectRetryInterval |
Интервал повторного подключения | 10 | От 1 до 60 секунд между этими попытками. |
Persist Security Info |
PersistSecurityInfo | ложь | true оставляет пароль открытым текстом в ConnectionString после открытия. Оставьте его выключенным. |
Ключевые слова ODBC Driver 18 for SQL Server
Используется pyodbc, R, PHP, Excel и всем остальным, что работает через ODBC. Заключайте значения, которые содержат специальные символы ([]{}(),;?*=!@) в фигурных скобках. В отличие от ADO.NET, при повторении ключевого слова выигрывает первое вхождение.
| Ключевое слово | Синонимы | По умолчанию | Что оно делает |
|---|---|---|---|
Driver |
- | - | {ODBC Driver 18 for SQL Server} (или 17). Должно соответствовать имени, указанному в диспетчере драйверов. |
Server |
Адрес, Addr | - | [tcp:]host[\instance][,port]. |
Database |
- | база по умолчанию логина | Имя базы данных. |
UID / PWD |
- | - | Имя входа SQL и пароль. |
Trusted_Connection |
- | нет | yes использует аутентификацию Windows. |
Authentication |
- | - | SqlPassword, ActiveDirectoryIntegrated, ActiveDirectoryInteractive (Windows), ActiveDirectoryMsi, ActiveDirectoryServicePrincipal, ActiveDirectoryPassword (устарело). Нет ActiveDirectoryDefault в ODBC. |
Encrypt |
- | да (драйвер 18), нет (17 и старше) | yes/mandatory, no/optional, strict (18.1.2.1+). |
TrustServerCertificate |
- | нет | yes пропускает проверку сертификата; игнорируется с Encrypt=strict. |
HostnameInCertificate |
- | - | 18.0+. Ожидаемое имя хоста в сертификате. |
ServerCertificate |
- | - | 18.1+. Файл сертификата, с которым должен совпадать серверный сертификат. |
ConnectTimeout |
- | 15 | 18.7+. Тайм-аут входа в секундах; 0 — без ограничения. Старые драйверы принимают только SQL_ATTR_LOGIN_TIMEOUT из кода. |
APP |
- | - | Имя приложения. |
ApplicationIntent |
- | Чтение/запись | ReadOnly для читаемых вторичных реплик. |
MultiSubnetFailover |
- | Нет | Yes для групп доступности с несколькими подсетями. |
Свойства драйвера Microsoft JDBC для SQL Server
Формат URL: jdbc:sqlserver://[serverName[\instanceName][:portNumber]][;property=value...]. Имена свойств нечувствительны к регистру. Значение, содержащее ; размещается в фигурных скобках, а с драйвера 8.4 закрывающая скобка внутри скобок дублируется: password={pass;}}word}.
| Ключевое слово | Синонимы | По умолчанию | Что оно делает |
|---|---|---|---|
databaseName |
база данных | - | Имя базы данных. |
user |
userName | - | Имя входа. |
password |
- | - | Пароль. |
integratedSecurity |
- | ложь | Аутентификация Windows. В Windows она требует mssql-jdbc_auth-<version>.dll; в других местах добавьте authenticationScheme=JavaKerberos. |
authentication |
- | НеУказано | SqlPassword, ActiveDirectoryPassword, ActiveDirectoryIntegrated, ActiveDirectoryInteractive (9.2+), ActiveDirectoryServicePrincipal (9.2+), ActiveDirectoryManagedIdentity (12.2+; ActiveDirectoryMSI перед этим). |
encrypt |
- | true (10.2+); false (9.4 и старше) | true, false, или strict (11.2+). |
trustServerCertificate |
- | ложь | true пропускает проверку сертификата. |
hostNameInCertificate |
- | - | Ожидаемое имя хоста сертификата. |
serverCertificate |
- | - | 11.2+. Файл сертификата для сверки, используется с strict. |
loginTimeout |
- | 30 (11.2+), 15 (более ранние версии) | Секунды ожидания при входе. |
queryTimeout |
- | -1 (без ограничения) | Тайм-аут запроса по умолчанию в секундах. |
applicationName |
- | Microsoft JDBC-драйвер для SQL Server | Имя приложения. |
applicationIntent |
- | Чтение/запись | ReadOnly для читаемых вторичных реплик. |
multiSubnetFailover |
- | ложь | Группы доступности с несколькими подсетями. |
instanceName |
- | - | Именованный экземпляр, как альтернатива host\instance в URL. |
Параметры URL go-mssqldb
Формат URL: sqlserver://user:password@host:port?database=... или sqlserver://user:password@host/instance?.... Путь — это имя экземпляра, а не базы данных. Кодируйте специальные символы в имени пользователя и пароле с помощью процентного кодирования. Имена параметров не чувствительны к регистру.
| Ключевое слово | Синонимы | По умолчанию | Что оно делает |
|---|---|---|---|
database |
- | - | Имя базы данных. |
encrypt |
- | false (только пакет входа) | strict, disable (вообще без TLS), false, true. Обратите внимание: значение по умолчанию отличается от собственных драйверов Microsoft. |
TrustServerCertificate |
- | false, когда установлено шифрование, true, когда не установлено | true пропускает проверку сертификата. |
app name |
- | go-mssqldb | Имя приложения (укажите его app+name или app%20name в URL). |
connection timeout |
- | 0 (нет) | Секунды на всё соединение. |
dial timeout |
- | по 15 на каждый зарегистрированный протокол | Секунды на установку TCP-соединения. |
fedauth |
- | - | Методы Entra (ActiveDirectoryDefault, ActiveDirectoryManagedIdentity, ActiveDirectoryPassword, ...) с azuread пакет и azuresql имя драйвера. |
Распространённые ошибки подключения к SQL Server
The certificate chain was issued by an authority that is not trusted.
Почему: Microsoft.Data.SqlClient 4.0+, драйвер ODBC 18 и JDBC 10.2+ по умолчанию используют шифрование и проверяют сертификат сервера. Сервер использует свой автоматически сгенерированный самоподписанный сертификат или сертификат от частного удостоверяющего центра, которому ваш компьютер не доверяет.
Исправлено: Установите на сервере сертификат от доверенного УЦ (или настройте доверие к своему внутреннему УЦ на клиенте). Если сертификат действителен, но выдан на другое имя, задайте HostNameInCertificate. Только для локального сервера разработки, TrustServerCertificate=True позволяет вам начать работу.
Login failed for user 'app_user'. (Error 18456)
Почему: Неправильный пароль, SQL-логин на сервере, который разрешает только аутентификацию Windows, отключённый логин или база данных по умолчанию, которую логин не может открыть. Журнал сервера фиксирует настоящую причину в виде номера состояния.
Исправлено: Проверьте пароль, включите режим аутентификации SQL Server и Windows, если используете SQL-логины, и задайте Database к базе, которую логин может открыть. Состояние в журнале ошибок сервера (например, State 8 = неверный пароль, State 38 = база недоступна) точно указывает причину.
Keyword not supported: 'host'.
Почему: Microsoft.Data.SqlClient принимает только свои собственные ключевые слова. Host, Username и Port являются ключевыми словами Npgsql/MySQL; Provider= относится к строкам подключения OLE DB; опечатка вроде Databse приводит к той же ошибке.
Исправлено: Используйте Server, User ID, и host,port. Вставьте строку в декодер выше: каждое незнакомое ключевое слово помечается.
Format of the initialization string does not conform to specification starting at index 42.
Почему: Значение содержит ; или кавычку, и не было взято в кавычки, поэтому парсер режет строку не в том месте. Чаще всего виноваты пароли.
Исправлено: Заключите значение в двойные кавычки и удвойте любую двойную кавычку внутри: Password="p;a""ss". Конструктор экранирует значения за вас.
The target principal name is incorrect. Cannot generate SSPI context.
Почему: Встроенная безопасность использует Kerberos, а имя субъекта-службы (SPN) для службы SQL Server отсутствует, дублируется или зарегистрировано для другой учётной записи, либо вы подключились по IP-адресу или псевдониму.
Исправлено: Подключайтесь, используя полное доменное имя сервера, и попросите администратора зарегистрировать SPN (setspn -L <service account> перечисляет их). В случае несоответствия имени сертификата также проверьте HostNameInCertificate.
FAQ по строкам подключения SQL Server
Какой порт по умолчанию для SQL Server?
1433 для стандартного экземпляра. Именованные экземпляры обычно используют динамический порт, о котором клиенту сообщает SQL Server Browser (UDP 1434), поэтому host\instance работает без порта. В ADO.NET и ODBC порт указывается после запятой: Server=host,1433.
Стоит ли использовать Encrypt=True или TrustServerCertificate=True?
Используйте Encrypt=True (или Strict на SQL Server 2022 и Azure SQL) с сертификатом, которому доверяют ваши клиенты. TrustServerCertificate=True оставляет трафик зашифрованным, но клиент перестаёт проверять, с кем он говорит, так что любой, кто может перехватить подключение, может выдать себя за сервер. Оставляйте этот вариант для локальной разработки.
Что изменилось с Encrypt в Microsoft.Data.SqlClient 4.0?
Значение по умолчанию для Encrypt было изменено с false в true, и драйвер по умолчанию проверяет сертификат сервера. Драйвер ODBC 18 и драйвер JDBC 10.2 внесли то же изменение. Строки без ключевого слова Encrypt которые раньше подключались без TLS, теперь требуют доверенного сертификата на сервере.
Как подключиться к Azure SQL Database с Microsoft Entra ID?
Добавить Authentication=Active Directory Default (использует управляемое удостоверение, учётные данные среды или ваш вход в Azure CLI / Visual Studio) и не указывайте пароль. Используйте Active Directory Managed Identity в приложениях, размещенных в Azure, и Active Directory Interactive для входа через браузер. Azure SQL не принимает Integrated Security=SSPI.
Какая разница между Data Source и Server, или Initial Catalog и Database?
Нет. Это синонимы в Microsoft.Data.SqlClient, так же как и User ID / UID / User и Password / PWD. Если встречаются оба варианта написания, выигрывает последний.
Использует ли System.Data.SqlClient ту же строку подключения?
В основном да. Классические ключевые слова принимает, но не новые, такие как Command Timeout, Encrypt=Strict, HostNameInCertificate или большинство Authentication значений, а по умолчанию Encrypt=False. Microsoft рекомендует перейти на Microsoft.Data.SqlClient.
Другие движки
- Строки подключения к PostgreSQL
- Строки подключения к MySQL
- Строки подключения к MariaDB
- Строки подключения к SQLite
- Строки подключения к Oracle
- Строки подключения Redis
- Строки подключения ClickHouse
- Строки подключения DuckDB
- Строки подключения libSQL
- Все движки и форматы
- Форматировщик SQL
- Все бесплатные инструменты
Подключитесь один раз. А потом просто пишите SQL.
SQLly — это нативная рабочая среда SQL для macOS, Windows и Linux. Вставьте строку подключения в её редактор подключений, храните пароли в системной связке ключей и получайте IntelliSense с учётом схемы для SQL Server и других баз данных.