Démarrage rapide : Se connecter et interroger une instance managée Azure SQL à l’aide de SQL Server Management Studio (SSMS)

S’applique à :Azure SQL Managed Instance

Commencez à utiliser SQL Server Management Studio (SSMS) pour vous connecter à votre instance managée Azure SQL et exécutez certaines commandes Transact-SQL (T-SQL).

L’article décrit les étapes suivantes :

Prerequisites

• Installer SQL Server Management Studio
• Azure SQL Managed Instance

Se connecter à une instance managée Azure SQL

1. Démarrez SQL Server Management Studio (SSMS). La première fois que vous exécutez SSMS, la fenêtre Se connecter au serveur s’ouvre. S’il n’est pas ouvert, vous pouvez l’ouvrir manuellement en sélectionnant Explorateur d'objets>Connecter>moteur de base de données.

   

2. Passez en revue vos règles de sécurité entrantes et vérifiez que vous serez en mesure d’accéder à votre instance managée Azure SQL. S’il s’agit de votre première connexion, vous devez créer une règle de sécurité entrante sur le groupe de sécurité réseau dans le groupe de ressources de votre instance managée Azure SQL. Pour plus d’informations sur la configuration du point de terminaison public, par exemple, consultez Configurer des points de terminaison publics dans Azure SQL Managed Instance.

3. La boîte de dialogue Se connecter au serveur s’affiche . Entrez les informations suivantes :

   Réglage	Valeur suggérée	Détails
   Type de serveur	Database Engine	Sélectionnez le moteur de base de données (généralement l’option par défaut).
   Nom du serveur	Nom complet du serveur	Entrez le nom de votre instance managée Azure SQL .
   Authentification
   	Microsoft Entra ID1
   	-Mot de passe -Intégré - AMF	Nous recommandons l’authentification Microsoft Entra avec l’authentification multifacteur (MFA). Consultez Utilisation de l’authentification multifacteur Microsoft Entra.
   	- Principal de service	Consultez le principal du service Microsoft Entra avec Azure SQL.
   	- Identité managée	Consultez les identités managées dans Microsoft Entra pour Azure SQL. La connexion à une instance managée SQL avec SSMS à l’aide d’une identité managée nécessite une machine virtuelle Azure. Consultez Utiliser une identité managée affectée par le système de machine virtuelle Windows pour accéder à Azure SQL
   	- Par défaut	L’option par défaut peut être utilisée lors de la connexion à l’aide d’un mode d’authentification Microsoft Entra sans mot de passe et non actif.
   	L'authentification SQL Server	Utilisez l’authentification SQL Server pour Azure SQL pour vous connecter.
   Connexion	ID d’utilisateur du compte de serveur	ID d’utilisateur du compte de serveur utilisé pour créer le serveur.
   Mot de passe	Mot de passe du compte de serveur	Mot de passe du compte de serveur utilisé pour créer le serveur.
   Nom de la base de données	Vous pouvez laisser cela comme valeur par défaut.
   Chiffrement2	Méthode de chiffrement	Sélectionnez le niveau de chiffrement de la connexion. La valeur par défaut est Obligatoire.
   Approuver le certificat de serveur	Faire confiance au certificat de serveur	Cochez cette option pour contourner la validation du certificat de serveur. La valeur par défaut est False (décochée), ce qui favorise une meilleure sécurité à l’aide de certificats approuvés.
   Nom d’hôte dans le certificat	Nom d’hôte du serveur	La valeur fournie dans cette option est utilisée pour spécifier une valeur différente, mais attendue, CN ou SAN dans le certificat de serveur.

   ¹ La méthode d’authentification Windows n’est pas prise en charge pour Azure SQL. Pour plus d’informations, consultez l’authentification Azure SQL. Nous recommandons l’authentification Microsoft Entra avec l’authentification multifacteur (MFA).

   ² La valeur par défaut est obligatoire dans SQL Server Management Studio (SSMS) 20. Le chiffrement strict (SQL Server 2022 et Azure SQL) doit être utilisé pour Azure SQL Database et Azure SQL Managed Instance. Le chiffrement strict (SQL Server 2022 et Azure SQL) peut être utilisé pour SQL Server lorsque l’instance a activé le chiffrement strict . Dans SQL Server Management Studio 21, il s’agit de Strict (MINIMUM SQL Server 2022 et Azure SQL).

   Vous pouvez également modifier des options de connexion supplémentaires en sélectionnant Options. Voici quelques exemples d’options de connexion : la base de données à laquelle vous vous connectez, la valeur du délai d’expiration de la connexion et le protocole réseau. Cet article utilise les valeurs par défaut pour toutes les options.

   

4. Une fois tous les champs terminés, sélectionnez Se connecter.

5. Pour vérifier que votre connexion Azure SQL Managed Instance a réussi, développez et explorez les objets dans l’Explorateur d’objets où le nom du serveur, la version de SQL Server et le nom d’utilisateur sont affichés. Ces objets sont différents en fonction du type de serveur.

   

Résoudre les problèmes de connectivité

• Si votre navigateur ne parvient pas à se connecter lors de l’utilisation de Microsoft Entra avec MFA, vous pouvez accéder auxoptions>d’outils> AzureServices>Azure Cloud et modifier la valeur pour utiliser le navigateur web par défaut système ou Utiliser le Gestionnaire de comptes web. Pour plus d’informations, consultez Options (Services Azure).

• Vous pouvez rencontrer des problèmes de connexion avec Azure SQL Managed Instance. Pour plus d’informations sur la résolution des problèmes de connexion, consultez Résoudre les problèmes de connectivité et d’autres erreurs.

• Vous pouvez empêcher, dépanner, diagnostiquer et atténuer les erreurs de connexion et temporaires que vous rencontrez lors de l’interaction avec Azure SQL Managed Instance. Pour plus d’informations, consultez Résoudre les erreurs de connexion temporaires.

Effacer le cache de jetons d’ID Microsoft Entra

SQL Server Management Studio (SSMS) met en cache brièvement les jetons d’ID Microsoft Entra. Lorsqu’un utilisateur est ajouté à un groupe d’identifiant Microsoft Entra et tente immédiatement de s’authentifier via SSMS, le message d’erreur suivant est levé :

Login failed for user '<token-identified principal>'.
(Microsoft SQL Server, Error: 18456)

Si vous avez récemment obtenu l’accès à un serveur, vous pouvez effacer le cache des jetons d’ID Microsoft Entra à partir de L’aide>Effacer le cache de jetons d’ID Microsoft Entra.

La boîte de dialogue suivante décrit pourquoi cette option est utile si vous avez récemment reçu l’accès à un serveur et que vous avez besoin d’une nouvelle authentification.

Créer une base de données

Nous allons maintenant créer une base de données nommée TutorialDB en procédant comme suit :

1. Cliquez avec le bouton droit sur votre instance de serveur dans l’Explorateur d’objets, puis sélectionnez Nouvelle requête :

   

2. Collez l’extrait de code T-SQL suivant dans la fenêtre de requête pour créer une base de données avec les paramètres par défaut :

   IF NOT EXISTS (SELECT name
                  FROM sys.databases
                  WHERE name = N'TutorialDB')
       CREATE DATABASE [TutorialDB];
   GO
   

3. Exécutez la requête en sélectionnant Exécuter ou en sélectionnant F5 sur votre clavier.

   Une fois la requête terminée, la nouvelle TutorialDB base de données apparaît dans la liste des bases de données dans l’Explorateur d’objets. S’il n’est pas affiché, cliquez avec le bouton droit sur le nœud Bases de données , puis sélectionnez Actualiser.

Créer une table dans la nouvelle base de données

Dans cette section, vous allez créer une table dans la base de données nouvellement créée TutorialDB . Étant donné que l’éditeur de requête est toujours dans le contexte de la master base de données, basculez le contexte de connexion vers la TutorialDB base de données en procédant comme suit :

1. Dans la liste déroulante de base de données, sélectionnez la base de données souhaitée, comme illustré ici :

   

2. Collez l’extrait de code T-SQL suivant dans la fenêtre de requête :

   -- Create a new table called 'Customers' in schema 'dbo'
   -- Drop the table if it already exists
   IF OBJECT_ID('dbo.Customers', 'U') IS NOT NULL
       DROP TABLE dbo.Customers;
   GO
   
   -- Create the table in the specified schema
   CREATE TABLE dbo.Customers
   (
       CustomerId INT NOT NULL PRIMARY KEY, -- primary key column
       Name NVARCHAR (50) NOT NULL,
       Location NVARCHAR (50) NOT NULL,
       Email NVARCHAR (50) NOT NULL
   );
   GO
   

3. Exécutez la requête en sélectionnant Exécuter ou en sélectionnant F5 sur votre clavier.

Une fois la requête terminée, la nouvelle Customers table s’affiche dans la liste des tables de l’Explorateur d’objets. Si la table n’est pas affichée, cliquez avec le bouton droit sur le nœudTables> dans l’Explorateur d’objets, puis sélectionnez Actualiser.

Insérer des lignes dans la nouvelle table

Nous allons maintenant insérer des lignes dans la Customers table que vous avez créée. Collez l’extrait de code T-SQL suivant dans la fenêtre de requête, puis sélectionnez Exécuter :

-- Insert rows into table 'Customers'
INSERT INTO dbo.Customers (
    [CustomerId],
    [Name],
    [Location],
    [Email]
)
VALUES
    (1, N'Orlando', N'Australia', N''),
    (2, N'Keith', N'India', N'keith0@adventure-works.com'),
    (3, N'Donna', N'Germany', N'donna0@adventure-works.com'),
    (4, N'Janet', N'United States', N'janet1@adventure-works.com');
GO

Consulter la table et voir les résultats

Les résultats d’une requête sont visibles sous la fenêtre de texte de la requête. Pour interroger la Customers table et afficher les lignes insérées, collez l’extrait de code T-SQL suivant dans la fenêtre de requête, puis sélectionnez Exécuter :

-- Select rows from table 'Customers'
SELECT * FROM dbo.Customers;

Les résultats de la requête sont affichés sous la zone où le texte a été entré.

Vous pouvez également modifier la façon dont les résultats sont présentés en sélectionnant l’une des options suivantes :

• Le premier bouton affiche les résultats en mode Texte, comme illustré dans l’image de la section suivante.
• Le bouton central affiche les résultats en mode Grille, qui est l’option par défaut.
• Le troisième bouton vous permet d’enregistrer les résultats dans un fichier dont l’extension est .rpt par défaut.

Vérifier vos propriétés de connexion à l’aide de la table de fenêtre de requête

Vous trouverez des informations sur les propriétés de connexion sous les résultats de votre requête. Après avoir exécuté la requête mentionnée précédemment à l’étape précédente, passez en revue les propriétés de connexion en bas de la fenêtre de requête.

• Vous pouvez déterminer le serveur et la base de données auxquels vous êtes connecté, ainsi que votre nom d’utilisateur.

• Vous pouvez également afficher la durée de la requête et le nombre de lignes retournées par la requête exécutée précédemment.

  

Nettoyer les ressources

Nous allons supprimer l’exemple TutorialDB de base de données. Collez le code T-SQL suivant et exécutez :

IF EXISTS (SELECT name
           FROM sys.databases
           WHERE name = N'TutorialDB')
    DROP DATABASE [TutorialDB];
GO

Contenu connexe

• Éditeur de requête (SQL Server Management Studio)
• Objets de script dans SQL Server Management Studio
• Utiliser des modèles dans SQL Server Management Studio
• Composants et configuration de SQL Server Management Studio
• Conseils et astuces pour l’utilisation de SQL Server Management Studio (SSMS)