你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

快速入门：使用 Ruby 查询 Azure SQL 数据库中的数据库或 Azure SQL 托管实例

2025-06-17

本快速入门演示了如何使用 Ruby 连接到数据库并使用 Transact-SQL 语句查询数据。

先决条件

若要完成本快速入门，需要具备以下先决条件：

数据库。可以使用以下某个快速入门创建数据库，然后对其进行配置：

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

重要

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

若要为操作系统安装 Ruby 和相关软件，请参阅配置用于 Ruby 开发的开发环境。

获取服务器连接信息

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

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

注意

有关 Azure 虚拟机上的 SQL Server 的连接信息，请参阅连接到 SQL Server 实例。

创建用于查询 Azure SQL 数据库中的数据库的代码

在文本或代码编辑器中，创建新文件 sqltest.py。

添加以下代码。将 Azure SQL 数据库中的数据库的值替换为<server>、<database>、<username> 和 <password>。

require 'tiny_tds'
server = '<server>.database.windows.net'
database = '<database>'
username = '<username>'
password = '<password>'
client = TinyTds::Client.new username: username, password: password,
    host: server, port: 1433, database: database, azure: true

puts "Reading data from table"
tsql = "SELECT TOP 20 pc.Name as CategoryName, p.name as ProductName
        FROM [SalesLT].[ProductCategory] pc
        JOIN [SalesLT].[Product] p
        ON pc.productcategoryid = p.productcategoryid"
result = client.execute(tsql)
result.each do |row|
    puts row
end

本文中的代码示例使用 AdventureWorks2022 或 AdventureWorksDW2022 示例数据库，可以从 Microsoft SQL Server 示例和社区项目主页下载该数据库。

运行代码

请在命令提示符处运行以下命令：
```
ruby sqltest.rb
```
验证是否返回了数据库中的前 20 个类别/产品行。

反馈

此页面是否有帮助？