Was ist die PostgreSQL-Erweiterung für Visual Studio Code? (Vorschau)

Die PostgreSQL-Erweiterung für Visual Studio Code vereinfacht die Verwaltung und Entwicklung von PostgreSQL-Datenbanken. Sie können eine Verbindung mit PostgreSQL-Datenbanken herstellen, Abfragen schreiben und ausführen und Datenbankobjekte verwalten, ohne Visual Studio Code zu verlassen.

Die Erweiterung ist in Azure verwaltete PostgreSQL-Dienste integriert, darunter:

  • Azure HorizonDB – ein cloudeigener PostgreSQL-Dienst, der für Enterprise-Workloads der Ebene 1 entwickelt wurde. HorizonDB verfügt über eine disaggregierte Speicher-/Compute-Architektur, Commit-Vorgänge mit geringer Latenz, schnelles Failover, lastenausgeglichene horizontale Leseskalierung über lesbare HA-Replikate hinweg und eine umfassende KI-Integration.

Die gleiche Erweiterung funktioniert für beide Dienste. Wenn sich das Verhalten unterscheidet (z. B. Verbindungsendpunkte oder unterstützte Authentifizierungsmethoden), wird es in den folgenden Abschnitten aufgerufen.

Installieren der Erweiterung

Sie können die PostgreSQL-Erweiterung direkt über den Extensions Marketplace in Visual Studio Code installieren. führen Sie die folgenden Schritte aus:

  1. Öffnen Sie die Ansicht "Erweiterungen" in Visual Studio Code, indem Sie das Symbol Extensions in der Aktivitätsleiste auswählen oder den Befehl View: Extensions verwenden.
  2. Suchen Sie im Extensions Marketplace nach PostgreSQL .
  3. Wählen Sie die von Microsoft erstellte PostgreSQL-Erweiterung und dann "Installieren" aus.

Wenn Sie die Erweiterung installieren, wird ein Elefantensymbol angezeigt, um die PostgreSQL-Seite in der Visual Studio Code-Randleiste darzustellen.

Features

Die PostgreSQL-Erweiterung für Visual Studio Code bietet die folgenden Features für Azure HorizonDB.

Verbindungs-Manager

Der Verbindungs-Manager vereinfacht die Verbindung mit lokalen und in der Cloud gehosteten PostgreSQL-Datenbanken. Die wichtigsten Funktionen:

  • Unterstützung für mehrere Verbindungsprofile, sodass Sie eine Verbindung mit mehreren PostgreSQL-Instanzen nebeneinander herstellen und verwalten können, einschließlich einer Mischung aus Azure HorizonDB-Clustern.
  • Verbindungszeichenfolgenanalyse für nahtlose Konnektivität, unabhängig davon, ob Sie eine Verbindung mit einer lokalen Datenbank herstellen, einem Azure HorizonDB-Cluster.
  • Integration mit Azure HorizonDB für direktes Browsen und Filtern von Instanzen nach Abonnement, Ressourcengruppe, Server/Cluster und Datenbank.

Azure HorizonDB-Verbindungsendpunkte

Azure HorizonDB macht zwei Endpunkte verfügbar, die Sie in der Erweiterung als separate Verbindungsprofile hinzufügen können:

  • Endpunkt mit Lese-/Schreibzugriff – Stellt eine Verbindung mit der primären Verbindung dar, die sowohl Lese- als auch Schreibvorgänge akzeptiert. Verwenden Sie diesen Endpunkt für Anwendungsschreibvorgänge, Schemaänderungen und alle Leseworkloads, die die neuesten zugesicherten Daten erfordern. Der Endpunkt wird auf der Clusterseite Overview und auf der Seite Replicas im Azure-Portal aufgeführt.
  • Leseendpunkt – Verteilt schreibgeschützte Verbindungen automatisch per Lastenausgleich auf alle lesbaren HA-Replikate im Cluster. Verwenden Sie diesen Endpunkt für horizontale Leseskalierungsworkloads, Berichte und Analysen. Derzeit werden bis zu vier lesbare HA-Replikate unterstützt (wird auf 8 erhöht), wobei jede dieselbe Größe wie die primäre Instanz hat.

Ein typisches Muster besteht darin, im Verbindungs-Manager zwei Profile zu speichern – eines, das auf den Lese-/Schreib-Endpunkt verweist, und eines, das auf den Reader-Endpunkt verweist – und je nach anstehender Aufgabe im Objekt-Explorer zwischen ihnen zu wechseln.

Objekt-Explorer

Der erweiterte Objekt-Explorer bietet eine hierarchische Ansicht von Datenbankobjekten und erleichtert das Durchsuchen und Verwalten von Schemas, Tabellen, Ansichten und Funktionen. Zu den nennenswerten Features gehören:

  • Erweiterte Filteroptionen zum schnellen Auffinden bestimmter Objekte.
  • Funktionen zum Erstellen, Ändern und Löschen von Datenbankobjekten wie Tabellen, Ansichten und gespeicherten Prozeduren.
  • Visualisierung von Datenbankschemas und Beziehungen für optimierte Navigation.
  • Für Azure HorizonDB können Sie die im Cluster verfügbaren 55+ zugelassenen Erweiterungen direkt im Abfrage-Editor über die Katalogansicht pg_available_extensions einsehen.

Abfrage-Editor

Der Abfrage-Editor verbessert die Abfrageentwurfs- und Ausführungserfahrung mit:

  • Kontextfähige IntelliSense für die automatische Vervollständigen von SQL-Schlüsselwörtern, Tabellennamen und -Funktionen.
  • Syntaxmarkierung und Autoformatierung zur besseren Lesbarkeit von Abfragen.
  • Nachverfolgung des Abfrageverlaufs, sodass Sie zuvor ausgeführte Abfragen wiederverwenden können.

Ergebnisanzeige

Mit der Ergebnisanzeige können Sie mit Abfrageergebnissen mithilfe von Funktionen wie beispielsweise:

  • Exportieren von Ergebnissen in CSV-, JSON- oder Excel-Formate.
  • Such-, Filter- und Sortieroptionen zum effizienten Analysieren von Daten.
  • Beständige Datenansichten, um den Kontext beim Navigieren zwischen Registerkarten beizubehalten.

Schemavisualisierung

Mit der Schemaschnellansicht erhalten Sie eine interaktive, diagrammbasierte Ansicht Ihrer Datenbankstruktur, ohne SQL zu schreiben. Klicken Sie im Objekt-Explorer mit der rechten Maustaste auf eine Datenbank (oder ein objekt darunter), und wählen Sie Visualize-Schema aus, um die Visualisierung zu starten.

Zu den wichtigsten Funktionen gehören:

  • Vollständige Tabellenansicht – Jede Tabelle wird als Karte mit den zugehörigen Spalten und Datentypen gerendert.
  • Beziehungslinien – Fremdschlüsselbeziehungen zwischen Tabellen werden als Verbindungslinien gezeichnet, sodass Sie auf einen Blick sehen können, wie Ihr Datenmodell zusammenpasst.
  • Schemabasierte Organisation – Tabellen werden nach ihrem übergeordneten Schema gruppiert (z. B. , , publichr), wodurch es einfach ist, ecomin großen Datenbanken zu navigieren.
  • Ein-/Ausblenden nach Schema – Schalten Sie ganze Schemas ein oder aus, um sich nur auf die Teile des Modells zu konzentrieren, die Sie interessieren, und um Diagramme in großen Datenbanken lesbar zu halten.
  • Verschieben und Zoomen – Navigieren Sie in großen Diagrammen mit standardmäßigen Schwenk-, Zoom- und Bildschirmanpassungssteuerelementen.

Die Schemavisualisierung funktioniert mit jeder verbundenen Datenbank, einschließlich lokaler PostgreSQL- und Azure HorizonDB-Clustern.

Apache AGE Graph-Visualisierung

Mit der Apache AGE Graph Visualizer können Sie Apache AGE Cypher-Abfragen ausführen und die Ergebnisse als interaktives Knoten-Edge-Diagramm untersuchen. Die Erweiterung erkennt automatisch die Ergebnisse von Graphabfragen und stellt sie in einem visuellen Explorer mit Beschriftungen pro Knoten, Zoom- und Schwenkfunktionen, Exportfunktion und themenabhängiger Formatierung dar.

Die age-Erweiterung ist standardmäßig auf Azure HorizonDB zugelassen, sodass Graph-Workloads ohne zusätzliche Konfiguration auf einem HorizonDB-Cluster ausgeführt werden können. Die gleichen Anforderungen gelten beim Erstellen von Cypher-Abfragen für HorizonDB:

  • Zurückgeben vollständiger Objekte, nicht skalarer Eigenschaften – Die Diagrammschnellansicht benötigt vollständige Vertex- und Randobjekte. Abfragen, die skalare EigenschaftenRETURN p.name, p.title () extrahieren, geben Nur-Text-Werte zurück und werden im Visualizer nicht gerendert. Geben Sie stattdessen die vollständigen Objekte zurück, und benennen Sie die Beziehungsvariable:

    SELECT * FROM cypher('my_graph', $$
    MATCH (a:Product)-[r:BOUGHT_TOGETHER]->(b:Product)
    RETURN a, r, b
$$) AS (a agtype, r agtype, b agtype);

  • Setzen Sie disp_label für aussagekräftigen Knotentext - Ohne disp_label zeigen die Knoten interne IDs an. Legen Sie diese Eigenschaft so fest, dass die Visualisierung nützliche Bezeichnungen anzeigt:

    SELECT * FROM cypher('my_graph', $$
    MATCH (a:Product)-[r:BOUGHT_TOGETHER]->(b:Product)
    SET a.disp_label = a.title
    SET b.disp_label = b.title
    RETURN a, r, b
$$) AS (a agtype, r agtype, b agtype);

  • Abgleichen von Ausgabespalten an zurückgegebene Objekte – Die Wrapperklausel AS (...) muss eine Spalte pro zurückgegebenes Objekt aufweisen. Fügen Sie für Multi-Hop-Abfragen jeden Zwischenknoten und jede Kante ein:

    SELECT * FROM cypher('my_graph', $$
    MATCH (a:Product)-[r1:BOUGHT_TOGETHER]->(mid:Product)-[r2:BOUGHT_TOGETHER]->(b:Product)
    RETURN a, r1, mid, r2, b
$$) AS (a agtype, r1 agtype, mid agtype, r2 agtype, b agtype);

KI-Integration (Azure HorizonDB)

Wenn Sie mit einem Azure HorizonDB-Cluster verbunden sind, bietet ihnen die Erweiterung eine erstklassige Erstellungsoberfläche für die KI-Funktionen von HorizonDB, die als standardmäßige PostgreSQL-Erweiterungen und -Funktionen verfügbar gemacht werden:

  • pgvector
    • Vektordatentyp- und Ähnlichkeitsoperatoren.
  • pg_diskann
    • Hochleistungsvektorindex mit erweiterter Filterung, der Prädikate während der Vektordiagramm-Traversalabfragen auswertet WHERE , sodass gefilterte Ähnlichkeitsabfragen schneller und konsistenter zurückgegeben werden.
  • azure_ai
    • KI-Funktionen wie azure_ai.generate(), azure_ai.is_true(), , azure_ai.extract()und azure_openai.create_embeddings().
  • KI-Modellverwaltung (eingeschränkte Vorschau)
    • Wenn dies im Cluster aktiviert ist, stellt HorizonDB automatisch ein Standardchatmodell (gpt-5) und ein Standardeinbettungsmodell (text-embedding-3-small) über Microsoft Foundry bereit, installiert und konfiguriert azure_ai und verkabelt die AI-Funktionen mit diesen verwalteten Modellen – keine manuelle Tastenbehandlung erforderlich. Sie können auch Ihre eigenen Microsoft Foundry-Bereitstellungen (Bring Your Own Model) registrieren und sie aus denselben KI-Funktionen heraus über einen Alias aufrufen.

Sie können diese KI-Workloads direkt im Abfrage-Editor erstellen und ausführen, und die Ergebnisanzeige zeigt die Vektor- und JSONB-Ausgabe inline an.

Pipelines und Workflows

Bei Verbindung mit einem Azure HorizonDB-Cluster mit KI-Pipelines oder pg_durable-Workflows stellt die Erweiterung eine Ansicht Pipelines und Workflows bereit, mit der sich der Ausführungsverlauf prüfen und der Ausführungsstatus überwachen lassen.

Greifen Sie darauf zu, indem Sie mit der rechten Maustaste auf Ihre Datenbank klicken und Pipelines & Workflows auswählen. Es werden zwei Registerkarten angezeigt:

  • KI-Pipelines: Anzeigen von Pipelinedefinitionen, Überprüfungsläufen und Nachverfolgen von Ausführungsdiagrammen mit farbcodierten Schritttypen (blau für Quelle/Senken, Grün für die Verarbeitung, Rosa für externe Anrufe). Verwenden Sie dies, um das Verhalten der Pipeline zu überprüfen und Ausführungsstatus, Ausführungs-IDs, Startzeiten und Dauer zu prüfen.
  • Workflows: Überprüfen sie pg_durable Workflowinstanzen mit Registerkarten für Diagramme, Zeitplanungsanalysen und Ergebnisse. Navigieren Sie von einem Workflow zur zugehörigen Pipelinedefinition zum Vergleich und zur Problembehandlung.

Diese Ansicht beseitigt die Notwendigkeit, zwischen SQL-Abfragen und Ihrem Editor zu wechseln, wodurch es einfach ist, lange ausgeführte KI-Workloads und pg_durable Orchestrierungen zu überwachen.

GitHub Copilot-Integration

Diese Erweiterung ist in GitHub Copilot integriert, um KI-gesteuerte Unterstützung anzubieten, die auf die PostgreSQL-Entwicklung zugeschnitten ist. Mit Befehlen wie @pgsql können Sie Ihre Datenbank abfragen, Ihr Schema optimieren und Copilot anfordern, bestimmte SQL-Vorgänge für einen Azure HorizonDB-Cluster auszuführen. Copilot greift den Kontext der Liveverbindung auf – einschließlich der auf dem Ziel installierten Erweiterungen –, sodass Vorschläge für eine HorizonDB-Verbindung pgvector, pg_diskann, azure_ai und age berücksichtigen.

Unterstützte Betriebssysteme

Die PostgreSQL-Erweiterung funktioniert mit den folgenden Betriebssystemen:

  • Windows
  • macOS
  • Linux

Die Erweiterung unterstützt verschiedene Linux-Distributionen, einschließlich Ubuntu, Fedora und Red Hat Enterprise Linux.

Feedback und Support

Verwenden Sie für Fehler, Featureanforderungen und Probleme das integrierte Feedbacktool in Visual Studio Code. Sie können dieses Feedback über das Visual Studio Code-Hilfemenü oder die PGSQL-Befehlspalette abschließen.

  • Hilfemenü
    • Gehe zu Hilfe > Problem melden
  • Befehlspalette
    • Öffnen Sie die Befehlspalette mit Ctrl + Shift + P , und führen Sie Folgendes aus: PGSQL: Report Issue

Verwandte Inhalte

  • Last updated on