// бесплатный инструмент

Конструктор и декодер строк подключения

Заполните форму и получите строку подключения во всех форматах, которые используют ваши драйверы, — ADO.NET, JDBC, ODBC, URL-адреса, libpq, DSN для Go и другие — рядом. Или вставьте готовую строку и узнайте, за что отвечает каждый ключ и какие значения рискованны. Всё работает в вашем браузере: ничего из того, что вы вводите, никуда не отправляется.

Открыть это подключение в SQLly

Открывает редактор подключений SQLly с заполненными полями.

Приватность на уровне архитектуры. Конструктор и декодер — обычный JavaScript, работающий в этой вкладке. Страница никуда не отправляет то, что вы вводите, ничего не хранит (даже в вашем браузере) и продолжает работать офлайн после загрузки. Ссылка «Открыть в SQLly» ведёт из вашего браузера прямо в приложение на вашем компьютере.

Форматы строк подключения и как их экранировать

Большинство ошибок в строках подключения связаны с экранированием: пароль с @, ; или кавычка, которую драйвер разделяет в неправильном месте. У каждого формата есть своё правило.

ФорматВыглядит какСпециальные символы
URL / URIpostgresql://user:pass@host:5432/db?sslmode=verify-fullПроцентное кодирование зарезервированных символов в имени пользователя, пароле и базе данных: @ → %40, : → %3A, / → %2F, ? → %3F, # → %23, % → %25, пробел → %20.
ADO.NETServer=host;Database=db;User ID=u;Password=p;Заключите значение в ;, ведущий или конечный пробел, или ведущую кавычку в "…" (или '…'), и удвойте кавычку внутри: Password="a;b""c".
ODBCDriver={ODBC Driver 18 for SQL Server};Server=host;Pwd={p;w};Заключите значение в фигурные скобки. Имена драйверов всегда заключаются в них.
JDBCjdbc:sqlserver://host;databaseName=db, jdbc:postgresql://host/db?user=uЗависит от поставщика. Microsoft: фигурные скобки, с } удвоено. PostgreSQL, MySQL, MariaDB: URL-запрос, поэтому используйте процентное кодирование.
ключ/значение libpqhost=h dbname=db user=u password='a b'Заключайте в одинарные кавычки пустые значения и значения с пробелами; пишите \' и \\ для кавычки или обратной косой черты.
Go MySQL DSNuser:pass@tcp(host:3306)/db?tls=trueПароль не требует экранирования; значения параметров экранируются для URL; имена параметров чувствительны к регистру.
StackExchange.Redishost:6380,password=p,ssl=trueЗапятые разделяют параметры, поэтому пароль с запятой приходится задавать в коде.
Oracle Easy Connecthost:1521/service_nameУчётных данных внутри нет; имя пользователя и пароль передаются отдельно.

Что проверяет декодер

  • Проверка сертификатов отключена. TrustServerCertificate=true, sslmode=require, tls=skip-verify, sslMode=trust и pgJDBC NonValidatingFactory все шифруют без проверки, кто ответил.
  • Нет TLS или TLS с возможностью отката. sslmode=disable или prefer, Encrypt=False, ssl-mode=DISABLED, redis:// с паролем, обычный HTTP для ClickHouse.
  • Значения по умолчанию, которые изменились. Нет Encrypt означает шифрование и проверку в Microsoft.Data.SqlClient 4.0+, драйвере ODBC 18 и JDBC 10.2+, но не в старых драйверах или go-mssqldb.
  • Секреты в строке. Пароли в открытом виде и токены аутентификации, Persist Security Info=True, токены Turso, срок действия которых истёк.
  • Опечатки и заимствованные ключевые слова. Неизвестные ключи для обнаруженного драйвера, host:port где SQL Server ожидает host,portчувствительные к регистру параметры Go, неэкранированные @ в паролях URL, Oracle SID там, где нужно имя службы.
  • Как SQLly это читает. Декодер применяет те же правила, что и собственный разбор строки подключения в приложении SQLly, так что вы заранее знаете, что заполнит приложение.

Часто задаваемые вопросы о строках подключения

Отправляется ли моя строка подключения куда-либо?

Нет. Конструктор и декодер — это JavaScript, который работает в вашей вкладке браузера. Всё, что вы вводите или вставляете, никуда не отправляется, не логируется и не сохраняется — даже в хранилище браузера, а после загрузки страница продолжает работать и без сети.

Какие базы данных и драйверы поддерживаются?

SQL Server и Azure SQL, PostgreSQL, MySQL, MariaDB, SQLite, Oracle, Redis и Valkey, ClickHouse, DuckDB и libSQL / Turso. Для каждого движка он выдаёт те форматы, которые для него реально существуют: URL, ADO.NET, JDBC, ODBC, строки «ключ=значение» libpq, DSN для Go, URL SQLAlchemy, строки StackExchange.Redis, дескрипторы Oracle Easy Connect и TNS, а также готовый к вставке код для Python и Node.js.

Как использовать специальные символы в пароле?

Это зависит от формата. В URL кодируйте их процентной записью: @ становится %40, : становится %3A, / становится %2F, % становится %25. В строке ADO.NET значение, содержащее ; или кавычку, в двойные кавычки и удвойте любые двойные кавычки внутри. В ODBC и JDBC-драйвере Microsoft оберните его в фигурные скобки {...} и удваивайте закрывающую фигурную скобку. В строке ключ/значение libpq используйте одинарные кавычки и экранируйте обратной косой чертой ' и \. Конструктор делает это за вас.

Что проверяет декодер?

Он читает строку так, как это сделал бы драйвер, перечисляет каждый ключ с его назначением и отмечает проблемы: отключённые проверки сертификатов (TrustServerCertificate=true, sslmode=require, tls=skip-verify), TLS отключён или необязателен, пароли и токены открытым текстом, неправильно написанные или неизвестные ключевые слова, host:port где SQL Server ожидает host,port, неэкранированные символы в паролях URL, путаница между SID и именем сервиса в Oracle и значения по умолчанию, которые изменились между версиями драйвера, такие как Encrypt в Microsoft.Data.SqlClient 4.0.

Почему после обновления драйвера соединение завершается ошибкой сертификата?

Microsoft.Data.SqlClient 4.0, драйвер ODBC 18 и Microsoft JDBC Driver 10.2 все по умолчанию перешли на шифрование и проверку сертификата сервера. SQL Server, который все еще использует свой самоподписанный сертификат, затем выдает ошибку «Цепочка сертификатов была выдана удостоверяющим центром, которому не доверяют». Установите сертификат от УЦ, которому доверяют ваши клиенты; установите TrustServerCertificate=true только для локальной разработки.

Что такое «Открыть в SQLly»?

SQLly — это настольный SQL-клиент для macOS, Windows и Linux. Кнопка создаёт sqlly://connection/new ссылку, которая открывает редактор подключений SQLly с уже заполненными вашим хостом, портом, базой данных и пользователем. Пароль добавляется в ссылку только если вы отметите соответствующее поле, и SQLly никогда не записывает его в файл подключения. Ссылка идёт прямо из вашего браузера в приложение на вашем компьютере; она не проходит ни через какой сервер.

// вообще без строк подключения

Подключитесь один раз. А потом просто пишите SQL.

SQLly — это нативная рабочая среда SQL для macOS, Windows и Linux. Вставьте строку подключения в её редактор подключений, храните пароли в системной связке ключей и получайте IntelliSense с учётом схемы для любых баз данных.