Экспорт и импорт подключений
функциональныйПеремещайте серверы, базы данных и учетные записи - с паролями или без них - вместе с цветами и значками меток на другой компьютер в одном файле, выбирая точно, что включить.
A файл подключения переносит весь рабочий набор между машинами или коллегами за один шаг: серверы, базы данных на них, логины для входа и, если захотите, их пароли, а также метки клиента, проекта и окружения, к которым относятся эти подключения, — включая для каждой метки её цвет и значок. Оба варианта экспорта пишут один и тот же файл; разница только в том, есть ли в нём пароли. Экспортируйте файл из SQLly или напишите вручную, чтобы развернуть команду, и импортируйте в любой копии SQLly.
Экспорт подключений
Выберите Файл → Экспорт подключений… для файла без паролей, или Файл → Экспортировать подключения с учётными данными… для файла с ними (оба варианта также доступны в панели команд). Любой из них открывает селектор, который показывает каждое сохраненное подключение в виде дерева: каждый сервер (хост, порт и движок) с базами данных вы сохранили для него ниже. Экспорт соединения с учётными данными открывается с предупреждением вверху: файл будет содержать пароли в открытом виде.
- Выберите любые или все серверы - отметьте сервер, чтобы выбрать все его базы данных, или отметьте ещё раз, чтобы снять выделение.
- Выберите любые или все базы данных - разверните сервер и отметьте отдельные базы данных; строка сервера показывает, сколько его баз данных выбрано.
- Выбрать всё / Очистить переключает всё сразу. Изначально выбрано всё.
- Только выбранное вами будет включено - в комплект входят общие логины, профили туннелей и метки клиентов, проектов и сред, которые используют выбранные подключения, — и больше ничего.
Нажмите Экспорт и выберите, куда сохранить. Все настройки, которые предлагает редактор подключений, сохраняются в любом случае, включая способ входа каждого подключения. С учётными данными SQLly выписывает каждый пароль, парольную фразу и токен обратно из связки ключей в файл; без них все секреты остаются в хранилище, и перед сохранением SQLly проверяет, что в файле их нет. Логин, используемый несколькими экспортированными подключениями, записывается один раз как общий; логин одного подключения записывается у этого подключения. Значки меток встроены в файл, так что он самодостаточен.


Импорт подключений
Выберите Файл → Импортировать подключения… и выберите файл. Та же команда читает файл и с паролями, и без них, а также файлы, сохранённые экспортом соединений в предыдущих версиях SQLly. Прежде чем что-то менять, она проверяет весь файл и, если какая-то запись неверна, перечисляет все проблемы и ничего не импортирует — частично применённый импорт невозможен. Опечатка в имени настройки попадает в отчёт, а не молча пропускается. Импортированные соединения сразу появляются в обозревателе серверов.
- Пароли сохраняются в вашей связке ключей - Связка ключей на macOS, Диспетчер учётных данных на Windows, Secret Service на Linux — никогда не в файл сохранённых подключений SQLly. В строке состояния указано, сколько паролей импортировано.
- Метки объединяются по имени , существующий клиент, проект или окружение сохраняет всё, что файл не задаёт, и меняются только перечисленные в файле переключатели безопасности.
- Общие логины обновляются на месте - сохранённому логину с тем же именем и именем пользователя присваивается новый пароль, так что каждое подключение, которое его использует, продолжает работать.
- Нет пароля — нет проблем - логин без пароля (каждый логин из файла, экспортированного без учётных данных) всё равно импортируется, и SQLly запрашивает пароль при первом подключении.
Импорт из Redis Insight
В Redis Insight выделите свои базы данных и выберите Экспорт (отметить Включить пароли если вы хотите, чтобы они были перенесены). В SQLly выберите Импорт из других инструментов… и укажите экспортированный файл — обычный JSON или вариант в base64, который тоже принимает Redis Insight. Каждая база становится подключением Redis с её хостом, портом, логической базой, именем пользователя ACL, настройками SSH-туннеля и TLS.
- TLS никогда не отключается - база данных, экспортированная с TLS (или с CA или клиентским сертификатом), импортируется зашифрованной: Проверить ЦС когда Redis Insight проверял серверный сертификат, Требовать когда не проверял. Тела сертификата и ключа сохраняются в виде файлов PEM в папке данных SQLly (ключи доступны только вам), и подключение ссылается на них.
- Секреты отправляются в связку ключей - пароли, SSH-пароли и парольные фразы ключей из экспорта хранятся так же, как пароли из файла подключения, и никогда не попадают в файл сохранённых подключений. После импорта удалите экспорт: пароли лежат в нём в открытом виде.
- Базы данных Azure Entra импорт с входом через Microsoft Entra; выберите Azure-аккаунт в редакторе подключения.
- Кластерные базы данных импорт как подключений к Redis Cluster с начальным узлом, который они задают (или как одно подключение к узлу, если в Redis Insight указали принудительный standalone); Sentinel базы данных импортируются как подключения Sentinel с группой master, паролем sentinel (перенесённым в связку ключей) и собственными данными входа master, а в строке состояния перечисляется всё, что не удалось перенести.
Что может содержать файл соединения
| Раздел | Что он несёт |
|---|---|
| Подключения | Любое количество серверов и любое количество баз данных на каждом: движок, хост, порт, база данных, окружение, клиент и проект, метод входа и (с учетными данными) пароль, режим TLS и файлы сертификатов, таймауты соединения и выполнения запросов, имя приложения, стартовый SQL, переключатели безопасности для каждого соединения, избранная звезда, правила маскировки, маршрут ретрансляции и встроенный SSH-туннель, прокси или форвардинг порта Kubernetes. |
| Общие логины | Несколько именованных логинов (имя пользователя, плюс пароль в файле с учетными данными), которые могут использовать многие подключения. |
| Профили туннелей | Именованные цепочки SSH (с промежуточным хостом), прокси и Kubernetes, а также SSH-пароли и фразы-пароли ключей в файле с учетными данными. |
| Клиенты, проекты, окружения | Имя, цвет, изображение иконки (встроенное в файл) и любые средства защиты запросов. |
Каждый метод входа, поддерживаемый SQLly, может быть описан: имя пользователя и пароль, интегрированная безопасность Windows, Microsoft Entra (через браузер или код устройства), AWS RDS IAM, Google Cloud SQL IAM и токены libSQL / Turso. Файлы SQLite и DuckDB не требуют входа.
Написание вручную
Файл подключения — это обычный JSON, поэтому администратор может написать его вручную и дать команде готовую настройку. Обязательны у подключения только name, engine, и
server обязательны — для всего остального берутся те же значения по умолчанию, что и в редакторе подключений. Этот файл добавляет две базы данных на одном сервере с общим логином только для чтения, второй сервер со своим паролем и клиент с цветом и иконкой:
{
"format": "sqlly-credentials",
"version": 1,
"clients": [
{ "name": "Acme", "color": "#1E88E5", "image": "data:image/png;base64,iVBORw0KGgo…" }
],
"sql_auth_accounts": [
{ "name": "Reader", "username": "ro", "password": "ro-secret" }
],
"connections": [
{ "name": "Sales", "engine": "postgresql", "server": "pg1.acme.internal", "database": "sales",
"client": "Acme", "environment": "production",
"authentication": { "type": "sql-login", "account": "Reader" },
"tls": { "mode": "verify-full" } },
{ "name": "HR", "engine": "postgresql", "server": "pg1.acme.internal", "database": "hr",
"client": "Acme", "authentication": { "type": "sql-login", "account": "Reader" } },
{ "name": "Ops", "engine": "sql-server", "server": "sql01.acme.internal", "database": "ops",
"authentication": { "type": "sql-login", "username": "ops", "password": "ops-secret" } }
]
}
- Движки можно писать свободно —
postgres,PostgreSQL,mssql,sql-server,mysql,sqlite,duckdb,clickhouse,redis, и так далее. - Цвета являются
#RGB,#RRGGBB, или#RRGGBBAA. - Иконки — это base64 — URI вида
data:image/…;base64,URI, либо просто base64 — изображения PNG, JPEG, GIF, WebP, BMP, ICO или SVG размером до 1 МБ. - Окружения являются
local,dev,test,staging, илиproduction.
Преднастроенные подключения (Docker, Kubernetes, управляемые машины)
Вместо разового импорта файла можно поручить SQLly для создания подключений при каждом запуске — в настольном приложении, в sqlly-cli командах агента и в самостоятельно развёрнутом sqlly-bridge embedded сервере. Укажите
SQLLY_PROVISIONED_CONNECTIONS_FILE на файл (или положите
provisioned-connections.json в папку настроек SQLly рядом с
connections.json), и/или установите одну SQLLY_CONNECTION_<NAME>
переменную на каждое подключение, содержащую его URL. Файл использует формат файла подключения выше (format и version можно опустить, и будет прочитано только
connections считывается), и любое подключение может дать url вместо его полей engine, server, port, database и sign-in:
{
"connections": [
{ "name": "Cache",
"url": "redis+sentinel://app:${REDIS_PASSWORD}@sentinel-0:26379,sentinel-1:26379/mymaster/0?sentinelPassword=${SENTINEL_PASSWORD}",
"environment": "production" },
{ "name": "Orders", "engine": "postgres", "server": "${PGHOST}", "database": "orders",
"authentication": { "type": "sql-login", "username": "app", "password": "${PGPASSWORD}" },
"tls": { "mode": "verify-full" } }
]
}
# docker run / Kubernetes env
SQLLY_PROVISIONED_CONNECTIONS_FILE=/etc/sqlly/connections.json
REDIS_PASSWORD=... # from a Secret
SENTINEL_PASSWORD=...
SQLLY_CONNECTION_SESSIONS=rediss+sentinel://:${REDIS_PASSWORD}@sentinel-0,sentinel-1/sessions
- URL-адреса Sentinel -
redis+sentinel://[user:password@]host1:26379,host2:26379/<master-name>[/<db>], сrediss+sentinel://для TLS иvalkey+sentinel:///valkeys+sentinel://для Valkey.?sentinelPassword=устанавливает собственный пароль сентинелов и?preferReplica=trueотправляет скрипты только для чтения на реплику. Сентинелы без порта используют 26379. Те же URL работают в редакторе соединений в поле Paste URL. ${VARIABLE}в любом месте файла (или вSQLLY_CONNECTION_URL) заменяется на эту переменную окружения; напишите$${для буквального${.- Пароли не хранятся в файлах - пароль, токен,
redis_sentinel_password, пароль URL илиsentinelPasswordзаписанные в точности как${VARIABLE}читается из окружения каждый раз при подключении SQLly и никогда не копируется в профиль и нигде не сохраняется. - Управляемый, только для чтения - управляемые подключения появляются рядом с вашими, но никогда не записываются в
connections.json, а команды Сохранить и Удалить для них отклоняются: вместо этого измените файл или переменные, либо используйте Дублировать чтобы создать свою собственную редактируемую копию. - Одна некорректная запись никогда не блокирует остальные , неизвестная настройка, ненастроенная переменная или недоступный URL пропускают только это подключение и печатают предупреждение с указанием, какое именно и почему; последующее подключение с уже занятым именем пропускается так же.
- На мосту -
sqlly-bridge embeddedслужит им в качестве профиля только для чтенияprovisioned(также через--provisioned-connections <file>); токены запуска могут ссылаться на него как на любой другой профиль, и он никогда не записывается в каталог состояния.