Azure Data Studio 连接Azure SQL数据库时找不到数据库的解决方案

在使用Azure Data Studio连接Azure SQL数据库时，部分用户可能会遇到一个常见问题：成功添加Azure账户并授权后，在连接Microsoft SQL Server数据库时，数据库列表中仅显示<default>选项，而无法看到实际存在的数据库。本文将深入分析该问题的成因，并提供详细的解决方案。

问题现象

当用户尝试通过Azure Data Studio连接Azure SQL数据库时，会出现以下典型症状：

1. 能够正常添加Azure账户并通过浏览器完成授权
2. 在连接配置界面，数据库下拉列表中仅显示<default>选项
3. 无法看到订阅中实际存在的任何数据库
4. 问题在禁用所有扩展的情况下依然存在

根本原因

此问题通常与Azure身份验证令牌缓存有关。当Azure Data Studio存储的身份验证令牌过期或损坏时，虽然表面上看授权过程正常完成，但实际上无法获取完整的数据库列表信息。

解决方案

要彻底解决此问题，需要执行以下步骤：

1. 清除现有Azure账户

   • 在Azure Data Studio中移除当前已添加的Azure账户

2. 清理令牌缓存

   • 手动删除Azure Data Studio存储的身份验证令牌缓存文件
   • 在macOS系统中，这些文件通常位于用户目录下的特定缓存文件夹中

3. 重新登录Azure账户

   • 再次添加Azure账户
   • 通过浏览器完成完整的授权流程

4. 验证连接

   • 尝试重新连接SQL Server
   • 此时应该能够看到完整的数据库列表

预防措施

为避免此类问题再次发生，建议：

• 定期更新Azure Data Studio到最新版本
• 避免在多个设备上同时使用同一Azure账户
• 在遇到身份验证问题时，首先尝试清除缓存而非重复登录

总结

Azure Data Studio连接Azure SQL数据库时出现的数据库列表缺失问题，通常与身份验证令牌缓存异常有关。通过彻底清除现有账户和令牌缓存，然后重新建立连接，可以有效解决这一问题。对于经常使用Azure Data Studio连接云端数据库的用户，了解这一解决方案可以节省大量故障排除时间。