Avvio rapido: usare Ruby per eseguire query su un database nel database SQL di Azure o nell'istanza gestita di SQL di Azure

Si applica a:Database SQL di AzureIstanza gestita di SQL di Azure

Questa guida di avvio rapido illustra come usare Ruby per connettersi a un database ed eseguire query sui dati tramite istruzioni Transact-SQL.

Prerequisiti

Per completare questa guida introduttiva è necessario soddisfare i prerequisiti seguenti:

• Database. Per creare, quindi configurare il database è possibile usare una di queste guide di avvio rapido:

  Azione	Database SQL	Istanza gestita di SQL	SQL Server in Macchine virtuali di Azure
  Creazione	Portale	Portale	Portale
  	CLI	CLI
  	PowerShell	PowerShell	PowerShell
  Configurazione	Regola del firewall IP a livello di server	Connettività da una VM
  		Connettività dall'ambiente locale	Connettersi a un'istanza di SQL Server
  Caricare i dati	Caricamento di Wide World Importers per l’avvio rapido	Ripristinare Wide World Importers	Ripristinare Wide World Importers
  		Ripristinare o importare i dati di Adventure Works dal file BACPAC ottenuto da GitHub	Ripristinare o importare i dati di Adventure Works dal file BACPAC ottenuto da GitHub

  Importante

  Gli script di questo articolo sono scritti in modo da usare il database Adventure Works. Con un'istanza gestita di SQL, è necessario importare il database Adventure Works in un database dell'istanza oppure modificare gli script di questo articolo per usare il database Wide World Importers.

• Per l'installazione di Ruby e del software correlato per il sistema operativo, vedere Configurare l'ambiente di sviluppo per lo sviluppo di Ruby.

Recuperare le informazioni di connessione del server

Recuperare le informazioni necessarie per connettersi a un database nel database SQL di Azure. Nelle procedure successive saranno necessari il nome completamente qualificato del server o il nome host, il nome del database e le informazioni di accesso.

1. Accedere al portale di Azure.

2. Passare alla pagina Database SQL o Istanze gestite di SQL.

3. Nella pagina Panoramica verificare il nome completo del server accanto a Nome server per il database nel database SQL di Azure o il nome del server completamente qualificato (o l'indirizzo IP) accanto a Host per un'istanza gestita di SQL di Azure o di SQL Server in una macchina virtuale. Per copiare il nome del server o il nome host, passare il puntatore su di esso e selezionare l'icona Copia.

Creare il codice per eseguire query sul database nel database SQL di Azure

1. In un editor di testo o di codice creare un nuovo file denominato sqltest.rb.

2. Aggiungi il seguente codice. Sostituire <server>, <database>, <username> e <password> con i valori corrispondenti del database nel database SQL di Azure.

   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
   

   Per l'articolo è necessario il database di esempio AdventureWorks2022, che è possibile scaricare dalla home page del sito relativo a progetti della community ed esempi per Microsoft SQL Server.

Eseguire il codice

1. Al prompt dei comandi, eseguire il seguente comando:

   ruby sqltest.rb
   

2. Verificare che vengano restituite le prime 20 righe di categoria/prodotto del database.

Passaggi successivi

• Progettare il primo database nel database SQL di Azure
• Repository GitHub per TinyTDS
• Segnalare problemi o porre domande su TinyTDS
• Driver Ruby per SQL Server