Snabbstart: Använd Ruby för att fråga en databas i Azure SQL Database eller Azure SQL Managed Instance

Gäller för:Azure SQL DatabaseAzure SQL Managed Instance

Den här snabbstarten visar hur du använder Ruby för att ansluta till en databas och köra frågor mot data med Transact-SQL-instruktioner.

Förutsättningar

För att slutföra den här snabbstarten, behöver du följande förhandskrav:

• En databas. Du kan använda någon av dessa snabbstarter för att skapa och sedan konfigurera databasen:

  Åtgärd	SQL Database	SQL-hanterad instans	SQL Server på Azure Virtual Machines
  Skapa	Portal	Portal	Portal
  	CLI	CLI
  	PowerShell	PowerShell	PowerShell
  Konfigurera	IP-brandväggsregel på servernivå	Anslutning från en virtuell dator
  		Anslut ivitet lokalt	Anslut till en SQL Server-instans
  Läsa in data	Wide World Importers laddade per snabbstart	Återställa Wide World Importers	Återställa Wide World Importers
  		Återställa eller importera Adventure Works från en BACPAC-fil från GitHub	Återställa eller importera Adventure Works från en BACPAC-fil från GitHub

  Viktigt!

  Skripten i den här artikeln skrivs för att använda Adventure Works-databasen. Med en SQL Managed Instance importerar du antingen Adventure Works-databasen till en instansdatabas eller ändrar skripten i den här artikeln för att använda databasen Wide World Importers.

• Information om hur du installerar Ruby och relaterad programvara för ditt operativsystem finns i Konfigurera utvecklingsmiljön för Ruby-utveckling.

Hämta serveranslutningsinformation

Hämta den information du behöver för att ansluta till en databas i Azure SQL Database. Du behöver det fullständigt kvalificerade servernamnet eller värdnamnet, databasnamnet och inloggningsinformationen för de kommande procedurerna.

1. Logga in på Azure-portalen.

2. Gå till sidan SQL-databaser eller SQL Managed Instances .

3. På sidan Översikt granskar du det fullständigt kvalificerade servernamnet bredvid Servernamn för en databas i Azure SQL Database eller det fullständigt kvalificerade servernamnet (eller IP-adressen) bredvid Värd för en Azure SQL Managed Instance eller SQL Server på virtuella datorer. Om du vill kopiera servernamnet eller värdnamnet hovrar du över det och markerar ikonen Kopiera.

Skapa kod för att fråga din databas i Azure SQL Database

1. Skapa en ny fil med namnet sqltest.rb i en text- eller kodredigerare.

2. Lägg till följande kod: Ersätt värdena från databasen i Azure SQL Database med <server>, <database>, <username>och <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
   

   Den här artikeln kräver exempeldatabasen AdventureWorks2022 som du kan ladda ned från startsidan för Microsoft SQL Server-exempel och Community Projects .

Kör koden

1. Kör följande kommando i en kommandotolk:

   ruby sqltest.rb
   

2. Kontrollera att de 20 främsta raderna för kategori/produkt från databasen returneras.

Nästa steg

• Utforma din första databas i Azure SQL Database
• GitHub-lagringsplatsen för TinyTDS
• Rapportera problem eller ställ frågor om TinyTDS
• Ruby-drivrutin för SQL Server