Démarrage rapide : Utiliser Ruby pour interroger une base de données dans Azure SQL Database ou Azure SQL Managed Instance

Article
05/10/2024

S’applique à : Azure SQL Database Azure SQL Managed Instance

Ce guide de démarrage rapide explique comment utiliser Ruby pour se connecter à une base de données et l’interroger à l’aide d’instructions Transact-SQL.

Prérequis

Pour effectuer ce démarrage rapide, vous avez besoin de ce qui suit :

Une base de données. Utilisez l’un de ces guides de démarrage rapide pour créer et configurer une base de données :

Action	SQL Database	Instance managée SQL	SQL Server sur les machines virtuelles Azure
Créer	Portail	Portail	Portail
	INTERFACE DE LIGNE DE COMMANDE	INTERFACE DE LIGNE DE COMMANDE
	PowerShell	PowerShell	PowerShell
Configurer	Règle de pare-feu IP au niveau du serveur	Connectivité à partir d’une machine virtuelle
		Connectivité locale	Se connecter à une instance SQL Server
Chargement des données	Wide World Importers chargé par démarrage rapide	Restaurer Wide World Importers	Restaurer Wide World Importers
		Restaurer ou importer Adventure Works à partir d’un fichier BACPAC sur GitHub	Restaurer ou importer Adventure Works à partir d’un fichier BACPAC sur GitHub

Important

Les scripts fournis dans cet article utilisent la base de données Adventure Works. Avec une instance de SQL Managed Instance, importez la base de données Adventure Works dans une base de données d’instance, ou modifiez les scripts fournis dans cet article pour utiliser la base de données Wide World Importers.

Pour installer Ruby et les logiciels associés pour votre système d’exploitation, consultez Configurer l’environnement de développement pour le développement Ruby.

Obtenir les informations de connexion du serveur

Obtenez les informations dont vous avez besoin pour vous connecter à une base de données dans Azure SQL Database. Pour les procédures suivantes, vous aurez besoin du nom complet du serveur ou du nom d’hôte, du nom de la base de données et des informations de connexion.

Connectez-vous au portail Azure.
Accédez à la page Bases de données SQL ou Instances managées SQL.
Sur la page Vue d’ensemble, vérifiez le nom complet du serveur en regard du champ Nom du serveur d’une base de données d’Azure SQL Database, ou le nom complet du serveur (ou l’adresse IP) en regard du champ Hôte d’une instance gérée SQL Azure ou SQL Server sur machines virtuelles. Pour copier le nom du serveur ou de l’hôte, pointez dessus et sélectionnez l’icône Copier.

Notes

Pour obtenir les informations de connexion de SQL Server sur machines virtuelles Azure, consultez Se connecter à une instance SQL Server.

Créer du code pour interroger la base de données dans Azure SQL Database

Créez un nouveau fichier nommé sqltest.py dans un éditeur de texte ou de code.

Ajoutez le code ci-dessous. Remplacez les valeurs <server>, <database>, <username> et <password> de votre base de données dans Azure SQL Database.

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

Les exemples de code Transact-SQL de cet article sont fondés sur l’échantillon de base de données AdventureWorks2022 ou AdventureWorksDW2022 fourni, que vous pouvez télécharger à partir de la page d’accueil Échantillons et projets communautaires Microsoft SQL Server.

Exécuter le code

Depuis une invite de commandes, exécutez la commande suivante :
```
ruby sqltest.rb
```
Vérifiez que les 20 premières lignes catégorie/produit de votre base de données sont retournées.

Étapes suivantes

Concevoir votre première base de données dans Azure SQL Database
GitHub repository for TinyTDS (Référentiel GitHub pour TinyTDS)
Signaler des problèmes ou poser des questions sur TinyTDS
Pilote Ruby pour SQL Server

Partage via