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

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

适用于:Azure SQL 数据库Azure SQL 托管实例

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

先决条件

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

获取服务器连接信息

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

  1. 登录 Azure 门户。

  2. 导航到“SQL 数据库”或“SQL 托管实例”页。

  3. 在概述页上,对于 Azure SQL 数据库中的数据库,请查看服务器名称旁边的完全限定服务器名称;对于 Azure SQL 托管实例或虚拟机上的 SQL Server,请查看主机旁边的完全限定服务器名称(或 IP 地址)。 若要复制服务器名称或主机名称,请将鼠标悬停在其上方,然后选择“复制”图标。

注意

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

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

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

  2. 添加以下代码。 将 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
    

    本文中的代码示例使用 AdventureWorks2025、AdventureWorksDW2025 或 AdventureWorksLT2025 示例数据库,您可以从 Azure Data SQL Samples Repository GitHub 存储库下载这些数据库。

运行代码

  1. 请在命令提示符处运行以下命令:

    ruby sqltest.rb
    
  2. 验证是否返回了数据库中的前 20 个类别/产品行。