改善流程

功能性的

當自動完成建議不準確時,按下 F2;你的回報可以成為確保修正持續有效的測試。

自動完成在接上實際工作後會越來越好。如果建議錯了、漏了或太吵,請按 F2 在清單開啟時擷取發生的事。一份有用的報告會成為 回歸測試,讓修正更有機會保持修好的狀態。

何時按下 F2

當建議清單顯示在螢幕上時,其下方會有一個小提示寫著 想改善這一點,請按 F2。你也可以點擊提示本身。使用的好時機包括:

  • 右側缺少對應的項目 - 例如你知道存在的欄位,或是一張應該遵循 JOIN.
  • 順序錯誤 - 明顯正確的選項反而被埋在一堆不太可能的選項底下。
  • 清單裡全是雜訊 - 例如在只該出現欄位的地方卻建議了資料表。
  • 沒有任何建議。 空清單會顯示為 沒有建議 — 按 F2 協助改進此功能。這通常是最有用的一份報告。按下 Ctrl+空格 手動開啟清單,然後 F2.

F2 是預設值。你可以在 鍵盤快速鍵,其中的動作是 改善 IntelliSense(收集意見回饋).

意見回饋對話方塊

SQLly
SQLly IntelliSense 意見回饋擷取對話方塊SQLly IntelliSense 意見回饋擷取對話方塊
F2 意見回饋對話方塊:你輸入的內容、建議內容以及你的預期——準備提交。

對話方塊顯示你的查詢以及插入點位置、系統提供的建議,還有你的資料模型樹。你的查詢位於唯讀文字框中,因此你可以選取並複製其中的任何部分。其游標從編輯器插入點所在位置開始,標題會以 行:列 的格式顯示該位置。唯一需要的事情是:寫一條說明應該提供什麼的註解。 它應該提供什麼? 文字框在對話方塊開啟時就會顯示閃爍的插入點,你可以立刻開始輸入。好的備註會寫明你預期的項目和預期出現的位置,例如 之後 FROM dbo.Orders o JOIN 我預期 dbo.Customers 第一個.

  • 資料模型名稱。 你的陳述式所參照的物件一開始就會勾選。資料表、檢視和程序可隨意勾選或取消勾選,也可以搜尋樹狀結構。構成你收到的建議的物件會維持勾選,因為從你的報告建立的測試需要它們。只會傳送名稱,絕不傳送資料。
  • 全部包含。 傳送整個連線的資料模型(僅名稱)。除非你開啟,否則預設為關閉。 預設在 IntelliSense 回饋中包含完整資料模型 在 設定 › 編輯器 › 一般.
  • 關聯鏈。 可選。為你納入的資料表加入多段外鍵鏈,例如 Orders → Customers → Regions。
  • 遮罩常值。 預設關閉,此時查詢會以輸入的原樣送出。開啟後,會先將字串字面值與註解取代為 <redacted> 。詳見 隱私.

報告接下來會怎麼樣

  1. 擷取 (F2)。 SQLly 會儲存你的查詢、游標位置、建議清單當下的樣子(含當時反白的那一項)、清單的開啟方式、你的 IntelliSense 規則,以及應用程式設定。如果清單當時有建議,還會一併附上螢幕截圖。你的連線憑證或 API 金鑰都不會包含在內。
  2. 檢閱。 你可以選擇要附上的資料模型名稱以及是否遮蔽字面值。對話方塊會顯示將要發送的內容。
  3. 簽署並傳送。 送出時,報告會先存到本機檔案再上傳。上傳失敗的話,SQLly 會在下一次啟動時重試,之後每五分鐘再試一次,而且永不放棄。每份報告都有自己的 ID,重試不會重複送出。
  4. 分類排查。 提交的內容會進入管理員佇列等待審查。
  5. 把它鎖定下來。 獲採納的報告會成為專屬驗證套件中的案例:一個會一直失敗、直到修正正確完成為止的真實測試。
  6. 已發布。 修復發布後,你在網站「意見回饋」頁面上的報告就會顯示 於 vX.Y.Z 實作 並附上修復它的版本。當該版本標記發布時,報告會自動標記。

想看看開發團隊收到的 IntelliSense 回饋報告長什麼樣嗎? 點擊這裡檢視真實的唯讀範例,其中的 ID 已被遮蔽。

隱私至上。 意見回饋只包含重現自動完成行為所需的資訊:資料模型僅限你選擇的名稱,你可以遮蔽字面值,連線憑證與 API 金鑰一律不會包含在內。