通过

Visual Studio Code 的 mssql 扩展

  • 项目

本文介绍如何使用 Visual Studio Code (VS Code) 的 mssql 扩展来处理 Windows、macOS 和 Linux 上的 SQL Server 中的数据库，以及 Azure SQL 数据库和 Azure SQL 托管实例。 Visual Studio Code 的 mssql 扩展为 Azure SQL 和 SQL Server 提供查询功能，并为开发人员提供 SQL 项目和 Azure Functions 的 SQL 绑定的其他功能。 VS Code 的 mssql 扩展包括 SQL 数据库项目扩展。

功能概述

VS Code 的 mssql 扩展中提供了以下功能：

  • 连接到 Microsoft SQL Server、Azure SQL 数据库、Azure SQL 托管实例和 Azure Synapse Analytics 专用 SQL 池。
  • 创建和管理连接配置文件和最近使用的连接。
  • 使用 IntelliSense、转到定义、T-SQL 代码片段、语法着色、T-SQL 错误验证和 GO 批处理分隔符编写 T-SQL 脚本。
  • 执行脚本并在易于使用的网格中查看结果。
  • 访问执行的查询历史记录。
  • 将结果保存为 json 或 csv 文件格式并在编辑器中查看。
  • 可自定义的扩展选项，包括命令快捷方式等。
  • 使用 SQL 绑定创建 Azure Functions。

比较 Azure Data Studio 和 mssql 扩展

Azure Data Studio 和 VS Code 的 mssql 扩展均适用于 Windows、macOS 和 Linux。

在 VS Code 中处理 Azure SQL 和 SQL Server 的好处包括：

  • 可用于 SQL 和其他代码（例如 C#、Python、JavaScript、Java、PHP 和 Go）的单一代码编辑器。
  • 广泛的扩展市场，具有用于远程开发、容器等的扩展。
  • 可用于 GitHub Codespaces。

如果希望从以下功能中获益，则除了 VS Code 的 mssql 扩展之外，还可以考虑使用 Azure Data Studio：

  • 快速创建图表和直观显示结果集
  • 图形表设计器和查询计划。
  • 数据库、SQL 项目和 dacpacs 的架构比较。
  • SQL 代理、SQL Profiler 和平面文件导入的扩展。
  • SQL 和 .NET 交互式笔记本。

VS Code 中的 mssql 扩展入门

安装 mssql 扩展

若要在 VS Code 中安装 mssql 扩展，请执行以下步骤：

  1. 在计算机上下载并安装 Visual Studio Code。

  2. 在 Visual Studio Code 中，选择“查看”>“命令面板”，或按“Ctrl”+“Shift”+“P”，或按“F1”打开“命令面板” 。

  3. 在“命令面板”中，从下拉列表中选择“扩展: 安装扩展” 。

  4. 在“扩展”窗格中，键入“mssql”。

  5. 选择“SQL Server (mssql)”扩展，然后选择“安装”。

    Visual Studio Code 的屏幕截图，安装 mssql 扩展。

  6. 安装完成后，选择“重新加载”以启用扩展。

连接和查询

若要连接到 SQL 实例并查询数据库，请执行以下步骤：

  1. 在“SQL Server”窗格中，从“连接”Viewlet 中选择“添加连接”连接图标（加号）。

  2. 按照提示为新连接配置文件指定属性。 指定每个值后，按“Enter”继续。

    连接属性 说明
    服务器名称或 ADO 连接字符串 指定 SQL Server 实例名称。 使用 localhost 连接到本地计算机上的 SQL Server 实例。 如果要连接到远程 SQL Server，请输入目标 SQL Server 的名称，或它的 IP 地址。 若要连接到 SQL Server 容器，请指定容器主机的 IP 地址。 如果需要指定端口，请使用逗号将其与名称分开。 例如，对于侦听端口 1401 的服务器，请输入 <servername or IP>,1401。

    默认情况下，连接字符串使用端口 1433。 除非修改，否则 SQL Server 的默认实例使用 1433。 如果实例正在侦听 1433，则无需指定端口。

    或者，可以在此处输入数据库的 ADO 连接字符串。
    “数据库名称”（可选） 要使用的数据库。 若要连接到默认数据库，请不要在此处指定数据库名称。
    身份验证类型 选择“集成”或“SQL 登录”。
    用户名 如果选择了“SQL 登录”，则输入拥有访问服务器上数据库权限的用户名。
    密码 输入指定用户的密码。
    保存密码 按“Enter”选择“是”并保存密码。 选择“否”，系统将在每次使用连接配置文件时提示输入密码。
    “配置文件名称”（可选） 键入连接配置文件的名称，例如 localhost 配置文件。

    输入所有值并选择“Enter”后，Visual Studio Code 将创建连接配置文件并连接到 SQL Server。

    如果初始连接尝试失败，并启用了加密（默认），mssql 扩展将提供通知提示，其中包含在启用信任服务器证书的情况下尝试连接的选项。 有关此选项的详细信息，请参阅连接教程。

支持的操作系统

Windows、macOS 和 Linux 支持 VS Code 的 mssql 扩展。 支持以下版本：

  • Windows：7（带 SP1）8、8.1、10、11
  • Windows Server: 2016, 2019, 2022
  • macOS: 10.12+, 11, 12
  • Linux: Debian 9+, RHEL 7+, Ubuntu 18.04+

SQL 工具服务

mssql 扩展会自动安装 SQL 工具服务，这是一种基于 .NET 的开源 API，可为多种 SQL 工具提供服务，包括 Azure Data Studio 和 VS Code 的 mssql 扩展。 SQL 工具服务提供公共语言服务操作（IntelliSense 自动完成建议、速览定义、SQL 错误诊断、快速信息悬停）、连接管理和查询执行等功能。 GitHub 上提供了 SQL 工具服务的源代码。

后续步骤