使用 Ruby 查询 Azure SQL 数据库

此快速入门演示如何使用 Ruby 来创建连接到 Azure SQL 数据库的程序,并使用 Transact-SQL 语句来查询数据。

先决条件

若要完成本快速入门,请确保符合以下先决条件:

SQL Server 连接信息

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

  1. 登录到 Azure 门户
  2. 从左侧菜单中选择“SQL 数据库”,并单击“SQL 数据库”页上的数据库。
  3. 在数据库的“概览”页上,查看如下图所示的完全限定的服务器名称。 将鼠标悬停在服务器名称上即可打开“通过单击进行复制”选项。

    server-name

  4. 如果忘了服务器的登录信息,请导航到 SQL 数据库服务器页,以查看服务器管理员名称。 如有必要,请重置密码。

Important

对于在其上执行本教程操作的计算机,必须为其公共 IP 地址制定防火墙规则。 如果使用其他计算机或其他公共 IP 地址,则使用 Azure 门户创建服务器级防火墙规则

插入用于查询 SQL 数据库的代码

  1. 在常用的文本编辑器中创建一个新文件 sqltest.rb

  2. 将内容替换为以下代码,为服务器、数据库、用户和密码添加相应的值。

require 'tiny_tds'
server = 'your_server.database.chinacloudapi.cn'
database = 'your_database'
username = 'your_username'
password = 'your_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

运行代码

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

    ruby sqltest.rb
    
  2. 验证是否已返回前 20 行,然后关闭应用程序窗口。

后续步骤