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.
Выберите путь
- Оцениваете? Читать Как это работает, затем следуйте инструкциям Быстрый старт. Каждый аккаунт sqlly.app включает бесплатный трехмесячный пробный период (один пользователь, один мост), поэтому вам не нужно ничего покупать, чтобы попробовать его.
- Интегрируете? Пройдите обзор демонстрационного приложения чтобы увидеть, что ваше приложение должно предоставлять, затем выполните Создание собственного приложения с Справочник API (или загрузите swagger.json в ваши инструменты API).
- Развертываете? Читать Лицензирование о рабочих местах, доменах и том, что означает каждое состояние лицензии, а затем Выход в продакшн.
Краткая версия
- Учётные данные никогда не попадают в браузер. Пароли профиля хранятся в каталоге состояния моста. Браузер получает только список подключений (имена, движки, метки) и отправляет запросы через 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.