Конструктор и декодер строк подключения
Заполните форму и получите строку подключения во всех форматах, которые используют ваши драйверы, — ADO.NET, JDBC, ODBC, URL-адреса, libpq, DSN для Go и другие — рядом. Или вставьте готовую строку и узнайте, за что отвечает каждый ключ и какие значения рискованны. Всё работает в вашем браузере: ничего из того, что вы вводите, никуда не отправляется.
Открыть это подключение в SQLly
Открывает редактор подключений SQLly с заполненными полями.
Открыть это подключение в SQLly
Приватность на уровне архитектуры. Конструктор и декодер — обычный JavaScript, работающий в этой вкладке. Страница никуда не отправляет то, что вы вводите, ничего не хранит (даже в вашем браузере) и продолжает работать офлайн после загрузки. Ссылка «Открыть в SQLly» ведёт из вашего браузера прямо в приложение на вашем компьютере.
Выберите базу данных
Каждая страница движка открывает конструктор для этого движка и добавляет полный справочник ключевых слов, часто встречающиеся ошибки подключения и способы их исправления.
SQL Server
ADO.NET, ODBC, JDBC, Go URL, SQLAlchemy URL
PostgreSQL
URI, ключ/значение, ADO.NET (Npgsql), JDBC, ODBC
MySQL
URI, JDBC, ADO.NET, ODBC, Go DSN
MariaDB
JDBC, ADO.NET, Go DSN, SQLAlchemy URL, URI
SQLite
Путь к файлу, имя файла URI (только для чтения), ADO.NET, JDBC, SQLAlchemy URL
Oracle
Easy Connect, Easy Connect через TLS, дескриптор подключения, JDBC thin, ADO.NET (ODP.NET)
Redis
URI с TLS, URI с пользователем ACL (Redis 6+), StackExchange.Redis, redis-cli
ClickHouse
HTTP URL, Native DSN, JDBC, ADO.NET
DuckDB
Путь к файлу, JDBC, SQLAlchemy URL, CLI, только для чтения
libSQL
URL базы данных, URL с токеном аутентификации, Local sqld
Форматы строк подключения и как их экранировать
Большинство ошибок в строках подключения связаны с экранированием: пароль с @, ; или кавычка, которую драйвер разделяет в неправильном месте. У каждого формата есть своё правило.
| Формат | Выглядит как | Специальные символы |
|---|---|---|
| URL / URI | postgresql://user:pass@host:5432/db?sslmode=verify-full | Процентное кодирование зарезервированных символов в имени пользователя, пароле и базе данных: @ → %40, : → %3A, / → %2F, ? → %3F, # → %23, % → %25, пробел → %20. |
| ADO.NET | Server=host;Database=db;User ID=u;Password=p; | Заключите значение в ;, ведущий или конечный пробел, или ведущую кавычку в "…" (или '…'), и удвойте кавычку внутри: Password="a;b""c". |
| ODBC | Driver={ODBC Driver 18 for SQL Server};Server=host;Pwd={p;w}; | Заключите значение в фигурные скобки. Имена драйверов всегда заключаются в них. |
| JDBC | jdbc:sqlserver://host;databaseName=db, jdbc:postgresql://host/db?user=u | Зависит от поставщика. Microsoft: фигурные скобки, с } удвоено. PostgreSQL, MySQL, MariaDB: URL-запрос, поэтому используйте процентное кодирование. |
| ключ/значение libpq | host=h dbname=db user=u password='a b' | Заключайте в одинарные кавычки пустые значения и значения с пробелами; пишите \' и \\ для кавычки или обратной косой черты. |
| Go MySQL DSN | user:pass@tcp(host:3306)/db?tls=true | Пароль не требует экранирования; значения параметров экранируются для URL; имена параметров чувствительны к регистру. |
| StackExchange.Redis | host:6380,password=p,ssl=true | Запятые разделяют параметры, поэтому пароль с запятой приходится задавать в коде. |
| Oracle Easy Connect | host:1521/service_name | Учётных данных внутри нет; имя пользователя и пароль передаются отдельно. |
Что проверяет декодер
- Проверка сертификатов отключена.
TrustServerCertificate=true,sslmode=require,tls=skip-verify,sslMode=trustи pgJDBCNonValidatingFactoryвсе шифруют без проверки, кто ответил. - Нет 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 Server
- Строки подключения к PostgreSQL
- Строки подключения к MySQL
- Строки подключения к MariaDB
- Строки подключения к SQLite
- Строки подключения к Oracle
- Строки подключения Redis
- Строки подключения ClickHouse
- Строки подключения DuckDB
- Строки подключения libSQL
- Форматировщик SQL
- Все бесплатные инструменты
Подключитесь один раз. А потом просто пишите SQL.
SQLly — это нативная рабочая среда SQL для macOS, Windows и Linux. Вставьте строку подключения в её редактор подключений, храните пароли в системной связке ключей и получайте IntelliSense с учётом схемы для любых баз данных.