Quickstart: Ruby gebruiken om een query uit te voeren op een database in Azure SQL Database of Azure SQL Managed Instance

Van toepassing op: Azure SQL DatabaseAzure SQL Managed Instance

In deze quickstart wordt gedemonstreerd hoe u Ruby gebruikt om verbinding te maken met een database en hoe u met Transact-SQL-instructies een query uitvoert voor de gegevens.

Vereisten

Voor het voltooien van deze snelstart moet aan de volgende vereisten worden voldaan:

• Een database. U kunt een van deze quickstarts gebruiken om de database te maken en vervolgens te configureren:

  Actie	SQL Database	SQL Managed Instance	SQL Server op virtuele machines in Azure
  Maken	Portal	Portal	Portal
  	CLI	CLI
  	PowerShell	PowerShell	PowerShell
  Configureren	IP-firewallregel op serverniveau	Connectiviteit vanaf een VM
  		Connectiviteit vanaf on-premises	Verbinding maken met een SQL Server-exemplaar
  Gegevens laden	Wide World Importers geladen per quickstart	Wide World Importers herstellen	Wide World Importers herstellen
  		Adventure Works herstellen of importeren vanuit een BACPAC-bestand vanaf GitHub	Adventure Works herstellen of importeren vanuit een BACPAC-bestand vanaf GitHub

  Belangrijk

  De scripts in dit artikel zijn geschreven voor gebruik met de Adventure Works-database. Met een SQL Managed Instance importeert u de Adventure Works-database in een exemplaardatabase of wijzigt u de scripts in dit artikel om de Wide World Importers-database te gebruiken.

• Zie Ontwikkelomgeving configureren voor Ruby-ontwikkeling voor Ruby-ontwikkeling voor het installeren van Ruby en gerelateerde software voor uw besturingssysteem.

Serververbindingsgegevens ophalen

Haal de informatie op die u nodig hebt om verbinding te maken met een database in Azure SQL Database. Voor de komende procedures hebt u de volledig gekwalificeerde servernaam of hostnaam, databasenaam en aanmeldingsgegevens nodig.

1. Meld u aan bij de Azure-portal.

2. Navigeer naar de pagina SQL-databases of Met SQL beheerde exemplaren.

3. Controleer op de pagina Overzicht de volledig gekwalificeerde servernaam naast servernaam voor een database in Azure SQL Database of de volledig gekwalificeerde servernaam (of het IP-adres) naast Host voor een beheerd exemplaar van Azure SQL of SQL Server op virtuele machines. Als u de servernaam of hostnaam wilt kopiëren, plaatst u de muisaanwijzer erop en selecteert u het pictogram Kopiëren.

Notitie

Zie Verbinding maken naar een SQL Server-exemplaar voor verbindingsgegevens voor SQL Server op Azure Virtual Machines.

Code maken om query's uit te voeren op uw database in Azure SQL Database

1. Maak in een tekst- of code-editor een nieuw bestand met de naam sqltest.rb.

2. Voeg de volgende code toe: Vervang de waarden van uw database in Azure SQL Database door <server>, <database>, <username> en <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
   

   Voor dit artikel is de AdventureWorks2022 voorbeelddatabase vereist, die u kunt downloaden van de startpagina van Microsoft SQL Server Samples en Community Projects .

De code uitvoeren

1. Voer de volgende opdracht uit op een opdrachtprompt:

   ruby sqltest.rb
   

2. Controleer of de bovenste twintig rijen voor Categorie/Product in uw database worden geretourneerd.

Volgende stappen

• Uw eerste database ontwerpen in Azure SQL Database
• GitHub-opslagplaats voor TinyTDS
• Problemen melden of vragen over TinyTDS stellen
• Ruby-stuurprogramma voor SQL Server