概覽
- 查詢語言
- SurrealQL
- 驅動程式
- 首次使用時下載
- 連線方式
- 主機與連接埠, SSH 通道, SSL/TLS
- 預設連接埠
- 8000
- 最低版本
- 2.0,強制執行:拒絕舊版伺服器


連線與登入
選擇 驗證層級 (Auth Level):Root、Namespace、Database、Record Access 或 Token。Namespace 和 Database 需要其名稱,Record Access 還需要存取方式和登入欄位,Token 接受既有的 JWT。
驅動程式透過 HTTP RPC 端點傳輸 CBOR,因此記錄連結、日期時間、期間、小數和 UUID 都會保留型別。surrealdb:// 連結會開啟已填好的連線表單。
SSL 預設為 Disabled,即明文 HTTP;其他模式都使用 HTTPS。Verify CA 和 Verify Identity 會以系統信任存放區驗證憑證,並忽略 SSL/TLS 面板中設定的 CA 檔案,因此請先在 macOS 中安裝私有 CA。
SurrealQL 與記錄
執行完整的 SurrealQL 指令碼(包括 RELATE),並支援陳述式自動完成。Explain 和 Explain Full 會以 EXPLAIN 執行查詢並傳回文字計畫。
命名空間位於側邊欄頂層,其資料庫位於其中。切換兩者都不會重新連線,因為兩者都隨每個請求傳送,只有根使用者能看到所有命名空間。
儲存格編輯只以帶型別的參數更新已變更的欄位,因此計算的 FUTURE 欄位和其他寫入者的變更都會保留。將 id 留空即可自動產生 ID;SCHEMALESS 資料表的欄位來自已取得的記錄。
篩選會轉換為 SurrealQL,Raw SQL 列接受單一條件,例如圖遍歷。會寫入、含有 ; 或註解,或呼叫 fn:: 或 http:: 的條件會被拒絕;請在編輯器中執行。
結構
Structure 分頁為唯讀:請在編輯器中以 DEFINE FIELD 和 DEFINE INDEX 建立和變更欄位及索引。命名空間或資料庫可從其選單刪除,選取多個時只會詢問一次。
本頁介紹 SurrealDB 專屬的功能。Safe Mode、AI 助理、MCP 伺服器和 TablePro 的其他功能請見功能頁面。
其他
搬移資料
不提供匯入。將資料表或 SurrealQL 結果匯出為 CSV、JSON、SQL、XLSX、Markdown、HTML 與 XML。
限制
- 編輯器不對 SurrealQL 提供語法醒目提示。
- 不支援即時查詢。請重新執行查詢查看新紀錄。
可以執行交易嗎?
在同一個查詢內可以。HTTP RPC 不會在請求之間保留交易,因此請將
BEGIN TRANSACTION; … COMMIT TRANSACTION;作為單一編輯器查詢傳送。如何變更關係的 in 或 out?
無法從格線變更:儲存會停止、指出該欄位,並保留所有待處理的編輯。
UPDATE也無法移動關係,因此請刪除它,再以RELATE建立新的一對。