Compartilhar via


Início Rápido: Usar o Ruby para consultar um banco de dados no Banco de Dados SQL do Azure ou na Instância Gerenciada de SQL do Azure

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

Este início rápido demonstra como usar o 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ê precisará dos seguintes pré-requisitos:

Obter informações de conexão do servidor

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

  1. Entre no portal do Azure.

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

  3. Na página Visão geral, examine o nome do servidor totalmente qualificado ao lado de Nome do servidor de 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 obter uma Instância Gerenciada de SQL do Azure ou um SQL Server em Máquinas Virtuais. Para copiar o nome do servidor ou o nome do host, passe o mouse sobre ele e selecione o ícone Copiar.

Observação

Para obter informações de conexão do SQL Server em Máquinas Virtuais do Azure, confira 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 de códigos, crie um arquivo chamado sqltest.rb.

  2. Adicione o código seguinte: Substitua os valores do seu banco de dados no Banco de Dados SQL do Azure para <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
    

    Os exemplos de código do Transact-SQL deste artigo usa o banco de dados de exemplo AdventureWorks2022 ou AdventureWorksDW2022, que pode ser baixado da home page Microsoft SQL Server Samples and Community Projects.

Executar o código

  1. No prompt de comando, execute o comando a seguir:

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

Próximas etapas