SQLly Embedded
在你自己的網頁應用程式中託管 SQLly:套件內容、橋接器、你的應用程式與 sqlly.app 如何協作,以及從何開始。
SQLly Embedded 把 SQLly 的瀏覽器版放進你自己的網頁應用程式。你的使用者在網站的一個頁面上就能使用完整的工作台:具備 IntelliSense 的 SQL 編輯器、物件總管、結果網格、圖表和執行計畫。所有資料庫密碼都保存在你的伺服器上。由你決定每個使用者群組能看到哪些連線,授權則由 SQLly bridge 把關。
你執行的內容
| 元件 | 其作用 | 它在哪裡執行 |
|---|---|---|
| 你的網頁應用程式 | 為你的使用者登入,並決定哪些 設定檔 (各自取得的連線集合),會向橋接器要求啟動權杖,並提供載入 SQLly 的頁面。 | 你的伺服器 |
SQLly 橋接器 (sqlly-bridge embedded) | 儲存設定檔與其憑證、簽發啟動權杖、接受瀏覽器 WebSocket 連線、為每個工作階段執行一個引擎、計算席位數,並向 sqlly.app 驗證授權。 | 你的伺服器,位於你的應用程式旁邊 |
SQLly 引擎 (sqlly-cli) | 連線到你的資料庫並在單一瀏覽器工作階段內執行查詢。由橋接器啟動和停止它,沒有其他東西會與它通訊。 | 你的伺服器(橋接的子進程) |
SQLly 網頁套件 (web/) | 編譯為 WebAssembly 的 SQLly 應用程式。你的應用程式提供的靜態檔案。 | 你使用者的瀏覽器 |
| sqlly.app | 每次橋接回報時(每 20 分鐘一次),會核發你的授權並簽署短期憑證。離線授權絕不會聯絡它。 | 我們的 |
此套件還包括一個 範例管理應用程式 (Node.js,無依賴)能做你自己的應用程式會做的一切:管理設定檔、標籤與使用者的管理畫面,以及為每位使用者開啟 SQLly 的登入頁。執行它來看完整流程,然後換成你自己的應用程式,或從它的程式碼開始。
在本節中
- 它的運作方式
- 運作原理:橋接器、每個工作階段一個引擎、啟動權杖、簽署的授權核發、定期回報、席位、Origin 規則,以及憑證存放的位置。
- 快速入門
- 在五分鐘內於本機執行 SQLly Embedded 套件:啟動橋接器與範例應用程式、綁定授權、新增設定檔,然後以使用者身分開啟 SQLly。
- 範例應用程式導覽
- 隨 SQLly Embedded 附帶的範例管理後台應用程式逐畫面導覽:狀態與授權、設定檔與連線、標籤、使用者,以及啟動 SQLly。
- 建立你自己的應用程式
- 逐步教學:從你自己的網頁應用程式操控 SQLly Embedded 橋接器——儲存設定檔、簽發啟動權杖、代管瀏覽器版、釋放席位並綁定安裝。
- 在查詢上開啟 SQLly
- 直接啟動 SQLly 進入查詢分頁:腳本、其連線與資料庫、參數值與游標位置,會隨「在 SQLly 中開啟」按鈕的啟動權杖一併送出。
- API 參考
- SQLly Embedded 橋接管理 API 的每個端點,由其 OpenAPI(swagger.json)文件產生,外加 sqlly.app 連結端點。
- 授權
- 方案、席次、工作階段、執行個體、網域、簽到、寬限期、離線授權檔,橋接器可能處於的每種授權狀態,以及各狀態的修復方式。
- 正式上線
- TLS、反向代理、授權網域、服務管理工具、備份、內容安全政策與隔離標頭,以及 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 頁面.