編輯工具
功能性的轉換與產生儲存格值、跨整個網格尋找與取代,並把暫存的變更複製成 SQL。
暫存方格編輯附帶讓大量清理變快的日常工具:可在任一儲存格使用文字巨集與數值產生器、跨整個方格的尋找與取代,以及一鍵將暫存變更複製成 SQL 腳本。每一種產生的都是普通的 已暫存的變更,所以它們會顯示在待處理變更列,可在 預覽 SQL,復原用 復原,並在你手動輸入編輯的同一個交易中一併提交。
轉換值
右鍵點擊一個文字儲存格,並選擇 轉換: 項目,位於 編輯儲存格:
全大寫, 小寫, 標題大小寫,
去除空白,或 移除變音符號 (Crème Brûlée
變成 Creme Brulee,以及沒有分解形式的字母,例如
Ł, Ø,而且 ß,按前綴摺疊,並用一列筆記確實告訴你這份長清單你看到了多少——搭配
移除變音符號 只會去掉拉丁字母、希臘字母和西里爾字母的重音符號。在其他文字系統中,例如天城文、泰文和韓文,組合符號是拼寫的一部分,因此這些文字會保持原樣。 標題大小寫 會將每個字的第一個字母大寫,並套用正確的標題式大小寫,所以以
ß 變成 Ss,而且重音符號不會被當成新字的開頭。如果儲存格已有暫存值,巨集會改寫那個值,所以你可以先修剪、再轉字首大寫,然後儲存。轉換只適用於可編輯的純文字欄位。鍵值欄位、計算欄位、列舉與 SET 欄位、JSON 與 XML 欄位,以及非文字類型都會被拒絕並說明原因;結果欄位若是運算式而非資料表欄位,也同樣會被拒絕。
要一次清理整批變更,請開啟 轉換 選單。它會把巨集套用到純文字欄位裡的每個暫存值,包括修改過的和新增的資料列,整個算一次復原步驟。JSON、XML、列舉以及
SET 欄位則保持原樣,因為改寫可能使其失效。在資料列編輯器中,每個純文字欄位都有各自的 轉換 選單,可以就地重寫草稿。


插入產生的值或 SQL 函式
同一個選單也可以用產生的值填入儲存格:
- 設為新 UUID 會寫入由你的電腦產生的全新隨機 UUID。可用於 UUID 欄位,以及寬度足以容納 36 字元格式的純文字欄位(不適用於 JSON、XML、enum 或
SET欄位)。 - 設為目前時間戳記(本機時鐘) 會寫入你電腦目前的日期與時間,並配合欄位類型(日期、時間或日期與時間)調整格式。
- SQL 函式 暫存一個運算式,等你儲存時交由伺服器求值,讓值來自資料庫而不是你的電腦: 伺服器時間, 伺服器日期 (
CURRENT_DATE,CURDATE(),CAST(SYSDATETIME() AS date)),一個 伺服器產生的 UUID (NEWID(),gen_random_uuid(),UUID(),SYS_GUID(),uuid()),以及 目前的使用者 (SUSER_SNAME(),CURRENT_USER,USER).
每個引擎都有自己對函式的拼法,預覽腳本會顯示確切的 SQL。網格會將暫存中的函式標記為 <server date>,
<server UUID>,如此類推直到你儲存。在資料列編輯器中,每個欄位的 插入 選單列出相同的產生器,每個函式的方言 SQL 都顯示在標籤中。
SQLite、libSQL 和 DuckDB 沒有登入功能,因此 目前的使用者 那裡不提供。SQLite 和 libSQL 沒有 UUID 函式,因此伺服器產生的 UUID 會寫成 32 個隨機的十六進位字元(lower(hex(randomblob(16))))。Oracle 的 SYS_GUID() 同樣會產生 32 個大寫十六進位字元且沒有連字號,而非 36 字元帶連字號的形式。
經由中繼橋接器的連線,橋接器會在工作階段開啟時說明其 SQLLY 版本支援哪些功能。 伺服器日期, 伺服器產生的 UUID,而且 目前的使用者 只有橋接器支援時才會提供;在較舊的橋接器上(它會拒絕整筆編輯),網格選單會隱藏這些功能,資料列編輯器則以停用狀態列出並附上更新橋接器的提示。 伺服器時間, 設為新 UUID,而本機時鐘的時間戳記在任何橋接上都可用。透過中繼儲存暫存的網格編輯時,做法與本機相同:放進單一交易,若任何資料列在中途被更動就整筆回復——前提是橋接器支援。橋接器較舊時,待處理變更列會顯示 儲存需要較新的橋接器 和 儲存變更 保持停用,而資料列編輯器仍一次儲存一列。
在資料格中尋找與取代
按下 在網格中尋找 快速鍵,或按右鍵並選擇 工具 › 在網格中尋找與取代…,然後在尋找欄輸入字詞。取代欄就在下面。 取代 會改寫目前聚焦的符合項,並 全部取代 會改寫每一個符合項。比對不分大小寫,符合的儲存格內每一處都會被取代。尋找文字會完全按照你輸入的內容使用,包括前後的空格,因此被取代的正是方格中突顯的那段文字。
取代作業會變成暫存的儲存格編輯,絕不直接寫入資料庫。全部取代是一個復原步驟,訊息分頁會回報暫存了多少儲存格與資料列。取代只改寫能安全重寫的儲存格:可編輯的純文字欄位。鍵、識別欄位、計算欄位、rowversion、列舉條件約束、數值、日期、JSON 與 XML 欄位中的符合項會被略過,NULL 儲存格也一樣,即使網格將它們顯示為 NULL。屬於運算式的結果欄位也會跳過,即使名稱與資料表欄位相同也一樣(SELECT id, left(body, 50) AS body):只有查詢直接從資料表選取的欄位才會寫入。已排定刪除的資料列會跳過,存放暫存 SQL 函式的儲存格也一樣,例如 <server UUID>。取代會以你看見的值為基礎,所以它會接續你在該儲存格裡已暫存的任何修改。每一列都有自己的樂觀並行防護:它的原始值,以及結果中包含 rowversion 時該列自己的 rowversion。
全部取代涵蓋的是尋找列搜尋過的資料列。對於 SQLLY 存放在磁碟上的超大結果,只會搜尋目前捲動位置附近已載入的資料列,且搜尋會在 100,000 個符合項後停止。當任一上限生效時,訊息分頁會明確指出涵蓋了哪些資料列,例如 已載入的 100 列(共 5000 列中的 3001–3100 列)。捲動,或再執行一次全部取代,就能處理剩下的。


將暫存變更複製為 SQL
有時候你要的是腳本,而不是直接儲存:可能是要貼到工單裡、走一遍部署流程,或是先請同事看過。暫存變更後,點擊 複製為 SQL 在待處理變更欄上、在 預覽 SQL 分頁上,或在 確認已暫存的變更 對話方塊中。你也可以從命令面板執行 結果:將暫存變更複製為 SQL 從命令面板開啟。腳本是在你點擊的當下產生,所以前一秒做的編輯也一定會包含在內。複製不會儲存或捨棄任何內容;你的變更會保持暫存,直到你儲存或捨棄為止。
複製的腳本含有與 預覽 SQL,也在同一個交易包裝裡,但和儲存時送出的內容並非逐位元組相同。儲存會把值以參數綁定,腳本則把它們直接寫成字面值。儲存還要求每個 UPDATE 和 DELETE 只修改恰好一列,只要有一列不符合就整批復原,因為自從你載入之後,該列可能已經被更改或刪除。腳本會把這項檢查寫在引擎能表達的地方:
- SQL Server:每個陳述式後面接著
IF @ROWCOUNT <> 1 THROW …,而且SET XACT_ABORT ON回滾交易。 - PostgreSQL 及相容引擎(CockroachDB 除外):每個陳述式都在
DO區塊,檢查資料列數並引發錯誤,藉此中止交易。 - Oracle:每個陳述式都在一個 PL/SQL 區塊中執行,該區塊會檢查
SQL%ROWCOUNT。請用WHENEVER SQLERROR EXIT ROLLBACK(SQL*Plus 或 SQLcl),這樣檢查失敗時也會一併復原稍早的語句。 - MySQL、MariaDB、SQLite、libSQL、DuckDB 和 CockroachDB 無法在純腳本中檢查資料列數。每個陳述式都標記為
-- expect 1 row,因此需要自己檢查數量。
在 SQL Server 上,儲存同時會使用 OUTPUT INSERTED.*讀回插入的行。腳本中未包含此步驟。腳本頂部的註解會重複這些差異。

