SQLly Embedded
在你自己的 Web 应用中托管 SQLly:软件包里有什么,桥接程序、你的应用和 sqlly.app 如何协同工作,以及从哪里入手。
SQLly Embedded 将 SQLly 的浏览器版本嵌入你自己的 Web 应用。你的用户可以在你网站的一个页面上使用完整的工作台:带 IntelliSense 的 SQL 编辑器、对象浏览器、结果网格、图表和执行计划。所有数据库密码都保存在你的服务器上。由你决定每组用户能看到哪些连接,SQLly Bridge 会强制执行你的许可证。
你运行什么
| 组成部分 | 作用 | 运行位置 |
|---|---|---|
| 你的网页应用 | 让你的用户登录,并决定 配置文件 (各自能拿到哪一组连接)、向桥接器请求启动令牌,然后返回加载 SQLly 的页面。 | 你的服务器 |
SQLly 桥接 (sqlly-bridge embedded) | 保存连接配置及其凭据,签发启动令牌,接受浏览器的 WebSocket 连接,为每个会话运行一个引擎,统计席位数,并向 sqlly.app 校验许可证。 | 你的服务器,位于你的应用旁边 |
SQLly 引擎 (sqlly-cli) | 连接到你的数据库,仅为单个浏览器会话运行查询。桥接程序负责启动和停止它;其他任何东西都不会与它通信。 | 你的服务器(桥接程序的子进程) |
SQLly Web 包 (web/) | 编译为 WebAssembly 的 SQLly 应用。你的应用提供的静态文件。 | 你用户的浏览器 |
| sqlly.app | 每次桥接器签到时(每 20 分钟)都会签发你的许可证并签署一个短期授权。离线许可证绝不会联系它。 | 我们的 |
该软件包还包括一个 示例管理应用 (Node.js,无任何依赖) 能做你自己的应用要做的一切:一个可以管理连接配置、标签和用户的界面,外加一个为每个用户打开 SQLly 的登录页。先跑一遍它看看完整流程,然后换成你自己的应用,或者直接从它的代码改起。
在本节中
- 工作原理
- 工作原理:桥接程序、每会话引擎、启动令牌、签名的许可证授权、签到校验、席位、Origin 规则,以及凭证的存放位置。
- 快速入门
- 在五分钟内在本地主机上运行 SQLly Embedded 包:启动桥接和示例应用,绑定许可证,添加配置文件,并以用户身份打开 SQLly。
- 示例应用导览
- 逐屏带你逛一遍 SQLly Embedded 附带的示例管理应用:状态与许可、配置文件与连接、标签、用户,以及启动 SQLly。
- 构建自己的应用
- 分步指南:用你自己的 Web 应用驱动 SQLly Embedded 桥接器——存储配置文件、签发启动令牌、提供浏览器版、释放席位并关联安装。
- 打开 SQLly 并定位到查询
- 启动 SQLly 并直接进入查询标签页:脚本、对应的连接和数据库、参数值和光标位置,随“在 SQLly 中打开”按钮的启动令牌一起发送。
- API 参考
- SQLly Embedded 桥接管理 API 的每个端点,由它的 OpenAPI(swagger.json)文档生成,外加 sqlly.app 的关联端点。
- 许可
- 套餐、席位、会话、实例、域名、签入、宽限期、离线许可证文件、桥接程序可能处于的每种许可证状态,以及每种状态的修复方法。
- 走向生产环境
- TLS、反向代理、授权域名、服务管理器、备份、Content-Security-Policy 和隔离响应头,以及 SQLly Embedded 的生产检查清单。
选择路径
- 还在评估? 读取 工作原理,然后按照 快速入门。每个 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 页面.