Démarrage rapide : Utiliser l’éditeur de requête du portail Azure pour interroger une base de données Azure SQL Database

S’applique à Azure SQL Database

L’éditeur de requête (aperçu) de la base de données Azure SQL est un outil permettant d’exécuter des requêtes SQL sur la base de données Azure SQL dans le portail Azure. Dans ce démarrage rapide, vous allez vous connecter à une base de données Azure SQL dans le portail Azure, et utiliser l’éditeur de requête pour exécuter des requêtes Transact-SQL (T-SQL).

Prérequis

Authentification

Un compte d’utilisateur disposant des autorisations nécessaires pour se connecter à la base de données et à l’éditeur de requête. Vous pouvez utiliser l’authentification SQL ou l’authentification Microsoft Entra ID) (recommandé). Pour en savoir plus sur la création et la gestion des connexions dans la base de données Azure SQL, consultez Autoriser l’accès à la base de données.

Pour plus d’informations sur l’accès au réseau public, les paramètres de version TLS et la stratégie de connexion, consultez les paramètres de connectivité Azure SQL.

Règle de pare-feu

Pour les connexions publiques à l’éditeur de requêtes, vous devez ajouter votre adresse IP sortante aux règles de pare-feu autorisées du serveur afin d’accéder à vos bases de données.

Si vous recevez cette erreur, procédez comme suit pour la résoudre :

Cannot open server 'server-name' requested by the login. Client with IP address 'xx.xx.xx.xx' is not allowed to access the server. To enable access, use the Azure Management Portal or run sp_set_firewall_rule on the master database to create a firewall rule for this IP address or address range. It may take up to five minutes for this change to take effect.

Suivez les étapes rapides ci-après, ou pour plus d’informations, consultez ajouter votre adresse IP sortante aux règles de pare-feu autorisées du serveur.

  1. Revenez à la page Vue d’ensemble de votre SQL Database.
  2. Sélectionnez le lien du serveur logique Azure SQL en regard de nom du serveur.
  3. Dans le menu Ressources, sous Sécurité, sélectionnez Réseau :
  4. Vérifiez que, sous Accès au réseau public, l’option sélectionner les réseaux est sélectionnée.
    • S’il s’agit d’un environnement de test ou temporaire, définissez l’option sur Réseaux sélectionnés.
    • Si ce n’est pas le cas, l’accès doit être accordé par d’autres moyens que ceux décrits dans ce guide de démarrage rapide, probablement via des points de terminaison privés (en utilisant Azure Private Link) comme indiqué dans la vue d’ensemble de l’accès au réseau.
  5. Sous Règles de pare-feu, sélectionnez Ajouter l’adresse IPv4 de votre client.
    • Si nécessaire, identifiez votre adresse IPv4 et fournissez-la dans les champs Démarrer et Arrêter.
  6. Sélectionnez Enregistrer.

Pour la résolution des problèmes, consultez Résolution des erreurs de connexion.

Se connecter à l’éditeur de requête

Connectez-vous à votre base de données dans l’éditeur de requêtes.

  1. Sur le portail Azure, accédez à votre base de données SQL. Par exemple, consultez votre tableau de bord Azure SQL.

  2. Sur la page de Présentation de votre base de données SQL, sélectionnez Éditeur de requêtes (aperçu) dans le menu des ressources.

    Capture d’écran montrant la sélection de l’éditeur de requête.

  3. Dans l’écran de connexion, fournissez des informations d’identification pour vous connecter à la base de données.

    • Vous pouvez désormais vous connecter à l’aide de l’authentification SQL ou Microsoft Entra.

      • Pour vous connecter avec une authentification SQL, sous Authentification SQL Server, entrez l’ID de connexion et le Mot de passe d’un utilisateur ayant accès à la base de données, puis sélectionnez OK. Vous pouvez toujours utiliser l’ID de connexion et le mot de passe de l’administrateur du serveur.

      • Pour vous connecter à l’aide de Microsoft Entra ID, si vous êtes l’administrateur du serveur Microsoft Entra, sélectionnez Continuer en tant que <user@domain>. Si la connexion échoue, essayez d’actualiser la page.

        Capture d’écran du Portail Azure montrant la connexion avec l’authentification Microsoft Entra.

Connection avec d’autres outils

Vous pouvez également vous connecter à votre base de données Azure SQL à l’aide d’autres outils, notamment :

Interroger la base de données

Sur n’importe quelle base de données, exécutez la requête suivante dans l’éditeur de requête pour obtenir l’heure au format UTC, le nom de la base de données et votre nom de connexion authentifié.

SELECT SYSDATETIMEOFFSET(), DB_NAME(), ORIGINAL_LOGIN();

Lancer une requête sur l'exemple de base de données AdventureWorksLT

Cette partie du guide de démarrage rapide utilise l’exemple de base de données AdventureWorksLT dans Azure SQL. Si vous n’en avez pas encore, vous pouvez créer une base de données à l’aide d’un échantillon de données dans Azure SQL Database. Recherchez l’option permettant d’utiliser votre offre pour essayer la base de données Azure SQL gratuitement (préversion).

Dans la page Éditeur de requête (préversion), exécutez les exemples de requêtes suivants sur votre échantillon de base de données AdventureWorksLT.

Conseil

Vous êtes nouveau sur Azure SQL Database ? Bénéficiez d’un contenu d’entraînement gratuit détaillé : Principes de base d’Azure SQL ou passez en revue le Glossaire des termes Azure SQL.

Pour plus d’informations sur T-SQL dans Azure SQL Database, consultez les différences T-SQL entre SQL Server et Azure SQL Database.

Exécuter une requête SELECT

  1. Pour interroger les 20 premiers produits dans la base de données, collez la requête SELECT suivante dans l’éditeur de requête :

     SELECT TOP 20 pc.Name as CategoryName, p.name as ProductName
     FROM SalesLT.ProductCategory pc
     JOIN SalesLT.Product p
     ON pc.productcategoryid = p.productcategoryid;
    
  2. Sélectionnez Exécuter, puis examinez la sortie dans le volet Résultats.

    Capture d’écran montrant les résultats de l’éditeur de requête pour une requête SELECT.

  3. Si vous le souhaitez, vous pouvez sélectionner Enregistrer la requête pour enregistrer la requête dans un fichier .sql, ou sélectionner Exporter les données sous pour exporter les résultats dans un fichier .json, .csv ou .xml.

Exécuter une requête INSERT

Pour ajouter un nouveau produit à la table SalesLT.Product, exécutez l’instruction T-SQL INSERT suivante.

  1. Dans l’éditeur de requête, remplacez la requête précédente par la requête suivante :

    INSERT INTO [SalesLT].[Product]
           ( [Name]
           , [ProductNumber]
           , [Color]
           , [ProductCategoryID]
           , [StandardCost]
           , [ListPrice]
           , [SellStartDate]
           )
    VALUES
           ('myNewProduct'
           ,123456789
           ,'NewColor'
           ,1
           ,100
           ,100
           ,GETDATE() );
    
  2. Sélectionnez Exécuter pour ajouter le nouveau produit. Quand la requête s’exécute, le volet Messages affiche Requête réussie : Lignes affectées : 1.

Exécuter une requête UPDATE

Exécutez l’instruction T-SQL UPDATE suivante pour mettre à jour le prix de votre nouveau produit.

  1. Dans l’éditeur de requête, remplacez la requête précédente par la requête suivante :

    UPDATE [SalesLT].[Product]
    SET [ListPrice] = 125
    WHERE Name = 'myNewProduct';
    
  2. Sélectionnez Exécuter pour mettre à jour la ligne spécifiée dans la table Product. Le volet Messages affiche Requête réussie : Lignes affectées : 1.

Exécuter une requête DELETE

Exécutez l’instruction T-SQL DELETE suivante pour supprimer votre nouveau produit.

  1. Dans l’éditeur de requête, remplacez la requête précédente par la requête suivante :

    DELETE FROM [SalesLT].[Product]
    WHERE Name = 'myNewProduct';
    
  2. Sélectionnez Exécuter pour supprimer la ligne spécifiée dans la table Product. Le volet Messages affiche Requête réussie : Lignes affectées : 1.