針對 Azure Data Studio 進行疑難排解
Azure Data Studio 會針對 azuredatastudio
存放庫,在 GitHub 存放庫問題追蹤器 \(英文\) 上追蹤問題與功能要求。
回報您遇到的問題
將問題回報給 GitHub 問題追蹤器,並提供任何有助於重現該錯誤的詳細資料。 包含來自記錄檔的所有記錄資訊。
撰寫良好的錯誤 (Bug) 報表與功能要求
針對每個問題與功能要求提出單一問題。
- 不要在同一個問題中列舉多個錯誤 (Bug) 或功能要求。
- 除非您的問題來自相同的輸入,否則不要將該問題當成現有問題的註解來新增。 許多問題看起來類似,但原因不同。
您可提供的資訊越多,某人成功重現問題並找出修正方式的可能性就越大。
在每個問題中包含下列資訊:
- Azure Data Studio 的版本
- 可重現的步驟 (1...2...3...),以及您期望的結果與實際看到的內容。
- 影像、動畫或影片的連結。 影像與動畫可說明重現步驟,但無法加以取代。
- 示範問題的程式碼片段或程式碼存放庫的連結,讓我們能夠輕鬆地將其提取到我們的機器上來重建問題。
注意
由於我們需要複製並貼上程式碼片段,因此,以媒體檔案 (也就是 .gif
) 形式包含程式碼片段是不夠的。
- 開發工具主控台中的錯誤 (說明 > 切換開發人員工具)
請記得執行下列步驟:
- 搜尋問題存放庫,以查看是否存在相同的問題。
- 簡化靠近問題的程式碼,以便讓問題能夠浮現出來。
如果我們無法重現該問題並要求更多資訊,請不要有任何不好的感受!
如何設定記錄層級
Azure Data Studio
在命令選擇區 (Ctrl/Cmd + Shift + P) 執行開發人員:設定記錄層級...命令,以選取目前工作階段的記錄層級。 此值不會保存在多個工作階段上。 如果您重新啟動 Azure Data Studio,它會還原回預設的 Info
層級。
如果您想要啟用偵錯記錄以進行啟動,請將記錄層級設定為 Debug
並執行開發人員:重新載入視窗命令。
MSSQL (內建延伸模組)
如果 Mssql: Log Debug Info
使用者設定已設為 True,則偵錯記錄資訊會傳送至 MSSQL
輸出通道。
Mssql: Tracing Level
使用者設定會用來控制記錄的詳細程度。
Azure Data Studio 記錄和位置
從 [命令選擇區] (Ctrl/Cmd + Shift + P) 執行 [開發人員:開啟 Logs 資料夾] 命令以開啟記錄的路徑。 有許多不同類型的記錄檔會寫入在該處。 這是一些常用的項目:
renderer#.log
(例如renderer1.log
):此檔案是主要程序的記錄檔。telemetry.log
:將記錄層級設為Trace
時,此檔案將包含 Azure Data Studio 所傳送的遙測事件exthost#/exthost.log
:延伸模組主機程序的記錄檔 (這只是程序本身,而不是在其中執行的延伸模組)exthost#/Microsoft.mssql
:mssql 延伸模組的記錄,其中包含 MSSQL 相關功能的許多核心邏輯sqltools.log
是 SQL 工具服務的記錄
exthost#/output_logging_#######
:這些資料夾均包含 Azure Data Studio 的Output
面板中所顯示的訊息。 將每個檔案命名為#-<Channel Name>
。 例如,Notebooks
輸出通道可能會輸出到名為3-Notebooks.log
的檔案。
如果系統要求您提供記錄,請壓縮整個資料夾,以確保會包含正確的記錄。
在當機後復原編輯器檔案
如果 Azure Data Studio 意外當機,重新啟動 Azure Data Studio 也應該會重新開啟任何未儲存的編輯器檔案。 如果沒有,嘗試重新開啟它們時可能發生錯誤。 在此情況下,請遵循下列步驟,瀏覽至包含備份的資料夾,您可以在其中手動開啟備份以復原其內容。
- 從 [命令選擇區] (Ctrl/Cmd + Shift + P),執行 [開發人員:開啟使用者資料資料夾] 命令。
- 在開啟的資料夾中,瀏覽至
Backups
資料夾。
這包含具有隨機產生的名稱的資料夾。 在這些資料夾內,是包含編輯器備份的檔案 (其中包含一些額外的中繼資料及其文字內容)。