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 的生产检查清单。

选择路径

简短版

  • 凭据永远不会到达浏览器。 配置文件的密码保存在桥接的状态目录中。浏览器只接收连接列表(名称、引擎、标签)并通过桥接的 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 页面.