Extension PostgreSQL pour Visual Studio Code

L’extension PostgreSQL pour Visual Studio Code (ms-ossdata.vscode-pgsql) apporte des outils de développement de base de données directement dans votre éditeur. Vous pouvez vous connecter à des serveurs PostgreSQL locaux, locaux ou cloud, écrire des requêtes avec IntelliSense, explorer des objets de base de données, visualiser des plans de requête et des schémas, et gérer Azure Database pour PostgreSQL ressources serveur flexibles, tout cela sans quitter VS Code. L’extension s’intègre également aux assistants IA pour la rédaction de requêtes assistée par l’IA, l’analyse et les flux de travail pilotés par des agents.

Note

L’extension s’exécute également dans Cursor. Les fonctionnalités d’IA de PostgreSQL sont prises en charge dans les deux éditeurs et suivent l’expérience IA native de chacun : Visual Studio Code inclut le participant de chat @pgsql ainsi que le mode Agent et l’enregistrement du serveur MCP, tandis que Cursor utilise Connect AI (mode Agent) ou l’enregistrement du serveur MCP.

Get started

Si vous débutez avec l’extension, commencez par l’un des guides suivants :

Objectif Guide
Exécutez votre première requête Démarrage rapide : Se connecter et interroger PostgreSQL
Trouver l’article approprié pour votre tâche Flux de travail courants
Configurer l’identité, TLS ou les profils enregistrés Connexions et identités

Installer l’extension

  1. Ouvrez Visual Studio Code.
  2. Ouvrez la vue Extensions (Ctrl+Shift+Xou Cmd+Shift+X sur macOS).
  3. Recherchez postgresql.
  4. Sélectionnez PostgreSQL par Microsoft, puis sélectionnez Installer.

Tip

Après l’installation, une icône PostgreSQL apparaît dans la barre d’activité. Sélectionnez-le pour ouvrir la vue PostgreSQL, où vous gérez les connexions et explorez les objets de base de données.

Fonctionnalités clés

Les sections suivantes résument chaque zone de fonctionnalité principale. Sélectionnez le lien à la fin de chaque section pour l’article complet.

Boîte de dialogue Connexion

La boîte de dialogue de connexion vous connecte aux serveurs PostgreSQL locaux, locaux et cloud, avec prise en charge intégrée de l’authentification pour Microsoft Entra ID et AWS IAM (RDS/Aurora). Saisissez individuellement les paramètres de connexion, collez une chaîne de connexion ou parcourez vos abonnements Azure pour découvrir les serveurs flexibles Azure Database pour PostgreSQL et les clusters Azure HorizonDB (préversion).

  • Trois modes d’entrée : paramètres pour des valeurs individuelles telles que l’hôte, le port, la base de données et le nom d’utilisateur ; Connection String pour une chaîne de connexion complète ou parcourir Azure pour parcourir vos ressources Azure et sélectionner une ressource avec un point de terminaison PostgreSQL.
  • Connexions enregistrées et récentes : les profils enregistrés apparaissent dans la liste Connexions pour une réutilisation rapide ; les connexions récemment utilisées sont toujours disponibles.
  • Groupes de serveurs : organisez les connexions en groupes nommés avec codage de couleur pour identifier rapidement les connexions dans l’arborescence Connexions .

Pour plus d’informations, consultez Connexions et options d’identité et de connexion avancées.

Explorateur d’objets

L’Explorateur d’objets fournit une arborescence navigable de vos serveurs PostgreSQL connectés. Développez des serveurs, des bases de données et des schémas pour inspecter des tables, des vues, des fonctions, des séquences, des types, des extensions, des rôles, des espaces de table et des déclencheurs d’événements.

  • Recherche : recherchez des objets par nom dans tous les types d’objets pris en charge avec la recherche intégrée.
  • Script : cliquez avec le bouton droit sur n’importe quel objet pour générer SELECT, CREATEALTER, , DROPou EXECUTE des scripts qui s’ouvrent dans l’éditeur de requête.
  • Actualisation approfondie : actualisez n’importe quel nœud pour mettre à jour de manière récursive tous les descendants développés, reflétant les modifications de schéma sans déconnexion.

Pour plus d’informations, consultez l’Explorateur d’objets.

Éditeur de requête et IntelliSense

L’éditeur de requête fournit une surface d’édition enrichie pour PostgreSQL SQL. IntelliSense offre des saisies complètes prenant en charge le contexte pour les noms de tables, les noms de colonnes, les fonctions, les schémas, les mots clés et les clauses de jointure.

  • Exécuter la requête et exécuter l’instruction actuelle : exécutez le contenu complet de l’éditeur ou uniquement l’instruction au niveau du curseur.
  • Extraits de code : insérer des modèles SQL courants tels que CREATE TABLE, INSERTet SELECT.
  • Historique des requêtes : accédez aux requêtes précédemment exécutées à partir de la palette de commandes pour les réexécuter ou les modifier.

Pour plus d’informations, consultez l’éditeur de requête et IntelliSense.

Résultats de la requête

Les résultats s’affichent dans le panneau Résultats des requêtes PostgreSQL sous l’éditeur. La grille de résultats prend en charge le tri, le filtrage et le redimensionnement des colonnes.

  • Exportation : enregistrez les résultats au format CSV, JSON ou Excel.
  • Visualisation du graphique : visualisez les résultats sous forme de graphiques en courbes, en barres, en secteurs ou en nuages de points.
  • Vue graphique : Les résultats de la requête graphe Apache AGE basculent automatiquement vers une vue nœud et périphérie.
  • Onglet Messages : passez en revue les nombres de lignes, les temps d’exécution et les messages serveur.

Pour plus d’informations, consultez l’éditeur de requête et IntelliSense.

Visualiseur du plan de requête

Le visualiseur de plan de requête présente la EXPLAIN sortie dans plusieurs formats interactifs afin de pouvoir identifier les goulots d’étranglement des performances.

  • Quatre vues : Vue arborescente, Vue Icicle, Vue tabulaire et Vue source.
  • Métriques : inspecter les estimations de coûts, les nombres de lignes réels, le temps d’exécution et l’utilisation de la mémoire tampon par nœud.
  • Plans d’importation : visualiser les fichiers de plan enregistrés ou le contenu de l’éditeur sans connexion de base de données active.
  • Copilot analyse : sélectionnez Analyser avec Copilot (ou Analyser avec l’IA dans le curseur) pour obtenir une explication générée par l’IA du plan.

Pour plus d’informations, consultez visualiseur de plan de requête.

Visualiseur de schéma

Le visualiseur de schéma génère un diagramme de relation d’entité interactive. Les tables apparaissent sous la forme de nœuds déplaçables, dont les colonnes sont listées à l’intérieur, et les relations de clé étrangère s’affichent sous forme d’arêtes de connexion.

  • Schémas codés en couleurs : chaque schéma reçoit une couleur distincte pour l’identification rapide.
  • Bascule de légende : afficher ou masquer la légende du schéma pour optimiser l’espace du diagramme.

Pour plus d’informations, consultez le visualiseur de schéma.

Tableau de bord du serveur

Le tableau de bord du serveur affiche les propriétés de connexion, la version du serveur et l’état SSL de n’importe quel serveur connecté. Pour les serveurs flexibles Azure Database pour PostgreSQL, il affiche également les métriques Azure Monitor. Les onglets d’investigation vous permettent d’explorer des zones spécifiques de l’activité du serveur.

  • Vue d’ensemble : surveiller l’UC, la mémoire, le stockage, les connexions, les IOPS et d’autres métriques regroupées par catégorie.
  • Requêtes : affichez les principales instructions SQL classées par heure d’exécution, nombre d’appels ou autres métriques, avec des détails de requête individuels.
  • Attentes : analysez les événements d’attente avec un tableau trié et un graphique chronologique.
  • Sessions : inspecter les sessions actives, les arbres de blocage et l’activité de verrouillage.
  • Actions de barre d’outils : connecter, déconnecter, ouvrir un nouvel éditeur de requête, lancer le visualiseur de schéma, ouvrir une conversation IA ou démarrer Azure actions de gestion à partir de la barre d’outils du tableau de bord.

Pour plus d’informations, consultez le tableau de bord du serveur.

Azure gestion des serveurs

Gérez Azure Database pour PostgreSQL ressources serveur flexibles sans quitter VS Code.

  • Démarrez, arrêtez et redémarrez : contrôlez le cycle de vie du serveur à partir de l’arborescence Connexions ou du tableau de bord.
  • Règles de pare-feu : afficher et mettre à jour les règles d’accès réseau.
  • Paramètres : parcourez et modifiez les paramètres.
  • Serveur clone : dupliquer une configuration de serveur existante.

Pour plus d’informations, consultez Azure gestion des serveurs.

Création du serveur

Provisionnez de nouveaux serveurs PostgreSQL directement à partir de VS Code.

  • Docker : créez un serveur PostgreSQL local dans un conteneur Docker pour le développement et le test.
  • Azure Database pour PostgreSQL serveur flexible : parcourez une configuration guidée qui configure la région, le niveau de calcul, le stockage et l’authentification.
  • Azure HorizonDB (préversion) : provisionnez un cluster PostgreSQL natif cloud et hautement évolutif avec des vCores configurables et des fonctionnalités d’IA facultatives.

Pour plus d’informations, consultez Créer un serveur PostgreSQL.

intégration de Copilot

L’extension s’intègre aux assistants IA dans le chat, les actions de l’éditeur et les flux de travail d’outils en plusieurs étapes.

  • @pgsql participant à la conversation : posez des questions en langage naturel sur vos bases de données, générez des requêtes ou obtenez de l’aide sur les concepts PostgreSQL dans le panneau gitHub Copilot Chat. Visual Studio Code uniquement. Pour plus d’informations, consultez @pgsql participant du chat.
  • Actions de l’éditeur : cliquez avec le bouton droit sur SQL dans l’éditeur pour expliquer une requête, la réécrire pour l’optimisation ou analyser son plan d’exécution à partir du sous-menu Actions de requête IA . Disponible à la fois dans Visual Studio Code et Cursor.
  • Mode agent : l’agent IA appelle directement les outils PostgreSQL, combinant le raisonnement ia avec les opérations de base de données dynamiques. Disponible dans Visual Studio Code et Cursor. Pour plus d’informations, consultez le mode Agent.

Pour obtenir une vue d’ensemble de toutes les fonctionnalités d’IA, consultez Copilot intégration.

Serveur MCP

L’extension inscrit un serveur MCP (Model Context Protocol) qui expose les outils PostgreSQL, notamment la gestion des connexions, l’exploration de schéma, l’exécution des requêtes et la visualisation du plan de requête, aux hôtes prenant en charge l’IA. Les outils IA externes peuvent interagir avec vos connexions PostgreSQL par programmation via cette inscription.

Pour plus d’informations, consultez le serveur MCP.

Utiliser psql dans le terminal

Ouvrez une psql session de terminal connectée à n’importe quelle base de données dans l’arborescence Connexions, ou exécutez directement les fichiers .sql via psql depuis le menu contextuel de l’éditeur. Cela vous donne un accès complet aux fonctionnalités natives psql telles que \ les méta-commandes et COPYles scripts interactifs.

Pour plus d’informations, consultez Utiliser psql dans le terminal.

Migration d’Oracle vers PostgreSQL

Un flux de travail de migration assisté par IA vous permet de convertir des schémas et des objets de base de données Oracle en SQL compatible avec PostgreSQL.

  • Migration guidée : connectez-vous à une source Oracle, sélectionnez des objets à migrer et passez en revue la sortie convertie.
  • Conversion assistée par l’IA : un modèle Microsoft Foundry traduit la syntaxe, les types de données et le code procédural oracle en équivalents PostgreSQL.

Pour plus d’informations, consultez la migration d’Oracle vers PostgreSQL.

Systèmes d'exploitation pris en charge

Système d'exploitation Architecture Remarques
Windows x64, Arm64 Arm64 nécessite Windows 11.
macOS x64, Arm64 -
Linux x64, Arm64 Nécessite glibc version 2.35 ou ultérieure.

Commentaires et support

Pour signaler un bogue ou demander une fonctionnalité, signalez un problème dans le référentiel vscode-pgsql GitHub.