Schnellstart: Abfragen einer Datenbank in Azure SQL-Datenbank oder Azure SQL Managed Instance mithilfe von Ruby

Gilt für: Azure SQL-Datenbank Azure SQL Managed Instance

In dieser Schnellstartanleitung erfahren Sie, wie Sie mithilfe von Ruby eine Verbindung mit einer Datenbank herstellen und Daten mit Transact-SQL-Anweisungen abfragen.

Voraussetzungen

Zum Durchführen dieser Schnellstartanleitung benötigen Sie Folgendes:

• Eine Datenbank. In den folgenden Schnellstartanleitungen erfahren Sie jeweils, wie Sie die Datenbank erstellen und anschließend konfigurieren:

  Aktion	SQL-Datenbank	Verwaltete SQL-Instanz	SQL Server auf Azure-VMs
  Erstellen	Portal	Portal	Portal
  	BEFEHLSZEILENSCHNITTSTELLE (CLI)	BEFEHLSZEILENSCHNITTSTELLE (CLI)
  	PowerShell	PowerShell	PowerShell
  Konfigurieren	IP-Firewallregel auf Serverebene	Verbindung von einem virtuellen Computer
  		Verbindungen von lokalen Computern	Herstellen einer Verbindung mit einer SQL Server-Instanz
  Laden der Daten	Wide World Importers, die pro Schnellstart geladen wurden	Wiederherstellen von Wide World Importers	Wiederherstellen von Wide World Importers
  		Wiederherstellen oder Importieren von Adventure Works über eine BACPAC-Datei von GitHub	Wiederherstellen oder Importieren von Adventure Works über eine BACPAC-Datei von GitHub

  Wichtig

  Die Skripts in diesem Artikel sind für die Adventure Works-Datenbank geschrieben. Bei einer verwalteten SQL-Instanz importieren Sie entweder die Adventure Works-Datenbank in eine Instanzdatenbank oder passen die Skripts in diesem Artikel zur Verwendung der Wide World Importers-Datenbank an.

• Informationen zum Installieren von Ruby und zugehöriger Software für Ihr Betriebssystem finden Sie unter Konfigurieren der Entwicklungsumgebung für die Ruby-Entwicklung.

Ermitteln von Serververbindungsinformationen

Ermitteln Sie die Informationen, die Sie zum Herstellen einer Verbindung mit einer Datenbank in Azure SQL-Datenbank benötigen. In den weiteren Verfahren benötigen Sie den vollqualifizierten Server- oder Hostnamen, den Datenbanknamen und die Anmeldeinformationen.

1. Melden Sie sich beim Azure-Portal an.

2. Navigieren Sie zur Seite SQL-Datenbanken oder Verwaltete SQL-Instanzen.

3. Auf der Seite Übersicht finden Sie den vollqualifizierten Servernamen für eine Datenbank in Azure SQL-Datenbank neben Servername oder den vollqualifizierten Servernamen (oder die IP-Adresse) für Azure SQL Managed Instance bzw. für SQL Server auf einem virtuellen Computer neben Host. Um den Namen des Servers oder Hosts zu kopieren, zeigen Sie darauf, und wählen Sie das Symbol Kopieren aus.

Hinweis

Verbindungsinformationen für SQL Server auf einem virtuellen Azure-Computer finden Sie unter Herstellen einer Verbindung mit einer SQL Server-Instanz.

Schreiben von Code zum Abfragen einer Datenbank in Azure SQL-Datenbank

1. Erstellen Sie in einem Text- oder Code-Editor eine neue Datei namens sqltest.rb.

2. Fügen Sie den folgenden Code hinzu. Ersetzen Sie <server>, <database>, <username> und <password> durch die Werte aus Ihrer Datenbank in Azure SQL-Datenbank.

   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
   

   Die Transact-SQL-Codebeispiele in diesem Artikel nutzen die Beispieldatenbank AdventureWorks2022 oder AdventureWorksDW2022, die Sie von der Homepage Microsoft SQL Server Samples and Community Projects herunterladen können.

Ausführen des Codes

1. Führen Sie an der Eingabeaufforderung folgenden Befehl aus:

   ruby sqltest.rb
   

2. Stellen Sie sicher, dass die obersten 20 Kategorie-/Produktzeilen aus Ihrer Datenbank zurückgegeben werden.

Nächste Schritte

• Entwerfen Ihrer ersten Datenbank in Azure SQL-Datenbank
• GitHub-Repository für TinyTDS
• Report issues or ask questions about TinyTDS (Melden von Problemen oder Stellen von Fragen zu TinyTDS)
• Ruby-Treiber für SQL Server