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:

• Um banco de dados. Você pode usar um dos seguintes guias de início rápido para criar e configurar o banco de dados:

  Ação	Banco de Dados SQL	Instância Gerenciada do SQL	SQL Server em Máquinas Virtuais do Azure
  Criar	Portal	Portal	Portal
  	CLI	CLI
  	PowerShell	PowerShell	PowerShell
  Configurar	Regra de firewall de IP no nível do servidor	Conectividade de uma VM
  		Conectividade do local	Conectar-se a uma Instância do SQL Server
  Carregar dados	Importadores do mundo inteiro carregados por início rápido	Restaurar o Wide World Importers	Restaurar o Wide World Importers
  		Restaurar ou importar o Adventure Works de um arquivo BACPAC do GitHub	Restaurar ou importar o Adventure Works de um arquivo BACPAC do GitHub

  Importante

  Os scripts deste artigo são escritos para usar o banco de dados do Adventure Works. Com uma Instância Gerenciada de SQL, importe o banco de dados Adventure Works para um banco de dados de instância ou modifique os scripts deste artigo para usar o banco de dados Wide World Importers.

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

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.

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

• Criar seu primeiro banco de dados no Banco de Dados SQL do Azure
• Repositório GitHub do TinyTDS
• Relatar problemas ou fazer perguntas sobre o TinyTDS
• Ruby Driver para SQL Server