快速入门：使用 Visual Studio Code 连接到并查询 Azure SQL 数据库或 Azure SQL 托管实例

项目
08/12/2024

Visual Studio Code 是一种图形代码编辑器，适用于 Linux、macOS 和 Windows。它支持各种扩展，其中包括 mssql 扩展（用于查询 SQL Server、Azure SQL 数据库、Azure SQL 托管实例和 Azure Synapse Analytics 中的数据库）。在本快速入门中，使用 Visual Studio Code 连接到 Azure SQL 数据库或 Azure SQL 托管实例，然后运行 Transact-SQL 语句以查询、插入、更新和删除数据。

先决条件

Azure SQL 数据库或 Azure SQL 托管实例中的数据库。可以根据下述快速入门之一，在 Azure SQL 数据库中创建数据库，然后对其进行配置：

操作	Azure SQL Database	Azure SQL 托管实例
创建	Portal	Portal
	CLI	CLI
	PowerShell	PowerShell
配置	服务器级别 IP 防火墙规则	来自虚拟机 (VM) 的连接
		来自本地的连接
加载数据	按快速入门加载的 Wide World Importers	还原 Wide World Importers
		从 GitHub 所提供的 BACPAC 文件还原或导入 Adventure Works

重要

本文中脚本的编写目的是使用 Adventure Works 数据库。使用 SQL 托管实例时，必须将 Adventure Works 数据库导入一个实例数据库，或者修改本文中的脚本，以便使用 Wide World Importers 数据库。

安装 Visual Studio Code

请确保安装了 Visual Studio Code 的最新版本。有关安装指南，请参阅安装 Visual Studio Code。

配置 Visual Studio Code

Windows

按照以下步骤加载 mssql 扩展：

打开 Visual Studio Code。
打开“扩展”窗格（或 Ctrl + Shift + X）。
搜索 sql 并安装“SQL Server (mssql)” 扩展。

有关其他安装指南，请参阅适用于 Visual Studio Code 的 mssql。

macOS

对于 macOS，需安装 OpenSSL，这是 mssql 扩展所使用的 .NET Core 的先决条件。打开终端并输入以下命令，以便安装 brew 和 OpenSSL。

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
brew update
brew install openssl
mkdir -p /usr/local/lib
ln -s /usr/local/opt/openssl/lib/libcrypto.1.0.0.dylib /usr/local/lib/
ln -s /usr/local/opt/openssl/lib/libssl.1.0.0.dylib /usr/local/lib/

Linux (Ubuntu)

按照以下步骤加载 mssql 扩展：

打开 Visual Studio Code。
打开“扩展”窗格（或 Ctrl + Shift + X）。
搜索 sql 并安装“SQL Server (mssql)” 扩展。

有关其他安装指南，请参阅适用于 Visual Studio Code 的 mssql。

获取服务器连接信息

获取连接到 Azure SQL 数据库所需的连接信息。在后续过程中，将需要完全限定的服务器名称或主机名称、数据库名称和登录信息。

登录 Azure 门户。
导航到“SQL 数据库”或“SQL 托管实例”页。
在“概览”页中，查看 SQL 数据库的“服务器名称”旁边的完全限定的服务器名称，或者 SQL 托管实例的“主机”旁边的完全限定的服务器名称。若要复制服务器名称或主机名称，请将鼠标悬停在其上方，然后选择“复制”图标。

将语言模式设置为 SQL

在 Visual Studio Code 中，将语言模式设置为 SQL，以便启用 mssql 命令和 T-SQL IntelliSense。

打开新的 Visual Studio Code 窗口。
按 Ctrl + N。此时会打开一个新的纯文本文件。
选择状态栏右下角的“纯文本”。
在打开的“选择语言模式”下拉列表中，选择“SQL”。

连接到数据库

使用 Visual Studio Code 建立到服务器的连接。

重要

在继续之前，请确保服务器和登录信息已准备就绪。在开始输入连接配置文件信息的情况下，如果在 Visual Studio Code 中更改焦点，则需重新开始创建配置文件。

在 Visual Studio Code 中，按 Ctrl + Shift + P（或 F1）打开命令面板。
键入 connect 并选择“MS SQL:Connect”。
选择“+ 创建连接配置文件”。

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

properties	建议值	说明
服务器名称	完全限定的服务器名称	类似于：mynewserver20170313.database.chinacloudapi.cn。
数据库名称	mySampleDatabase	要连接到的数据库。
身份验证	SQL 登录名	本教程使用 SQL 身份验证。
用户名	用户名	用于创建服务器的服务器管理员帐户的用户名。
密码(SQL 登录名)	密码	用于创建服务器的服务器管理员帐户的密码。
是否保存密码？	是或否	如果不想每次都输入密码，请选择“是”。
输入此配置文件的名称	配置文件名称，例如 mySampleProfile	保存配置文件可以在后续登录时加快连接速度。

如果成功，会显示通知，指出已创建并连接配置文件。

查询数据

运行以下 SELECT Transact-SQL 语句，按类别查询排名前 20 的产品。

在编辑器窗口中，粘贴以下 SQL 查询。

SELECT pc.Name AS CategoryName,
    p.name AS ProductName
FROM [SalesLT].[ProductCategory] pc
INNER JOIN [SalesLT].[Product] p
    ON pc.ProductCategoryId = p.ProductCategoryId;

按 Ctrl + Shift + E 来运行查询并显示来自 Product 和 ProductCategory 表的结果。

插入数据

运行以下 INSERT Transact-SQL 语句来向 SalesLT.Product 表中添加新产品。

将之前的查询替换为此查询。

INSERT INTO [SalesLT].[Product] (
    [Name],
    [ProductNumber],
    [Color],
    [ProductCategoryID],
    [StandardCost],
    [ListPrice],
    [SellStartDate]
 )
 VALUES (
    'myNewProduct',
    123456789,
    'NewColor',
    1,
    100,
    100,
    GETDATE()
 );

按 Ctrl + Shift + E 在 Product 表中插入新行。

更新数据

运行以下 UPDATE Transact-SQL 语句来更新已添加的产品。

将之前的查询替换为此查询：

UPDATE [SalesLT].[Product]
SET [ListPrice] = 125
WHERE Name = 'myNewProduct';

按 Ctrl + Shift + E 更新 Product 表中的指定行。

删除数据

运行以下 DELETE Transact-SQL 语句来删除新产品。