共用方式為


針對 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 資料夾] 命令以開啟記錄的路徑。 有許多不同類型的記錄檔會寫入在該處。 這是一些常用的項目:

  1. renderer#.log (例如 renderer1.log):此檔案是主要程序的記錄檔。
  2. telemetry.log:將記錄層級設為 Trace 時,此檔案將包含 Azure Data Studio 所傳送的遙測事件
  3. exthost#/exthost.log:延伸模組主機程序的記錄檔 (這只是程序本身,而不是在其中執行的延伸模組)
  4. exthost#/Microsoft.mssql:mssql 延伸模組的記錄,其中包含 MSSQL 相關功能的許多核心邏輯
    • sqltools.log 是 SQL 工具服務的記錄
  5. exthost#/output_logging_#######:這些資料夾均包含 Azure Data Studio 的 Output 面板中所顯示的訊息。 將每個檔案命名為 #-<Channel Name>。 例如,Notebooks 輸出通道可能會輸出到名為 3-Notebooks.log 的檔案。

如果系統要求您提供記錄,請壓縮整個資料夾,以確保會包含正確的記錄。

在當機後復原編輯器檔案

如果 Azure Data Studio 意外當機,重新啟動 Azure Data Studio 也應該會重新開啟任何未儲存的編輯器檔案。 如果沒有,嘗試重新開啟它們時可能發生錯誤。 在此情況下,請遵循下列步驟,瀏覽至包含備份的資料夾,您可以在其中手動開啟備份以復原其內容。

  1. 從 [命令選擇區] (Ctrl/Cmd + Shift + P),執行 [開發人員:開啟使用者資料資料夾] 命令。
  2. 在開啟的資料夾中,瀏覽至 Backups 資料夾。

這包含具有隨機產生的名稱的資料夾。 在這些資料夾內,是包含編輯器備份的檔案 (其中包含一些額外的中繼資料及其文字內容)。

下一步