自訂操作
功能性的把你自己的 SQL 範本變成資料表、檢視和常式的右鍵動作。
把你自己的 SQL 範本變成資料表、檢視、程序和函式專用的右鍵命令。開啟 工具 › 範本總管,要建立或編輯範本,請到 我的範本,並勾選 顯示在物件總管的右鍵選單中(自訂動作)。選擇哪些物件類型要套用(預設四種全選;至少要保留一個勾選)。之後在物件總管裡對符合條件的物件按右鍵,範本就會出現在 工具 › 自訂動作。具體化檢視沒有自訂操作。


預留位置
SQLly 會在開啟腳本前,用你右鍵點擊的物件填入這些佔位符。名稱會以腳本開啟所在連線的方言,寫成加引號的識別碼([Orders] 在 SQL Server 上, "Orders" 在 PostgreSQL 上, `Orders` 在 MySQL 上),因此含空格、保留字或引號字元的名稱會保持為單一識別碼,不會變成多餘的 SQL。
| 預留位置 | 會變成 |
|---|---|
{server} | 連線的顯示名稱,也就是物件總管顯示的名稱,會以識別碼形式加上引號。 |
{database} | 物件所在的資料庫名稱,加引號。 |
{schema} | 該物件的結構描述,帶引號(在沒有結構描述的引擎上為空)。 |
{object} | 物件自身的名稱,帶引號。 |
{kind} | table, view, procedure,或 function. |
每一個 {server}, {database}, {schema},而且 {object} 還有另外兩種形式:
{object:literal}會將名稱寫成連線方言中完整且經跳脫處理的字串常值,包含引號(N'Orders'在 SQL Server 上,'Orders'其他地方)。凡是函式需要把名稱當文字使用的地方都能用它,例如OBJECT_ID({object:literal}).{object:raw}寫出不含引號或跳脫字元的純名稱;只有換行字元會被轉成空格。它適用於註解和標籤。不要把它放進 SQL 或你自己的引號裡,因為名稱若含引號字元,字串就會中途斷開。
每個預留位置都只會被取代一次。碰巧包含預留位置文字的名稱,例如 {schema} 或 <n,int,5>,會原樣寫入,之後不再展開。不符合這些預留位置的大括號,例如字串裡的 JSON,都保持原樣。
SSMS 風格 <name,type,default> 參數在同一個範本中依然可用。當範本包含任何參數時,點擊其自訂動作會先開啟一個小型 參數 對話方塊,每個參數都有一個輸入框,並填入預設值。修改所需內容後按下 腳本 (或者 執行 執行動作) 或 Enter 鍵; 取消 或 Esc鍵 則不會有任何動作。如同在 SSMS,你輸入的內容會原樣取代該預留位置的每一份副本,不加引號,所以值可以是數字、名稱或整個條件。沒有參數的範本會跳過對話方塊。像這樣的範本會列出你右鍵點選的任何資料表的前幾列:
-- {kind} {object:raw} on {server:raw}
SELECT TOP <top_n,int,100> * FROM {schema}.{object};
產生腳本或執行
預設情況下,自訂動作 腳本:填好的 SQL 會在該物件自己的連線與資料庫上,於新的查詢分頁中開啟,讓你先檢閱。想跳過檢閱,請勾選 立即執行 在範本上。這些操作會在選單中的名稱後顯示 (執行) 會顯示在選單中它們名稱的後面。
執行動作只有在 SQL 填入你的參數值之後屬於唯讀時,才會立刻執行(僅限 SELECT 語句,且不會被引擎的唯讀檢查標記)。除此之外的其他內容,例如 UPDATE、 DROP,或預存程序呼叫,都會先開啟分頁頁並在確認對話方塊中顯示 SQL,無論該連線是否啟用了變更審核。所有正常執行的安全保護措施仍然適用,包括僅限 SELECT 的連線、產生鎖定以及租戶範圍控制。
當你點擊時(以及確認其參數時),SQLly 會以名稱查詢範本,因此你在範本總管中儲存的編輯會立刻生效。刪除範本會一併移除它的選單項目。SQLly 會把範本保留在記憶體中,並監看範本檔案,所以在 SQLly 以外對檔案所做的變更,儲存後很快就會反映到選單上。如果無法讀取已儲存的範本檔案, 自訂操作 會什麼都不列,執行動作會停止並在狀態列顯示訊息,範本總管會說出問題所在,而不是直接覆蓋檔案。