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 AzureInstância Gerenciada SQL do 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:

• Uma base de dados. Você pode usar um destes guias de início rápido para criar e configurar o banco de dados:

  Ação	Base de Dados SQL	SQL Managed Instance	SQL Server em Máquinas Virtuais do Azure
  Criar	Portais	Portais	Portais
  	CLI	CLI
  	PowerShell	PowerShell	PowerShell
  Configurar	Regra de firewall IP no nível do servidor	Conectividade de uma VM
  		Conectividade a partir de instalações no local	conectar-se a uma instância do SQL Server
  Carregar dados	Wide World Importers carregado pelo Quickstart	Restore Importadores de Grande Alcance Mundial	Restore Importadores de Grande Alcance Mundial
  		Restaurar ou importar o Adventure Works de um arquivo de BACPAC do GitHub	Restaurar ou importar o Adventure Works de um arquivo de BACPAC do GitHub

  Importante

  Os scripts neste artigo foram escritos para usar o banco de dados da Adventure Works. Com uma Instância Gerida SQL, importe a base de dados Adventure Works para uma base de dados da instância ou modifique os scripts neste artigo para usar a base de dados Wide World Importers.

• Para instalar o Ruby e o software relacionado para seu sistema operacional, consulte Configurar o ambiente de desenvolvimento para desenvolvimento em Ruby.

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 completo do servidor ou do host, do nome do banco de dados e das informações de início de sessão para os próximos procedimentos.

1. Inicie sessão no portal 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.

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
   

   Os exemplos de código neste artigo usam o banco de dados de exemplo AdventureWorks2025 ou AdventureWorksDW2025, que pode ser descarregado da página inicial de Exemplos e Projetos da Comunidade do Microsoft SQL Server.

Execute 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.

Conteúdo relacionado

• Tutorial: Criar um banco de dados relacional no Banco de Dados SQL do Azure
• Repositório GitHub para TinyTDS
• Denuncie problemas ou faça perguntas sobre o TinyTDS
• Driver Ruby para SQL Server