通过

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) 中，运行“开发人员: 打开日志文件夹”命令以打开日志的路径。 有许多不同类型的日志文件可以写入其中。 一些常用的运算符和修饰符包括：

  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 文件夹。

该文件夹中包含具有随机生成名称的文件夹。 这些文件夹中的文件包含编辑器备份（其中包括一些其他元数据及其文本内容）。

后续步骤