Szybki start: wykonywanie zapytań względem bazy danych w usłudze Azure SQL Database lub Azure SQL Managed Instance przy użyciu języka Ruby

Dotyczy:Azure SQL DatabaseAzure SQL Managed Instance

W tym przewodniku Szybki start pokazano, jak używać języka Ruby do nawiązywania połączenia z bazą danych i wykonywania zapytań o dane za pomocą instrukcji Języka Transact-SQL.

Wymagania wstępne

Do wykonania kroków tego przewodnika Szybki start niezbędne jest spełnienie następujących wymagań wstępnych:

• Baza danych. Możesz użyć jednego z tych przewodników z serii Szybki start, aby utworzyć bazę danych, a następnie ją skonfigurować:

  Akcja	Baza danych SQL	SQL Managed Instance	Program SQL Server na maszynach wirtualnych platformy Azure
  Utwórz	Portal	Portal	Portal
  	CLI	CLI
  	PowerShell	PowerShell	PowerShell
  Konfiguruj	Reguła zapory bazująca na adresach IP na poziomie serwera	Łączność z maszyny wirtualnej
  		Łączność ze środowiska lokalnego	Połącz się z instancją SQL Server
  Ładowanie danych	Załadowano Wide World Importers zgodnie z przewodnikiem Szybki start	Przywracanie bazy danych Wide World Importers	Przywracanie bazy danych Wide World Importers
  		Przywróć lub zaimportuj Adventure Works z pliku BACPAC z serwisu GitHub	Przywróć lub zaimportuj bazę danych Adventure Works z pliku BACPAC z GitHub

  Ważne

  Skrypty zamieszczone w tym artykule korzystają z bazy danych Adventure Works. W przypadku wystąpienia zarządzanego SQL albo zaimportuj bazę danych Adventure Works do bazy danych w tym wystąpieniu, albo zmodyfikuj skrypty w tym artykule tak, aby korzystały z bazy danych Wide World Importers.

• Aby zainstalować język Ruby i powiązane oprogramowanie dla systemu operacyjnego, zobacz Konfigurowanie środowiska programistycznego na potrzeby programowania w języku Ruby.

Uzyskiwanie informacji o połączeniu z serwerem

Uzyskaj informacje potrzebne do nawiązania połączenia z bazą danych w usłudze Azure SQL Database. Do kolejnych procedur będą potrzebne: w pełni kwalifikowana nazwa domenowa (FQDN) serwera lub nazwa hosta, nazwa bazy danych oraz informacje potrzebne do logowania.

1. Zaloguj się w witrynie Azure Portal.

2. Przejdź do strony baz danych SQL lub wystąpień zarządzanych SQL.

3. Na stronie Przegląd sprawdź w pełni kwalifikowaną nazwę domenową serwera obok pola Nazwa serwera dla bazy danych w usłudze Azure SQL Database albo w pełni kwalifikowaną nazwę domenową serwera (lub adres IP) obok pola Host dla wystąpienia zarządzanego Azure SQL lub programu SQL Server na maszynach wirtualnych. Aby skopiować nazwę serwera lub hosta, umieść na niej wskaźnik myszy i wybierz ikonę Kopiuj.

Tworzenie kodu do wykonywania zapytań względem bazy danych w usłudze Azure SQL Database

1. W edytorze tekstów lub kodu utwórz nowy plik o nazwie sqltest.rb.

2. Dodaj następujący kod. Zastąp wartościami z bazy danych w usłudze Azure SQL Database elementy <server>, <database>, <username> i <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
   

   Przykłady kodu w tym artykule korzystają z przykładowej bazy danych AdventureWorks2025 lub AdventureWorksDW2025, którą można pobrać z repozytorium GitHub Azure Data SQL Samples.

Uruchamianie kodu

1. W wierszu polecenia uruchom następujące polecenie:

   ruby sqltest.rb
   

2. Sprawdź, czy jest zwracanych 20 pierwszych wierszy kategorii/produktu z bazy danych.

Treści powiązane

• Samouczek: projektowanie relacyjnej bazy danych w usłudze Azure SQL Database
• Repozytorium GitHub dla rozwiązania TinyTDS
• Zgłoś problemy lub zadaj pytania dotyczące rozwiązania TinyTDS
• Sterowniki Ruby dla programu SQL Server