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

Artigo
10/20/2023

Aplica-se a:Banco de Dados SQL do Azure Instâ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	Instância Gerida do SQL	SQL Server nas Máquinas Virtuais do Azure
Criar	Portal	Portal	Portal
	CLI	CLI
	PowerShell	PowerShell	PowerShell
Configurar	Regra de firewall IP no nível do servidor	Conectividade de uma VM
		Conectividade local	Conectar-se a uma instância do SQL Server
Carregar dados	Wide World Importadores carregados por início rápido	Restaurar Wide World Importadores	Restaurar Wide World Importadores
		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 neste artigo foram escritos para usar o banco de dados da Adventure Works. Com uma instância gerenciada SQL, importe o banco de dados Adventure Works para um banco de dados de instância ou modifique os scripts neste artigo para usar o banco de dados Wide World Imported.

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 do servidor ou nome do host totalmente qualificado, nome do banco de dados e informações de entrada para os próximos procedimentos.

Inicie sessão no portal do Azure.
Navegue até a página Bancos de dados SQL ou Instâncias Gerenciadas SQL .
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

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

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

Em um prompt de comando, execute o seguinte comando:
```
ruby sqltest.rb
```
Verifique se as 20 principais linhas de Categoria/Produto do seu banco de dados são retornadas.

Próximos passos

Projetar seu primeiro banco de dados no Banco de Dados SQL do Azure
Repositório do GitHub para TinyTDS
Report issues or ask questions about TinyTDS (Comunicar problemas ou fazer perguntas sobre o TinyTDS)
Driver Ruby para SQL Server