Partilhar via


Guia de início rápido: usar Ruby para consultar um banco de dados no Banco de Dados SQL do Azure ou na Instância Gerenciada SQL do Azure

Aplica-se a:Banco de Dados SQL do Azure Instância Gerenciada SQLdo Azure

Este guia de início rápido demonstra como usar Ruby para se conectar a um banco de dados e consultar dados com instruções Transact-SQL.

Pré-requisitos

Para concluir este início rápido, você precisa dos seguintes pré-requisitos:

Obter informações de conexão do servidor

Obtenha as informações necessárias para se conectar a um banco de dados no Banco de Dados SQL do Azure. Você precisará do nome do servidor ou nome do host totalmente qualificado, nome do banco de dados e informações de entrada para os próximos procedimentos.

  1. Inicie sessão no portal do Azure.

  2. Navegue até a página Bancos de dados SQL ou Instâncias Gerenciadas SQL .

  3. Na página Visão Geral, revise o nome do servidor totalmente qualificado ao lado de Nome do servidor para um banco de dados no Banco de Dados SQL do Azure ou o nome do servidor totalmente qualificado (ou endereço IP) ao lado de Host para uma Instância Gerenciada SQL do Azure ou SQL Server em Máquinas Virtuais. Para copiar o nome do servidor ou do host, passe o mouse sobre ele e selecione o ícone Copiar .

Nota

Para obter informações de conexão para o SQL Server em Máquinas Virtuais do Azure, consulte Conectar-se a uma instância do SQL Server.

Criar código para consultar seu banco de dados no Banco de Dados SQL do Azure

  1. Em um editor de texto ou código, crie um novo arquivo chamado sqltest.rb.

  2. Adicione o seguinte código. Substitua os valores do seu banco de dados no Banco de Dados SQL do Azure por <server>, , <database><username>e <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
    

    Este artigo requer o AdventureWorks2022 banco de dados de exemplo, que você pode baixar da home page de Exemplos e Projetos da Comunidade do Microsoft SQL Server.

Executar o código

  1. Em um prompt de comando, execute o seguinte comando:

    ruby sqltest.rb
    
  2. Verifique se as 20 principais linhas de Categoria/Produto do seu banco de dados são retornadas.

Próximos passos