PostgreSQL-Erweiterung für Visual Studio Code

Die PostgreSQL-Erweiterung für Visual Studio Code (ms-ossdata.vscode-pgsql) bringt Datenbankentwicklungstools direkt in Ihren Editor. Sie können eine Verbindung mit lokalen, lokalen Rechenzentrums- oder cloudbasierten PostgreSQL-Servern herstellen, Abfragen mit IntelliSense schreiben, Datenbankobjekte untersuchen, Abfragepläne und Schemata visualisieren und Ressourcen von Azure Database for PostgreSQL – Flexible Server verwalten, all dies, ohne VS Code zu verlassen. Die Erweiterung integriert sich auch mit KI-Assistenten für die KI-gestützte Abfrageerstellung, Analyse und agentengesteuerte Workflows.

Note

Die Erweiterung wird auch im Cursor ausgeführt. PostgreSQL-KI-Funktionen werden in beiden Editoren unterstützt und folgen der nativen KI-Nutzererfahrung des jeweiligen Editors: Visual Studio Code enthält den @pgsql-Chatteilnehmer zusammen mit dem Agent-Modus und der MCP-Serverregistrierung, während Cursor Connect AI (Agent-Modus) oder die MCP-Serverregistrierung verwendet.

Erste Schritte

Wenn Sie mit der Erweiterung noch nicht vertraut sind, beginnen Sie mit einem der folgenden Leitfäden:

Zielsetzung Guide
Ausführen der ersten Abfrage Schnellstart: Verbinden und Abfragen von PostgreSQL
Suchen des richtigen Artikels für Ihre Aufgabe Allgemeine Workflows
Konfigurieren von Identitäts-, TLS- oder gespeicherten Profilen Verbindungen und Identität

Installieren der Erweiterung

  1. Öffnen Sie Visual Studio Code.
  2. Öffnen Sie die Erweiterungsansicht (Ctrl+Shift+Xoder Cmd+Shift+X unter macOS).
  3. Suchen Sie nach Postgresql.
  4. Wählen Sie PostgreSQL durch Microsoft und dann "Installieren" aus.

Tip

Nach der Installation wird in der Aktivitätsleiste ein PostgreSQL-Symbol angezeigt. Wählen Sie sie aus, um die PostgreSQL-Ansicht zu öffnen, in der Sie Verbindungen verwalten und Datenbankobjekte erkunden.

Wichtigste Funktionen

In den folgenden Abschnitten werden alle wichtigen Featurebereiche zusammengefasst. Wählen Sie den Link am Ende jedes Abschnitts für den vollständigen Artikel aus.

Verbindungsdialog

Mit dem Verbindungsdialogfeld können Sie eine Verbindung mit lokalen, On-Premises- und cloudbasierten PostgreSQL-Servern herstellen, mit integrierter Unterstützung für die Authentifizierung über Microsoft Entra ID und AWS IAM (RDS/Aurora). Geben Sie Verbindungsparameter einzeln ein, fügen Sie eine Verbindungszeichenfolge ein, oder durchsuchen Sie Ihre Azure Abonnements, um Azure Database for PostgreSQL flexible Server und Azure HorizonDB (Preview)-Cluster zu ermitteln.

  • Drei Eingabemodi: Parameter für einzelne Werte wie Host, Port, Datenbank und Benutzername; Connection String für eine vollständige Verbindungszeichenfolge; oder durchsuchen Sie Azure, um zu Ihren Azure Ressourcen zu navigieren und eine Ressource mit einem PostgreSQL-Endpunkt auszuwählen.
  • Gespeicherte und zuletzt verwendete Verbindungen: Gespeicherte Profile werden in der Liste "Verbindungen " angezeigt, um schnell wiederzuverwenden; Zuletzt verwendete Verbindungen sind immer verfügbar.
  • Servergruppen: Organisieren Sie Verbindungen mit benannten Gruppen mit Farbcodierung, um Verbindungen in der Connections-Struktur schnell zu identifizieren.

Ausführliche Informationen finden Sie unter "Verbindungen" und "Identität " und "Erweiterte Verbindungsoptionen".

Objekt-Explorer

Der Objekt-Explorer stellt eine navigierbare Strukturansicht Ihrer verbundenen PostgreSQL-Server bereit. Erweitern Sie Server, Datenbanken und Schemas, um Tabellen, Ansichten, Funktionen, Sequenzen, Typen, Erweiterungen, Rollen, Tabellenbereiche und Ereignistrigger anzuzeigen.

  • Suche: Suchen Sie Objekte anhand des Namens für alle unterstützten Objekttypen mit der integrierten Suche.
  • Skripting: Klicken Sie mit der rechten Maustaste auf ein beliebiges Objekt, um im Abfrage-Editor geöffnete , SELECT, , CREATE, ALTERoder DROP Skripts zu generierenEXECUTE.
  • Umfassende Aktualisierung: Aktualisieren Sie alle Knoten, um alle erweiterten Nachfolger rekursiv zu aktualisieren, wobei Schemaänderungen ohne Trennen widergespiegelt werden.

Weitere Informationen finden Sie im Objekt-Explorer.

Abfrage-Editor und IntelliSense

Der Abfrage-Editor bietet eine umfangreiche Bearbeitungsoberfläche für PostgreSQL SQL. IntelliSense bietet kontextbezogene Fertigstellungen für Tabellennamen, Spaltennamen, Funktionen, Schemas, Schlüsselwörter und Verknüpfungsklauseln.

  • Ausführen von Abfrage und Ausführen der aktuellen Anweisung: Führen Sie den vollständigen Editorinhalt oder nur die Anweisung am Cursor aus.
  • Codeausschnitte: Fügen Sie allgemeine SQL-Muster wie CREATE TABLE, , INSERTund SELECT.
  • Abfrageverlauf: Zugreifen auf zuvor ausgeführte Abfragen aus der Befehlspalette, um sie erneut auszuführen oder zu ändern.

Ausführliche Informationen finden Sie im Abfrage-Editor und IntelliSense.

Abfrageergebnisse

Die Ergebnisse werden im Bereich "Ergebnisse der PostgreSQL-Abfrage " unterhalb des Editors angezeigt. Das Ergebnisraster unterstützt das Sortieren, Filtern und Ändern der Spaltengröße.

  • Exportieren: Speichern Sie Ergebnisse in CSV, JSON oder Excel.
  • Diagrammvisualisierung: Visualisieren sie Ergebnisse als Linien-, Balken-, Kreis- oder Punktdiagramme.
  • Graph-Ansicht: Apache AGE-Graph-Abfrageergebnisse wechseln automatisch zu einer Knoten-und-Edge-Ansicht.
  • Registerkarte "Nachrichten": Anzahl der Zeilen überprüfen, Ausführungszeiten und Servernachrichten überprüfen.

Ausführliche Informationen finden Sie im Abfrage-Editor und IntelliSense.

Abfrageplan-Visualizer

Der Visualizer für den Abfrageplan zeigt EXPLAIN Ausgabe in mehreren interaktiven Formaten an, damit Sie Leistungsengpässe identifizieren können.

  • Vier Ansichten: Strukturansicht, Icicle-Ansicht, Tabellenansicht und Quellansicht.
  • Metriken: Kostenschätzungen, tatsächliche Zeilenanzahlen, Ausführungszeit und Puffernutzung pro Knoten prüfen.
  • Importieren von Plänen: Visualisieren Sie gespeicherte Plandateien oder Editorinhalte ohne Livedatenbankverbindung.
  • Copilot Analyse: Wählen Sie "Mit Copilot analysieren" (oder "Mit KI im Cursor analysieren") aus, um eine vom KI generierte Erläuterung des Plans zu erfahren.

Einzelheiten finden Sie unter Visualisierung des Abfrageplans.

Schema-Visualisierung

Die Schemaschnellansicht generiert ein interaktives Entitätsbeziehungsdiagramm. Tabellen werden als verschiebbare Knoten angezeigt, in denen die Spalten aufgelistet sind, und Fremdschlüsselbeziehungen werden als Verbindungslinien dargestellt.

  • Farbcodierte Schemas: Jedes Schema erhält eine unterschiedliche Farbe für die schnelle Identifizierung.
  • Legendenschalter: Ein- oder Ausblenden der Schemalegende zum Maximieren des Diagrammraums.

Details finden Sie unter Schema-Visualisierung.

Serverdashboard

Das Serverdashboard zeigt Verbindungseigenschaften, Serverversion und SSL-Status für jeden verbundenen Server an. Für Azure Database for PostgreSQL – Flexible Server werden auch Metriken von Azure Monitor angezeigt. Registerkarten für Untersuchungen ermöglichen Ihnen, bestimmte Bereiche der Serveraktivität genauer zu untersuchen.

  • Übersicht: Überwachen sie CPU, Arbeitsspeicher, Speicher, Verbindungen, IOPS und andere Metriken, die nach Kategorie gruppiert sind.
  • Abfragen: Anzeigen der wichtigsten SQL-Anweisungen, die nach Ausführungszeit, Anrufanzahl oder anderen Metriken bewertet wurden, mit Drilldown zu einzelnen Abfragedetails.
  • Waits: Warteereignisse mit einer Rangliste und einem Zeitverlaufsdiagramm analysieren.
  • Sitzungen: aktive Sitzungen, Blockierungsstrukturen und Sperraktivitäten überprüfen.
  • Aktionen in der Symbolleiste: verbinden, trennen, einen neuen Abfrage-Editor öffnen, den Schema-Visualizer starten, einen KI-Chat öffnen oder Azure-Verwaltungsaktionen über die Symbolleiste des Dashboards starten.

Ausführliche Informationen finden Sie im Serverdashboard.

Azure Serververwaltung

Verwalten Sie Azure Database for PostgreSQL flexible Serverressourcen, ohne VS Code zu verlassen.

  • Starten, beenden und neu starten: Steuern Sie den Serverlebenszyklus über die Connections-Struktur oder das Dashboard.
  • Firewallregeln: Anzeigen und Aktualisieren von Netzwerkzugriffsregeln.
  • Parameter: Durchsuchen und Ändern von Parametern.
  • Server klonen: Dupliziert eine vorhandene Serverkonfiguration.

Ausführliche Informationen finden Sie unter Azure Serververwaltung.

Servererstellung

Stellen Sie neue PostgreSQL-Server direkt über VS Code bereit.

  • Docker: Erstellen Sie einen lokalen PostgreSQL-Server in einem Docker-Container für Entwicklung und Tests.
  • Azure Database for PostgreSQL – Flexibler Server: Führen Sie eine angeleitete Einrichtung durch, bei der Region, Compute-Ebene, Speicher und Authentifizierung konfiguriert werden.
  • Azure HorizonDB (Vorschau):Bereitstellen eines cloudeigenen, hoch skalierbaren PostgreSQL-Clusters mit konfigurierbaren vCores und optionalen KI-Funktionen.

Ausführliche Informationen finden Sie unter Create a PostgreSQL server.

Copilot-Integration

Die Erweiterung lässt sich mit KI-Assistenten in Chats, Editor-Aktionen und mehrstufigen Tool-Workflows integrieren.

  • @pgsql Chatteilnehmer: Stellen Sie Fragen in natürlicher Sprache zu Ihren Datenbanken, generieren Sie Abfragen, oder erhalten Sie Hilfe zu PostgreSQL-Konzepten im GitHub Copilot Chat Panel. nur Visual Studio Code. Details siehe @pgsql Chat-Teilnehmer.
  • Editoraktionen: Klicken Sie im Editor mit der rechten Maustaste auf SQL, um eine Abfrage zu erläutern, sie zur Optimierung umzuschreiben oder ihren Ausführungsplan aus dem Untermenü "AI-Abfrageaktionen " zu analysieren. Verfügbar in Visual Studio Code und Cursor.
  • Agentenmodus: Der KI-Agent ruft PostgreSQL-Tools direkt auf und kombiniert KI-gestützte Schlussfolgerungen mit Live-Datenbankoperationen. Verfügbar in Visual Studio Code und Cursor. Ausführliche Informationen finden Sie im Agentmodus.

Eine Übersicht über alle KI-Funktionen finden Sie unter Copilot Integration.

MCP-Server

Die Erweiterung registriert einen MCP-Server (Model Context Protocol), der PostgreSQL-Tools verfügbar macht, einschließlich Verbindungsverwaltung, Schemaforschung, Abfrageausführung und Abfrageplanvisualisierung, für unterstützte KI-fähige Hosts. Externe KI-Tools können programmgesteuert mit Ihren PostgreSQL-Verbindungen über diese Registrierung interagieren.

Weitere Informationen finden Sie unter MCP-Server.

Verwenden von psql im Terminal

Öffnen Sie eine psql Terminalsitzung, die mit einer beliebigen Datenbank im Verbindungsbaum verbunden ist, oder führen Sie .sql-Dateien über psql direkt aus dem Kontextmenü des Editors aus. Dadurch erhalten Sie vollständigen Zugriff auf systemeigene psql Features wie \ Metabefehle, COPYund interaktive Skripts.

Ausführliche Informationen finden Sie unter Verwendung von psql im Terminal.

Oracle zu PostgreSQL-Migration

Ein KI-gestützter Migrationsworkflow hilft Ihnen dabei, Oracle-Datenbankschemas und -Objekte in PostgreSQL-kompatibles SQL umzuwandeln.

  • Geführte Migration: Stellen Sie eine Verbindung mit einer Oracle-Quelle her, wählen Sie zu migrierende Objekte aus, und überprüfen Sie die konvertierte Ausgabe.
  • KI-unterstützte Konvertierung: Ein Microsoft Foundry-Modell übersetzt Oracle-spezifische Syntax, Datentypen und prozeduralen Code in PostgreSQL-Entsprechungen.

Ausführliche Informationen finden Sie unter Oracle zu PostgreSQL-Migration.

Unterstützte Betriebssysteme

Betriebssystem Architecture Hinweise
Windows x64, Arm64 Arm64 erfordert Windows 11.
macOS x64, Arm64 -
Linux x64, Arm64 Erfordert glibc 2.35 oder höher.

Feedback und Support

Um einen Fehler zu melden oder ein Feature anzufordern, geben Sie ein Problem im vscode-pgsql GitHub Repository an.

Verwandte Inhalte

  • Last updated on