Экспорт и импорт подключений

функциональный

Перемещайте серверы, базы данных и учетные записи - с паролями или без них - вместе с цветами и значками меток на другой компьютер в одном файле, выбирая точно, что включить.

A файл подключения переносит весь рабочий набор между машинами или коллегами за один шаг: серверы, базы данных на них, логины для входа и, если захотите, их пароли, а также метки клиента, проекта и окружения, к которым относятся эти подключения, — включая для каждой метки её цвет и значок. Оба варианта экспорта пишут один и тот же файл; разница только в том, есть ли в нём пароли. Экспортируйте файл из SQLly или напишите вручную, чтобы развернуть команду, и импортируйте в любой копии SQLly.

Файл с паролями хранит их в открытом виде. Вот что делает его полезным и чувствительным. SQLly сохраняет экспортированный файл, который можете прочитать только вы, переносит каждый пароль в вашу системную связку ключей при импорте и никогда не хранит копию файла. Отправьте его через канал, которому вы доверяете, и удалите после импорта. Чтобы поделиться подключениями без паролями, используйте Файл → Экспорт подключений….

Экспорт подключений

Выберите Файл → Экспорт подключений… для файла без паролей, или Файл → Экспортировать подключения с учётными данными… для файла с ними (оба варианта также доступны в панели команд). Любой из них открывает селектор, который показывает каждое сохраненное подключение в виде дерева: каждый сервер (хост, порт и движок) с базами данных вы сохранили для него ниже. Экспорт соединения с учётными данными открывается с предупреждением вверху: файл будет содержать пароли в открытом виде.

  • Выберите любые или все серверы - отметьте сервер, чтобы выбрать все его базы данных, или отметьте ещё раз, чтобы снять выделение.
  • Выберите любые или все базы данных - разверните сервер и отметьте отдельные базы данных; строка сервера показывает, сколько его баз данных выбрано.
  • Выбрать всё / Очистить переключает всё сразу. Изначально выбрано всё.
  • Только выбранное вами будет включено - в комплект входят общие логины, профили туннелей и метки клиентов, проектов и сред, которые используют выбранные подключения, — и больше ничего.

Нажмите Экспорт и выберите, куда сохранить. Все настройки, которые предлагает редактор подключений, сохраняются в любом случае, включая способ входа каждого подключения. С учётными данными SQLly выписывает каждый пароль, парольную фразу и токен обратно из связки ключей в файл; без них все секреты остаются в хранилище, и перед сохранением 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>); токены запуска могут ссылаться на него как на любой другой профиль, и он никогда не записывается в каталог состояния.