SQLly Embedded

Размещайте SQLly в своём веб-приложении: что входит в пакет, как мост, ваше приложение и sqlly.app работают вместе и с чего начать.

SQLly Embedded встраивает браузерную версию SQLly в ваше веб-приложение. Пользователи получают полноценную рабочую среду на странице вашего сайта: SQL-редактор с IntelliSense, обозреватель объектов, сетку результатов, диаграммы и планы выполнения. Все пароли баз данных остаются на вашем сервере. Вы решаете, какие подключения видит каждая группа пользователей, а мост SQLly следит за соблюдением лицензии.

Что вы запускаете

ЭлементЧто оно делаетГде это выполняется
Ваше веб-приложениеВыполняет вход ваших пользователей, определяет, какой профиль (набор подключений) для каждого, запрашивает у моста токен запуска и отдаёт страницу, загружающую SQLly.Ваш сервер
SQLly Bridge (sqlly-bridge embedded)Хранит профили с учётными данными, выдаёт токены запуска, принимает WebSocket-подключения из браузера, запускает по одному движку на сессию, считает места и сверяет лицензию с sqlly.app.Ваш сервер, рядом с вашим приложением
Движок SQLly (sqlly-cli)Подключается к вашим базам данных и выполняет запросы для одной сессии браузера. Мост запускает и останавливает его; больше никто с ним не взаимодействует.Ваш сервер (дочерний процесс моста)
Веб-сборка SQLly (web/)Приложение SQLly, скомпилированное в WebAssembly. Статические файлы, которые обслуживает ваше приложение.Браузеры ваших пользователей
sqlly.appВыдаёт вашу лицензию и подписывает краткосрочный грант каждый раз, когда мост связывается с ним (каждые 20 минут). Офлайн-лицензии с ним не связываются.У нас

Пакет также включает пример административного приложения (Node.js, без зависимостей), который умеет всё, что нужно вашему приложению: экран администратора с профилями, метками и пользователями и страницу входа, которая открывает SQLly для каждого пользователя. Запустите его, чтобы увидеть весь процесс целиком, а затем замените своим приложением или возьмите его код за основу.

В этом разделе

Как это работает
Теория работы: мост, движок на каждый сеанс, токены запуска, подписанный грант лицензии, чек-ины, места, правило Origin и где хранятся учётные данные.
Быстрый старт
Запустите пакет SQLly Embedded на локальном хосте за пять минут: запустите мост и пример приложения, подключите лицензию, добавьте профиль и откройте SQLly как пользователь.
Знакомство с примером приложения
Пошаговый обзор демонстрационного админ-приложения из состава SQLly Embedded: статус и лицензирование, профили и подключения, метки, пользователи и запуск SQLly.
Создание собственного приложения
Шаг за шагом: управляйте мостом SQLly Embedded из вашего собственного веб-приложения - храните профили, выпускайте токены запуска, обслуживайте сборку для браузера, освобождайте места и связывайте установки.
Открыть SQLly с готовым запросом
Запускайте SQLly сразу с открытой вкладкой запроса: скрипт, его подключение и база данных, значения параметров и курсор передаются вместе с токеном запуска для кнопок «Открыть в SQLly».
Справочник API
Все конечные точки API управления мостом SQLly Embedded, сгенерированные из его документа OpenAPI (swagger.json), плюс конечные точки привязки sqlly.app.
Лицензирование
Планы, места, сессии, экземпляры, домены, проверки лицензии (check-in), льготные периоды, офлайн-файлы лицензий, каждое состояние лицензии, в котором может находиться мост, и как исправить каждое из них.
Выход в продакшн
TLS, обратные прокси, лицензируемый домен, менеджеры служб, резервные копии, Content-Security-Policy и заголовки изоляции, а также чеклист для развёртывания SQLly Embedded в production.

Выберите путь

Краткая версия

  • Учётные данные никогда не попадают в браузер. Пароли профиля хранятся в каталоге состояния моста. Браузер получает только список подключений (имена, движки, метки) и отправляет запросы через WebSocket моста.
  • Места — это одновременные пользователи. Пользователь занимает место, пока SQLly открыт для него или пока у него есть действительный токен запуска. Оно освобождается, как только пользователь заканчивает. Платные планы позволяют четыре вкладки на пользователя.
  • Один домен на лицензию - со всеми поддоменами. Мост принимает только браузеры, у которых Origin на этом домене (плюс localhost пока вы разрабатываете).
  • Все движки, поддерживаемые SQLly работает через мост: SQL Server, Azure SQL, PostgreSQL, MySQL, MariaDB, SQLite, DuckDB, ClickHouse, Oracle, libSQL/Turso, Redis и Valkey, а также облачные варианты.
  • Подключено или офлайн. Подключённые лицензии каждые 20 минут выходят на связь с sqlly.app. Офлайн-лицензии — это подписанный файл, который мост проверяет локально и который никогда не стучится на серверы.

Тарифы и цены — на странице SQLly Embedded. Скачайте пакет для вашей платформы с Загрузки, и управляйте своими лицензиями, ключами и привязанными установками на вашей странице Embedded.