Objekt-Explorer

Der Objekt-Explorer in der PostgreSQL-Erweiterung für Visual Studio Code bietet eine Strukturansicht Ihrer PostgreSQL-Server, Datenbanken, Schemas und einzelner Datenbankobjekte. Sie können Tabellen, Ansichten, Funktionen und andere Objekte durchsuchen, schemaübergreifend suchen und SQL-Skripts generieren, ohne den Editor verlassen zu müssen.

Tip

Verwenden Sie den Objekt-Explorer für die Objektnavigation, Suche und Skriptgenerierung. Wenn Sie ein visuelles Diagramm mit Tabellenbeziehungen benötigen, öffnen Sie die Schemaschnellansicht.

Objekt-Explorer öffnen

Wählen Sie das PostgreSQL-Symbol in der Aktivitätsleiste aus, um die PostgreSQL-Ansicht zu öffnen. Sie können auch STRG+ALT+D (Windows/Linux) oder CMD+ALT+D (macOS) drücken.

Die Ansicht enthält den Abschnitt Verbindungen, der Ihre Server in einer einklappbaren Baumstruktur anzeigt. Verbundene Server zeigen ein grünes Symbol an; Getrennte Server zeigen ein rotes Symbol an. Wenn keine Verbindungen vorhanden sind, wird ein Knoten "Verbindung hinzufügen " angezeigt, der Ihnen bei den ersten Schritten hilft.

Baumhierarchie

Der Objekt-Explorer organisiert Datenbankobjekte in einer konsistenten Hierarchie:

Server → Database → Schema →-Objektauflistungen

Standardmäßig werden Objekte nach Schema gruppiert. Unter jedem Schema finden Sie Sammlungsordner wie:

  • Tabellen: Erweitern einer Tabelle, um die zugehörigen Spalten, Schlüssel, Indizes, Einschränkungen und Trigger anzuzeigen
  • Ansichten
  • Gespeicherte Prozeduren
  • Funktionen: umfasst skalare, tabellenwertige und Aggregatfunktionen in separaten Ordnern
  • Sequenzen
  • Typen: benutzerdefinierte Typen und benutzerdefinierte Tabellentypen

Der genaue Satz von Sammlungsordnern hängt von den Objekten ab, die in der Datenbank vorhanden sind und vom Back-End-Tools-Dienst aufgefüllt werden.

Erweitern Sie einen beliebigen Sammlungsordner, um einzelne Objekte anzuzeigen. Bei Tabellen können Sie tiefer in Spalten, Schlüssel (Primär-, Fremd- und eindeutige Schlüssel), Indizes, Constraints und Trigger einsteigen.

Note

Die pgsql.objectExplorer.expandTimeout Einstellung steuert, wie lange die Erweiterung beim Erweitern eines Knotens wartet. Der Standardwert ist 45 Sekunden. Erhöhen Sie diesen Wert, wenn Sie mit großen Schemas arbeiten, die länger zum Laden dauern.

Gruppieren nach Schema

Wenn die pgsql.objectExplorer.groupBySchema Einstellung aktiviert ist (Standardeinstellung), werden Datenbankobjekte unter ihrem Schemaknoten angezeigt. Gehen Sie wie folgt vor, um dieses Verhalten umzuschalten:

  1. Öffnen Sie die Befehlspalette (STRG+UMSCHALT+P / CMD+UMSCHALT+P).
  2. Führen Sie "Gruppe nach Schema aktivieren " aus, oder deaktivieren Sie "Gruppe nach Schema".

Wenn Sie gruppenbasierte Schemas deaktivieren, werden Objektsammlungsordner direkt unter dem Datenbankknoten anstelle einzelner Schemas angezeigt.

Verbinden und Verwalten von Servern

Sie verwalten Serververbindungen direkt über die Connections-Struktur . Die Symbolleiste oben im Abschnitt "Verbindungen " und die Kontextmenüs mit der rechten Maustaste enthalten die folgenden Aktionen.

Symbolleistenaktionen

Schaltfläche Befehl Beschreibung
+ Neue Verbindung hinzufügen Öffnet das Verbindungsdialogfeld , um einen vorhandenen PostgreSQL-Server hinzuzufügen.
Server-Symbol Neuen Server erstellen Öffnet einen Erstellungshub, in dem Sie einen neuen Azure Database for PostgreSQL flexiblen Server bereitstellen oder einen Docker-basierten Server erstellen können.
Ordnersymbol Servergruppe erstellen Erstellt eine neue Servergruppe zum Organisieren Ihrer Verbindungen.
Filtersymbol Nur verbundene Server / anzeigenVerbundene und getrennte Server anzeigen Blendet die Sichtbarkeit nicht verbundener Server im Baum ein oder aus.
Symbol "Suchen" Suchobjekte Öffnet den Suchbereich.

Serverkontextmenü

Klicken Sie mit der rechten Maustaste auf einen Serverknoten, um auf diese Befehle zuzugreifen:

  • Objekte suchen: Öffnet den Suchbereich, der auf diesen Server beschränkt ist.
  • Verbindung bearbeiten: öffnet das Verbindungsdialogfeld mit den gespeicherten Einstellungen für diesen Server erneut.
  • Verbindung trennen: schließt die aktive Verbindung. Der Server bleibt im Verzeichnisbaum mit einem roten Symbol, damit Sie später die Verbindung erneut herstellen können.
  • Remove: löscht den Servereintrag vollständig aus der Connections-Struktur .
  • Aktualisieren: lädt die untergeordneten Knoten des Servers neu. Verwenden Sie dies nach Schemaänderungen, die außerhalb von VS Code vorgenommen wurden.

Note

Trennen wird nur bei verbundenen Servern angezeigt. "Entfernen" ist sowohl auf verbundenen als auch auf getrennten Servern verfügbar.

Datenbankkontextmenü

Klicken Sie mit der rechten Maustaste auf einen Datenbankknoten, um auf folgendes zuzugreifen:

  • Neue Abfrage: Öffnet einen Abfrage-Editor, der bereits mit dieser Datenbank verbunden ist.
  • Verbindung mit PSQL: öffnet eine integrierte Terminalsitzung, die mit dieser Datenbank verbunden ist psql. Weitere Informationen finden Sie unter psql im Terminal verwenden.
  • Schemas visualisieren: öffnet die Schema-Visualisierung für diese Datenbank.
  • Suchobjekte: Öffnet den Suchbereich für diese Datenbank.

Klicken Sie mit der rechten Maustaste auf einen Schemaknoten, um Schema visualisieren (bezogen auf dieses Schema) und Objekte suchen auszuwählen.

Servergruppen

Mit Servergruppen können Sie Verbindungen in benannte Ordner organisieren. Dies ist nützlich, wenn Sie mit vielen Servern in verschiedenen Umgebungen oder Teams arbeiten.

  1. Wählen Sie das Ordnersymbol (Servergruppe erstellen) in der Verbindungssymbolleiste aus, oder öffnen Sie die Befehlspalette , und führen Sie PGSQL: Servergruppe erstellen aus.
  2. Geben Sie einen Namen, eine optionale Beschreibung und eine Farbe für die Gruppe ein.
  3. Wählen Sie OK aus.

Die Gruppe wird als Ordner in der Connections-Struktur angezeigt. Sie können Serverknoten in die Gruppe ziehen, um sie neu zu organisieren. Wenn Sie eine Gruppe ändern möchten, klicken Sie mit der rechten Maustaste darauf, und wählen Sie " Servergruppe bearbeiten" aus. Um eine Gruppe zu löschen, klicken Sie mit der rechten Maustaste, und wählen Sie "Entfernen" aus.

Klicken Sie mit der rechten Maustaste auf eine Servergruppe, um verbindungen direkt zu dieser Gruppe mit " Neue Verbindung hinzufügen " oder " Neuen Server erstellen" hinzuzufügen.

Suchen von Objekten

Wenn Sie ein bestimmtes Objekt in einer großen Datenbank suchen müssen, verwenden Sie die integrierte Suche, anstatt manuell Strukturknoten zu erweitern.

Öffnen Sie den Suchbereich, indem Sie das Suchsymbol in der Symbolleiste "Verbindungen" auswählen. Sie können auch mit der rechten Maustaste auf einen Server, eine Datenbank oder einen Schemaknoten klicken und Suchobjekte auswählen, um den Bereich vorab aufzufüllen.

Der Suchbereich bietet die folgenden Steuerelemente:

Steuerung Beschreibung
Verbindung auswählen Wählen Sie aus, nach welcher Serververbindung gesucht werden soll. Die Dropdown-Liste zeigt den Verbindungsstatus (Verbunden / Getrennt) und Details wie Host, Port und Benutzer an.
Datenbank auswählen Wählen Sie aus, in welcher Datenbank gesucht werden soll.
Alle Schemas Schränken Sie Ergebnisse auf ein bestimmtes Schema ein, oder lassen Sie sie auf "Alle Schemas " festgelegt, um überall zu suchen.
Alle Typen Filtern nach Objekttyp. Wählen Sie eine beliebige Kombination von Typen wie "Tabelle", "Ansicht", "Funktion", "Gespeicherte Prozedur" und "Sequenz" aus.
Objekte durchsuchen... Geben Sie eine Teilzeichenfolge ein, die mit Objektnamen abgeglichen werden soll. Die Groß- und Kleinschreibung wird bei der Suche nicht berücksichtigt.

Wählen Sie "Suchen" aus, um die Abfrage auszuführen. Ergebnisse werden in einem Raster mit Den Spalten "Objektname", " Typ" und " Objektpfad " angezeigt. Wählen Sie eine Ergebniszeile aus, um direkt zu diesem Objekt im Baum zu wechseln. Die Verbindungsstruktur erweitert automatisch die erforderlichen Knoten.

Skriptdatenbankobjekte

Sie können SQL-Skripts für Datenbankobjekte direkt aus der Connections-Struktur generieren. Klicken Sie mit der rechten Maustaste auf ein skriptfähiges Objekt, um auf die Skriptbefehle zuzugreifen.

Befehl Verfügbar für Generiertes SQL
Top 1000 auswählen Tabelle, Ansicht SELECT Abfrage, die die ersten 1.000 Zeilen zurückgibt.
Skript als Erstellen Tabelle, Ansicht, Schema, gespeicherte Prozedur, Funktionen, Trigger, Indizes, Schlüssel, Rollen, Typen Vollständige CREATE DDL-Anweisung.
Skript als Drop Identisch mit Skript wie "Erstellen" DROP -Anweisung für das Objekt.
Skript als Alter Anzeigen, Funktionen, gespeicherte Prozedur ALTER Anweisung für das Objekt.
Skript als Ausführen Gespeicherte Prozedur CALL oder SELECT Anweisung zum Ausführen der Routine.

Jedes generierte Skript wird in einer neuen Abfrage-Editor-Registerkarte geöffnet, die mit derselben Datenbank wie das Quellobjekt verbunden ist. Sie können das Skript sofort überprüfen, bearbeiten und ausführen.

Tip

Wählen Sie "Top 1000" aus, um tabellendaten am schnellsten in der Vorschau anzuzeigen. Klicken Sie mit der rechten Maustaste auf die Tabelle, und wählen Sie "Top 1000" aus, um die Abfrage in einem Schritt zu öffnen und auszuführen.

Kopieren des Namens

Klicken Sie mit der rechten Maustaste auf ein beliebiges Objekt ohne Ordner in der Connections-Struktur , und wählen Sie "Namen kopieren " aus, um den qualifizierten Namen in die Zwischenablage zu kopieren. Sie können auch den Knoten auswählen und STRG+C (Windows/Linux) oder Cmd+C (macOS) drücken.

Der kopierte Name verwendet das Format der [database].schema.[object] Klammernnotation, das in Ihre SQL-Abfragen eingefügt werden kann.

Neue Abfrage im Objekt-Explorer

Klicken Sie mit der rechten Maustaste auf einen Datenbankknoten, und wählen Sie "Neue Abfrage " aus, um einen Abfrage-Editor zu öffnen, der bereits mit dieser Datenbank verbunden ist. Der Editor erbt die Serververbindung und zielt auf die ausgewählte Datenbank ab, sodass Sie sofort mit dem Schreiben von Abfragen beginnen können.

Baumknoten filtern

Einige Sammlungsordner unterstützen das Filtern, um die angezeigten Objekte einzuschränken. Wenn ein Knoten gefiltert werden kann, klicken Sie mit der rechten Maustaste darauf, und wählen Sie "Filter" aus, um den Filterbereich zu öffnen. Sie können Bedingungen wie "Contains", "Starts With" oder " Equals " für Objekteigenschaften festlegen und dann "OK " auswählen, um es anzuwenden.

Gefilterte Knoten werden nach ihrer Beschriftung angezeigt (filtered) . Um einen Filter zu entfernen, klicken Sie mit der rechten Maustaste auf den Knoten, und wählen Sie im Filterbereich " Löschen " aus.

Drag-and-Drop

Sie können Serverknoten zwischen Servergruppen ziehen, um Ihre Verbindungen neu zu organisieren. Sie können Datenbankobjekte (Tabellen, Ansichten, Funktionen, gespeicherte Prozeduren) auch aus der Connections-Struktur in einen Abfrage-Editor ziehen, um ihren schemaqualifizierten Namen als Text einzufügen.

Verwandte Inhalte

  • Last updated on