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

S’applique à : Azure SQL DatabaseAzure 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	Base de données SQL	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

  Importante

  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.

1. Connectez-vous au portail Azure.

2. Accédez à la page Bases de données SQL ou Instances managées SQL.

3. 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.

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

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

2. 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 de cet article utilisent les bases de données d'exemple AdventureWorks2025 ou AdventureWorksDW2025, que vous pouvez télécharger à partir de la page d'accueil Microsoft SQL Server Samples and Community Projects.

Exécuter le code

1. Depuis une invite de commandes, exécutez la commande suivante :

   ruby sqltest.rb
   

2. Vérifiez que les 20 premières lignes catégorie/produit de votre base de données sont retournées.

Contenu connexe

• Tutoriel : concevoir une base de données relationnelle dans la base de données Azure SQL
• 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