Freigeben über


Schnellstart: Verbinden und Abfragen einer Datenbank mit der PostgreSQL-Erweiterung für Visual Studio Code Preview

Die PostgreSQL-Erweiterung für Visual Studio Code ist ein leistungsfähiges Tool zur Optimierung der Entwicklung und Verwaltung von PostgreSQL-Datenbanken. Dieser Leitfaden führt Sie durch das Herstellen einer Verbindung mit einer PostgreSQL-Datenbank und ausführen von Abfragen innerhalb der Visual Studio Code-Umgebung.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie die richtigen Tools und Ressourcen heruntergeladen und installiert haben.

Diese Tools und Ressourcen helfen Ihnen, zusammen mit diesem Artikel zu folgen und die GitHub Copilot-Integration für die PostgreSQL-Erweiterung in Visual Studio Code optimal zu nutzen.

Installieren der PostgreSQL-Erweiterung

So installieren Sie die PostgreSQL-Erweiterung:

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

Nach der Installation wird die PostgreSQL-Seite, dargestellt durch ein Elefantensymbol, in der Visual Studio Code-Randleiste angezeigt.

Hinzufügen einer Verbindung zu PostgreSQL

Ob lokal oder auf einem Remoteserver gehostet, die Verbindung mit einer PostgreSQL-Datenbank ist ein grundlegender Schritt bei der Verwaltung und Interaktion mit Ihren Daten. Dieser Vorgang umfasst die Bereitstellung der erforderlichen Verbindungsdetails, z. B. die Serveradresse, den Port und die Authentifizierungsanmeldeinformationen, um eine sichere Verbindung zwischen Ihrer Clientanwendung und der Datenbank herzustellen. Mit der PostgreSQL-Erweiterung für Visual Studio Code können Sie nahtlos eine Verbindung mit Ihrer Datenbank herstellen und leistungsstarke Tools verwenden, um Ihre Daten effizient abzufragen, zu verwalten und zu erkunden.

  1. Wählen Sie das Elefantensymbol auf der Randleiste aus, um die PostgreSQL-Erweiterungsseite zu öffnen.

  2. Wählen Sie die Schaltfläche " Verbindung hinzufügen " aus.

  3. Geben Sie Die Verbindungsdetails manuell ein, oder verwenden Sie das Verbindungszeichenfolgenformat:

      psql -h <server>.postgres.database.azure.com -p 5432 -U
    
  4. Wenn Sie Azure verwenden, melden Sie sich bei Ihrem Azure-Konto an, und suchen Sie nach der Datenbankinstanz. Filtern Sie nach Abonnement, Ressourcengruppe, Server und Datenbankname.

Authentifizierung

Die Erweiterung unterstützt zwei Authentifizierungsmethoden:

  • Benutzername/Kennwort: Geben Sie Ihre Datenbankanmeldeinformationen direkt in die Verbindungsfelder ein.
  • Microsoft Entra ID-Authentifizierung: Fügen Sie Ihr Microsoft Entra-ID-Konto für von Azure gehostete Datenbanken hinzu.

Screenshot der PostgreSQL-Erweiterung für das Dialogfeld

Testen und Speichern der Verbindung

  1. Wählen Sie "Verbindung testen" aus, um die Verbindungsdetails zu überprüfen.
  2. Bei erfolgreichen Tests zeigt das Testfeld ein Häkchen an.
  3. Wählen Sie "Verbinden", um die Verbindung herzustellen.
  4. Ihre Verbindung wird automatisch gespeichert und im Fenster "Verbindungen" angezeigt.

Untersuchen von Datenbankobjekten

Der Objekt-Explorer bietet eine hierarchische Ansicht Ihrer Datenbankobjekte:

  • Erweitern Sie das Datenbankelement, um Schemas, Tabellen, Ansichten, Funktionen und gespeicherte Prozeduren anzuzeigen.
  • Klicken Sie mit der rechten Maustaste auf die Datenbank, und Sie sehen Optionen für: - Starten einer neuen Abfrage - Chat mit dieser Datenbank (startet die pgsql-Chaterfahrung) - Verbinden Sie sich mit PSQL, um eine psql-Terminalverbindung zu starten.
  • Klicken Sie mit der rechten Maustaste auf eine Tabelle und wählen Sie "Top 1000 auswählen" aus, um Daten anzuzeigen. Die Abfrage wird im Abfrage-Editor geöffnet, und die Ergebnisse werden auf der Registerkarte "Ergebnisanzeige" angezeigt.

Ausführen von Abfragen

Verwenden Sie den Abfrage-Editor, um SQL-Abfragen zu entwerfen und auszuführen:

  • Nutzen Sie kontextabhängige IntelliSense zum AutoVervollständigen von SQL-Schlüsselwörtern und Objektnamen.
  • Syntaxmarkierung und Autoformatierung sorgen für eine bessere Lesbarkeit und Genauigkeit.
  • Zugriff auf zuvor ausgeführte Abfragen über den Abfrageverlaufsbereich.

Überprüfen der Abfrageergebnisse

Die Ergebnisanzeige bietet erweiterte Features für die Interaktion mit Ihren Abfrageergebnissen:

  • Exportieren Sie Ergebnisse in CSV-, JSON- oder Excel-Formate zur weiteren Analyse.
  • Verwenden Sie Such-, Filter- und Sortieroptionen, um Ihre Daten zu verfeinern.
  • Beständige Datenansichten behalten den Kontext beim Wechseln zwischen Registerkarten bei.

Verwenden von GitHub Copilot für erweiterte Unterstützung

Die GitHub Copilot-Integration verbessert Ihre PostgreSQL-Entwicklungserfahrung, indem KI-gestützte Codevorschläge, Tipps zur Abfrageoptimierung und interaktive Datenbankunterstützung bereitgestellt werden. Mit diesem Feature können Sie Ihren Workflow optimieren, die Entwicklungszeit reduzieren und tiefere Einblicke in Ihre Datenbankvorgänge gewinnen. Dieser Abschnitt führt Sie durch die Schritte zum Aktivieren und Verwenden von Copilot innerhalb der PostgreSQL-Erweiterung für Visual Studio Code.

Stellen Sie sicher, dass die GitHub Copilot- und Copilot-Chaterweiterungen installiert sind.

Melden Sie sich bei Ihrem GitHub-Konto an, und aktivieren Sie den @pgsql Copilot-Chat-Agent in den Erweiterungseinstellungen.

Interaktive Datenbankaufforderungen

Klicken Sie mit der rechten Maustaste auf eine Datenbank, und wählen Sie "Mit dieser Datenbank chatten " aus, um mit Copilot zu interagieren.

Schreiben Sie Eingabeaufforderungen wie das folgende Beispiel, um detaillierte Einblicke und Vorschläge zu erhalten.

@pgsql tell me about the tables in the HR schema

Weitere Informationen finden Sie unter Configure GitHub Copilot

Herstellen einer Verbindung mit einer Azure Database for PostgreSQL – Flexibler Server-Instanz mit VS Code über das Azure-Portal

Führen Sie die folgenden Schritte aus, um eine Verbindung mit einer flexiblen Azure-Datenbank für PostgreSQL mit Visual Studio Code herzustellen:

  1. Melden Sie sich beim Azure-Portal an, und wählen Sie Ihre Azure Database for PostgreSQL – Flexibler Server-Instanz aus.
  2. Wechseln Sie zur Seite "Übersicht" Ihrer Serverinstanz.

Verbinden mit VS Code

Die Option "Mit Visual Studio Code verbinden" im Azure-Portal vereinfacht die Verbindung mit Ihrer Azure-Datenbank für PostgreSQL Flexible Server. Diese Funktion vereinfacht das Setup, indem Sie durch die erforderlichen Schritte geführt werden und die Verbindungsdetails automatisch konfiguriert werden. Mithilfe dieser Integration können Sie schnell eine Verbindung herstellen und Ihre Datenbank direkt in der Visual Studio Code-Umgebung verwalten.

  • Wählen Sie auf der Seite "Übersicht" die prominente Schaltfläche "Mit VS-Code verbinden " aus.
  • Ein Seitenbereich mit den Anforderungen für die Verbindung mit VS Code wird angezeigt.

Screenshot des Azure-Portals mit einer Azure-Datenbank für PostgreSQL-Instanz mit der Schaltfläche

Bestätigen der Anforderungen

  • Vergewissern Sie sich im Seitenbereich, dass alle Voraussetzungen (VS Code und PostgreSQL-Erweiterung) erfüllt sind, indem Sie die entsprechenden Kontrollkästchen aktivieren.

  • Laden Sie bei Bedarf Visual Studio Code und die Erweiterung mithilfe der Links im Seitenbereich herunter.

  • Geben Sie optional Verbindungsparameter wie standarddatenbankname, Authentifizierungsmethode und Verbindungspooling ein.

    Screenshot des Azure-Portals mit einer Azure-Datenbank für PostgreSQL-Instanz mit dem Bereich

In Visual Studio Code öffnen

  • Wählen Sie im Seitenbereich die Schaltfläche " In Visual Studio Code öffnen " aus.
  • Eine Schaltfläche mit der Aufschrift "Öffnen in Visual Studio Code wiederholen" erscheint im Seitenbereich, falls Visual Studio Code und die Erweiterung mehr als 40 Sekunden benötigen, um zu öffnen.

Starten Sie Visual Studio Code.

  • Wenn VS Code installiert und ausgeführt wird, wird das Verbindungsdialogfeld der PostgreSQL-Erweiterung automatisch gestartet.
  • Wenn VS Code installiert, aber nicht geöffnet ist, wird er innerhalb von ca. 40 Sekunden gestartet, gefolgt vom Dialogfeld "Verbindung".

AutoAusfüllen der Verbindungsdetails

Das Verbindungsdialogfeld in der PostgreSQL-Erweiterung wird geöffnet, und das Feld "Servername" füllt ihren Serverendpunkt automatisch auf.

Screenshot der PostgreSQL-Erweiterung für das VS Code-Verbindungsdialogfeld mit vorausgefüllten Servernamendetails.

Authentifizierungsdetails bereitstellen

Wählen Sie Ihre bevorzugte Authentifizierungsmethode aus:

  • Kennwortauthentifizierung: Geben Sie Ihren Benutzernamen und Ihr Kennwort manuell ein.
  • Entra-Authentifizierung: Geben Sie Ihre Azure-Kontoanmeldeinformationen ein.

Geben Sie weitere Verbindungsdetails wie Profilname, Datenbankname (optional), Servergruppe und Portnummer an.

Speichern und Verbinden

Wählen Sie die Schaltfläche " Speichern und Verbinden " aus, um die Verbindung herzustellen. Erweitern Sie nach der Verbindung den Server in der Objekt-Explorer-Struktur, um Datenbanken, Schemas und Tabellen anzuzeigen, oder verwenden Sie das integrierte Abfragetool, um Ihre Datenbankobjekte zu verwalten.

Fehlersuche

Wenn während des Verbindungsvorgangs Probleme auftreten:

  • Stellen Sie sicher, dass VS Code und die PostgreSQL-Erweiterung installiert und aktiviert sind.

  • Stellen Sie sicher, dass die IP-Adresse in den Firewalleinstellungen Ihrer Azure-Datenbank für PostgreSQL zulässig ist.

  • Wenn die Voraussetzungen nicht erfüllt sind, bietet der Seitenbereich Feedback und Schritte zur Behebung des Problems, einschließlich der Option, die Verbindung erneut zu versuchen.

Feedback und Support

Verwenden Sie für Fehler, Featureanforderungen und Probleme das integrierte Feedbacktool in Visual Studio Code. Sie können dies über das Vs 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