Connectez-vous à une base de données avec l’extension MSSQL pour Visual Studio Code

L’extension MSSQL pour Visual Studio Code centre vos connexions à SQL Server, Azure SQL et base de données SQL dans Microsoft Fabric. Cet article vous montre comment créer des connexions avec la boîte de dialogue Connexion et quels types d’authentification l’extension prend en charge. Il explique également comment organiser les connexions enregistrées dans le Explorateur d'objets et comment choisir la connexion utilisée par l’extension lorsque vous ouvrez un nouveau fichier SQL.

Une fois connecté, consultez Démarrage rapide : Exécutez votre première requête avec l’extension MSSQL pour Visual Studio Code pour créer une base de données, ajouter des données et exécuter des instructions Transact-SQL.

Dialogue de connexion

La boîte de dialogue Connexion est le moyen principal de créer ou de modifier une connexion. Ouvrez-le en sélectionnant Ajouter une connexion dans le Explorateur d'objets, ou en exécutant la commande MS SQL : Ajouter une connexion à partir de la palette de commandes.

Le dialogue comporte trois zones principales :

Zone de formulaire au milieu, où vous renseignez les détails de connexion.
Un panneau Connexions enregistrées et Connexions récentes sur le côté droit, répertoriant les connexions que vous pouvez rouvrir ou modifier rapidement.
Un pied de page avec les actions Avancé, Tester la connexion, Enregistrer sans se connecter et Connecter.

Types d’entrée

En haut du formulaire, le sélecteur de type d’entrée contrôle la façon dont vous entrez les détails de connexion. Utilisez le type d’entrée qui correspond le mieux à ce que vous connaissez déjà sur le serveur cible.

Paramètres : renseignez des champs individuels tels que le nom du serveur, le nom de la base de données, le type d’authentification, le nom d’utilisateur et le mot de passe. Ce type d’entrée est la valeur par défaut et est l’option la plus simple pour la plupart des scénarios.
Chaîne de connexion : Collez une chaîne de connexion complète au format ADO.NET. Ce type d’entrée est utile lorsqu’un chaîne de connexion a déjà été fourni à vous (par exemple, à partir du portail Azure ou d’un administrateur) ou lorsque vous devez configurer des options non exposées dans la vue Paramètres.
Parcourez Azure : connectez-vous à Azure et choisissez un serveur et une base de données à partir de vos abonnements. Vous pouvez filtrer par abonnement et groupe de ressources pour rechercher la base de données souhaitée. Cette option fonctionne pour Azure SQL Database et Azure SQL Managed Instance (les points de terminaison privés et publics sont répertoriés). Vous pouvez ajouter des abonnements favoris afin qu’ils apparaissent en haut de la liste et chargent automatiquement.
Parcourez Fabric : connectez-vous à Microsoft Fabric et choisissez une base de données SQL à partir de l’un de vos espaces de travail. La boîte de dialogue répertorie les espaces de travail auquel vous avez accès et les bases de données SQL à l’intérieur. Comme lors de la navigation Azure, vous pouvez ajouter des espaces de travail favoris afin qu’ils apparaissent en haut de la liste et chargent automatiquement.

Parcourir Azure et Parcourir Fabric utilisent les comptes Microsoft avec lesquels vous vous connectez à Visual Studio Code. Vous pouvez vous connecter avec autant de comptes Microsoft que vous le souhaitez et basculer entre les comptes et leurs locataires à l’aide des listes déroulantes situées en haut du volet de navigation. GitHub comptes ne peuvent pas être utilisés pour parcourir les bases de données Azure et Fabric.

Choisir une base de données

Le champ Base de données vous permet de vous connecter à la base de données par défaut du serveur ou à une base de données spécifique.

Laissez le champ sur <Default> pour vous connecter à la base de données par défaut que le serveur attribue à votre identifiant de connexion. Il s’agit de l’option la plus simple et vous pouvez toujours changer de base de données ultérieurement à partir de l’éditeur.
Sélectionnez une base de données spécifique dans la liste déroulante. Une fois que vous avez renseigné suffisamment de détails pour l’authentification, l’extension tente d’extraire la liste des bases de données sur le serveur en arrière-plan. Si la liste se charge correctement, vous pouvez la choisir.
Si la liste de bases de données ne peut pas être chargée ( par exemple, lorsque votre connexion n’a pas l’autorisation d’énumérer les bases de données sur le serveur), vous pouvez toujours taper le nom de la base de données directement dans le champ.

Paramètres avancés

Sélectionnez Avancé dans le pied de page pour ouvrir un volet latéral avec l’ensemble complet d’options de connexion supplémentaires, telles que Always Encrypted, Le délai d’expiration de commande et l’intention de l’application (lecture seule ou lecture-écriture). Il s'agit des mêmes options que celles que vous trouveriez dans un chaîne de connexion, regroupées en catégories telles que sécurité, résilience de connexion et regroupement. Utilisez la zone de recherche en haut du panneau pour trouver rapidement un paramètre spécifique.

Les boutons du pied de page contrôlent ce qui se passe lorsque vous avez terminé de remplir le formulaire.

Connexion : se connecte à la base de données et ajoute la connexion à votre liste de connexions enregistrées.
Tester la connexion : tente de se connecter à l’aide des valeurs de formulaire actuelles sans enregistrer quoi que ce soit. Utilisez cette option pour vérifier que le serveur, les informations d’identification et d’autres paramètres sont corrects avant de valider une connexion.
Enregistrer sans connexion : enregistre le profil de connexion dans votre liste de connexions enregistrées, mais n’ouvre pas de session. Cela est utile lorsque vous configurez des connexions à l’avance ou lorsque vous souhaitez renommer une connexion existante sans vous connecter.

Utiliser des connexions existantes

Les listes Connexions enregistrées et Connexions récentes sur le côté droit de la boîte de dialogue facilitent le démarrage à partir d’une connexion que vous avez déjà.

Pointez sur une connexion enregistrée pour afficher un menu d’action. À partir de là, vous pouvez modifier les détails de la connexion, créer une connexion en fonction d’une connexion existante (raccourci utile lorsque plusieurs connexions partagent le même serveur, mais différentes bases de données ou informations d’identification) ou supprimer la connexion de la liste.
Les connexions récentes fonctionnent de la même façon, mais sont limitées aux connexions que vous avez utilisées récemment, même si elles ne sont pas enregistrées.

Types d’authentification pris en charge

L’extension MSSQL prend en charge plusieurs types d’authentification. Choisissez celui qui correspond à la configuration de votre serveur.

Entrez un nom d’utilisateur et un mot de passe définis sur le SQL Server lui-même. La connexion SQL fonctionne pour SQL Server, Azure SQL Database et Azure SQL Managed Instance.

Vous pouvez éventuellement enregistrer le mot de passe afin que vous n’ayez pas à le reentérer chaque fois que vous vous connectez.

Authentification de Windows

Utilisez votre compte de Windows actuel pour vous connecter au serveur, sans nom d’utilisateur ni mot de passe requis. Windows l'authentification fonctionne uniquement lorsque vous vous connectez à une instance de SQL Server configurée pour l'accepter, généralement sur un réseau joint à un domaine ou sur le même ordinateur que le serveur.

Cette option est parfois appelée Authentification intégrée. Il n'est pas disponible pour Azure SQL Database, Azure SQL Managed Instance ou la base de données SQL dans Fabric.

Microsoft Entra ID - Universal avec MFA

Connectez-vous avec un compte Microsoft Entra ID. Cette option prend en charge l’authentification multifacteur (MFA), les stratégies d’accès conditionnel et les comptes Microsoft personnels invités au sein d’un locataire Microsoft Entra.

Lorsque vous sélectionnez cette option, la boîte de dialogue vous invite à choisir ou à ajouter un compte Microsoft Entra ID et à choisir un locataire si le compte a accès à plusieurs.

L'extension utilise les comptes Microsoft que vous avez connectés à Visual Studio Code avec (les mêmes comptes affichés dans le menu Comptes dans le coin inférieur gauche de la fenêtre). Si vous n'êtes pas encore connecté à Visual Studio Code ou si vous n'avez pas encore autorisé l'extension MSSQL à utiliser des comptes, vous êtes invité à vous connecter lorsque vous vous connectez.

Note

Si vous vous êtes précédemment connecté à l'extension MSSQL à l'aide du système de compte de l'extension (utilisé dans MSSQL 1.42.2 et versions antérieures), vous serez invité à vous connecter à Visual Studio Code (si vous n'êtes pas déjà) la prochaine fois que vous vous connectez à l'aide de l'une de vos connexions enregistrées.

Si le système de compte de Visual Studio Code ne fonctionne pas pour vous, faites-le-nous savoir. Vous pouvez revenir au mécanisme de connexion précédent en définissant mssql.preview.useVscodeAccountsForEntraMFA sur false.

Microsoft Entra ID - Valeur par défaut

Cette option utilise Microsoft Entra ID authentification par défaut. Le pilote MICROSOFT DATA SQL (MDS) sélectionne automatiquement une identité Microsoft Entra ID disponible à partir des fournisseurs d’informations d’identification installés sur votre système. Ce type d’authentification est utile lorsque vous avez des exigences d’authentification spécifiques qui ne sont pas directement prises en charge par l’extension MSSQL.

Les identités peuvent provenir de plusieurs sources différentes, telles qu’une session Azure CLI connectée (az login) ou des variables d’environnement, et vous pouvez diriger une identité spécifique à utiliser en définissant la User name zone. Pour plus d’informations sur la façon dont l’authentification par défaut sélectionne une identité, consultez DefaultAzureCredential dans la bibliothèque de client Azure Identity

Microsoft Entra ID - Principal de service

S’authentifier en tant que principal de service de Microsoft Entra ID (une identité d’application plutôt qu’un utilisateur). Utilisez cette option pour les scénarios d’automatisation, les stations de travail partagées ou tout cas où il est préférable d’accorder l’accès à une base de données à une identité d’application au lieu d’une personne.

Lorsque vous sélectionnez cette option, les champs Nom d’utilisateur et Mot de passe sont réaffectés :

Entrez l’ID d’application (client) du principal de service comme nom d’utilisateur.
Entrez le secret client du principal de service en tant que mot de passe.

Pour plus d’informations sur l’utilisation d’un principal de service avec SQL, consultez Le principal de service dans la bibliothèque de client Azure Identity

Connexions dans le Explorateur d'objets

Chaque connexion que vous créez à partir de la boîte de dialogue connexion (que vous vous connectiez immédiatement ou enregistrez sans connexion) s’affiche dans le Explorateur d'objets dans la vue MSSQL. L'Explorateur d'objets est l'endroit où vous accédez au contenu du serveur, exécutez des actions telles que des sauvegardes et reconnectez-vous aux bases de données que vous avez utilisées précédemment.

Groupes de connexions

Les connexions peuvent être organisées en groupes de connexions. Les groupes agissent comme des dossiers : vous pouvez les nommer, leur attribuer une couleur et placer des connexions à l’intérieur de ceux-ci pour conserver des environnements séparés visuellement (par exemple, Production, Préproduction et Local).

Créez un groupe : utilisez la commande Nouveau groupe de connexions ou affectez un nouveau groupe lors de la création ou de la modification d’une connexion.
Glisser-déposer pour organiser : faites glisser une connexion sur un groupe pour la déplacer dans ce groupe. Faites glisser un groupe sur un autre groupe pour l’imbriquer. Vous pouvez créer des groupes imbriqués à plusieurs niveaux.
Développer et réduire : utilisez les chevrons en regard de chaque groupe pour le développer et le réduire. Vous voyez donc uniquement les connexions avec lesquelles vous travaillez actuellement. Pour toujours démarrer avec les groupes réduits au lancement de Visual Studio Code, activez le paramètre mssql.collapseConnectionGroupsOnStartup.

Cliquez avec le bouton droit sur une connexion de serveur dans le Explorateur d'objets pour voir les actions qui s’appliquent à la connexion elle-même. Les options de connexion les plus couramment utilisées sont les suivantes :

Connecter / Déconnexion : démarrez ou terminez une session sur le serveur.
Modifier la connexion : ouvrez la boîte de dialogue Connexion avec le profil de connexion chargé pour modifier ses paramètres.
Copier la chaîne de connexion : copiez une chaîne de connexion de la connexion enregistrée dans votre presse-papiers. Cela est pratique lorsque vous devez partager la connexion avec un autre outil ou le coller dans le code de l’application. Les mots de passe et les secrets ne sont pas inclus.
Supprimer la connexion : supprimez la connexion de votre liste enregistrée.

Règles de pare-feu pour Azure SQL

Lorsque vous vous connectez à un Azure SQL Database ou Azure SQL Managed Instance à partir d'une adresse IP cliente qui n'est pas autorisée par le pare-feu du serveur, vous pouvez utiliser l'extension MSSQL pour ajouter une règle de pare-feu via la boîte de dialogue Ajouter une règle de pare-feu.

Dans la boîte de dialogue Ajouter une règle de pare-feu, connectez-vous avec un compte Microsoft qui dispose de l’autorisation de gérer le serveur, donnez un nom à la règle et choisissez d’autoriser uniquement votre adresse IP actuelle ou une plage. Une fois la règle enregistrée, votre connexion sera retentée automatiquement.

Connexions de l’espace de travail

Les connexions enregistrées et les groupes de connexions sont stockés dans votre Visual Studio Code settings.json. L’extension lit les connexions à partir de deux étendues :

Paramètres utilisateur (global) : les nouvelles connexions sont enregistrées ici. Ils sont disponibles dans toutes vos sessions Visual Studio Code, quel que soit le dossier ouvert.
Paramètres de l’espace de travail : les connexions enregistrées au niveau de l’espace de travail ne sont disponibles que lorsque cet espace de travail est ouvert. Cette étendue est utile pour les connexions spécifiques au projet que vous souhaitez partager avec des collaborateurs en vérifiant le fichier d’espace de travail .code-workspace dans le contrôle de code source.

Pour déplacer une connexion des paramètres utilisateur vers les paramètres de l’espace de travail, copiez l’entrée JSON de votre utilisateur dans l’espace settings.json de travail settings.json, puis supprimez-la de la configuration utilisateur.

Note

L’extension ne lit pas les connexions dans les paramètres du dossier d’espace de travail individuels (le .vscode/settings.json propre à chaque dossier dans un espace de travail à racines multiples). Si vous souhaitez qu’une connexion s’applique à un projet spécifique, enregistrez-la au niveau de l’espace de travail à la place.

Lorsque vous enregistrez une connexion avec un mot de passe ou un secret, son mot de passe n’est pas stocké dans settings.json. Les mots de passe sont conservés séparément dans le magasin d'informations d'identification sécurisé de Visual Studio Code.

Sélection de la connexion lors de l’ouverture d’un nouveau fichier ou éditeur SQL

Lorsque vous ouvrez un fichier ou créez un .sql éditeur SQL, l’extension peut laisser l’éditeur déconnecté ou le connecter automatiquement.

Ce comportement est contrôlé par le mssql.newEditorConnectionBehavior paramètre, qui prend en charge trois modes :

Mode	Description
`none`	Les nouveaux éditeurs SQL s’ouvrent sans connexion. Vous êtes invité à choisir une connexion la première fois que vous exécutez une requête, ou vous pouvez utiliser la commande SQL : Connect pour attacher une connexion manuellement.
`transferActive` (valeur par défaut)	Les nouveaux éditeurs SQL sont automatiquement connectés à la même base de données que votre éditeur SQL actif. Cela est pratique lorsque vous travaillez sur plusieurs fichiers sur la même base de données et que vous ne souhaitez pas reconnecter chacun d’eux. Si aucun éditeur SQL n’est actuellement actif, le nouvel éditeur s’ouvre sans connexion.
`defaultConnection`	Les nouveaux éditeurs SQL sont automatiquement connectés à une connexion spécifique que vous avez désignée comme votre valeur par défaut. La connexion par défaut est identifiée par le `mssql.defaultConnectionId` paramètre. Pour utiliser ce mode, vous devez également définir `mssql.defaultConnectionId` l’ID de l’une de vos connexions enregistrées. Vous trouverez l’ID en examinant vos connexions enregistrées dans `settings.json`. Si `mssql.defaultConnectionId` elle n’est pas définie ou ne correspond plus à une connexion enregistrée, l’extension vous invite à choisir une connexion par défaut la prochaine fois que vous ouvrez un nouvel éditeur SQL.

Vous pouvez modifier ces paramètres à partir de l’interface utilisateur des paramètres de Visual Studio Code en recherchant mssql.newEditorConnectionBehavior ou mssql.defaultConnectionId.

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2026-06-23