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 的正式環境檢查清單。

選擇路徑

簡短版本

  • 憑證絕不會送達瀏覽器。 設定檔的密碼存放在橋接的狀態目錄中。瀏覽器僅接收連線清單(名稱、引擎、標籤)並透過橋接的 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 頁面.