Rozszerzenie PostgreSQL dla programu Visual Studio Code

Rozszerzenie PostgreSQL dla Visual Studio Code (ms-ossdata.vscode-pgsql) udostępnia narzędzia programistyczne bazy danych bezpośrednio do edytora. Możesz nawiązywać połączenia z lokalnymi, lokalnymi lub chmurowymi serwerami PostgreSQL, zapisywać zapytania za pomocą funkcji IntelliSense, eksplorować obiekty bazy danych, wizualizować plany zapytań i schematy oraz zarządzać Azure Database for PostgreSQL elastycznymi zasobami serwera bez opuszczania programu VS Code. Rozszerzenie integruje się również z asystentami SI do tworzenia zapytań wspomaganego przez SI, analizy oraz przepływów pracy sterowanych przez agentów.

Note

Rozszerzenie działa również w kursorze. Funkcje AI PostgreSQL są obsługiwane w obu edytorach i są zgodne z natywną obsługą AI każdego z nich: Visual Studio Code udostępnia uczestnika czatu @pgsql obok trybu agenta i rejestracji serwera MCP, natomiast Cursor używa Connect AI (trybu agenta) lub rejestracji serwera MCP.

Wprowadzenie

Jeśli dopiero zaczynasz korzystać z rozszerzenia, zacznij od jednego z następujących przewodników:

Goal Przewodnik
Uruchamianie pierwszego zapytania Szybki start: nawiązywanie połączenia i wykonywanie zapytań dotyczących bazy danych PostgreSQL
Znajdź odpowiedni artykuł dotyczący zadania Typowe przepływy pracy
Konfigurowanie tożsamości, protokołu TLS lub zapisanych profilów Połączenia i tożsamość

Instalowanie rozszerzenia

  1. Otwórz program Visual Studio Code.
  2. Otwórz widok Rozszerzenia (Ctrl+Shift+Xlub Cmd+Shift+X w systemie macOS).
  3. Wyszukaj postgresql.
  4. Wybierz pozycję PostgreSQL według Microsoft, a następnie wybierz pozycję Zainstaluj.

Wskazówka

Po zakończeniu instalacji na pasku działań zostanie wyświetlona ikona PostgreSQL. Wybierz go, aby otworzyć widok PostgreSQL, w którym zarządzasz połączeniami i eksplorujesz obiekty bazy danych.

Kluczowe funkcje

W poniższych sekcjach przedstawiono podsumowanie poszczególnych głównych obszarów funkcji. Wybierz link na końcu każdej sekcji, aby uzyskać pełny artykuł.

Okno dialogowe Połączenia

Okno połączenia umożliwia połączenie z lokalnymi, lokalnie wdrożonymi i udostępnianymi w chmurze serwerami PostgreSQL, z wbudowaną obsługą uwierzytelniania dla Microsoft Entra ID i AWS IAM (RDS/Aurora). Wprowadź parametry połączenia ręcznie, wklej ciąg połączenia lub przeglądaj swoje subskrypcje platformy Azure, aby odkryć serwery elastyczne Azure Database for PostgreSQL i klastry Azure HorizonDB (wersja zapoznawcza).

  • Trzy tryby wejściowe: Parametry dla poszczególnych wartości, takich jak host, port, baza danych i nazwa użytkownika; Connection String dla pełnej parametry połączenia lub Przeglądaj Azure, aby nawigować po zasobach Azure i wybrać zasób z punktem końcowym PostgreSQL.
  • Zapisane i ostatnie połączenia: zapisane profile są wyświetlane na liście Połączenia w celu szybkiego ponownego użycia; ostatnio używane połączenia są zawsze dostępne.
  • Grupy serwerów: organizuj połączenia w nazwane grupy z kodowaniem kolorów, aby szybko identyfikować połączenia w drzewie Połączenia .

Aby uzyskać szczegółowe informacje, zobacz Połączenia i tożsamość oraz Zaawansowane opcje połączenia.

Eksplorator obiektów

Eksplorator obiektów udostępnia widok drzewa z możliwością nawigacji połączonych serwerów PostgreSQL. Rozwiń serwery, bazy danych i schematy, aby sprawdzać tabele, widoki, funkcje, sekwencje, typy, rozszerzenia, role, przestrzenie tabel i wyzwalacze zdarzeń.

  • Wyszukiwanie: znajdź obiekty według nazwy we wszystkich obsługiwanych typach obiektów za pomocą wbudowanego wyszukiwania.
  • Wykonywanie skryptów: kliknij prawym przyciskiem myszy dowolny obiekt, aby wygenerować SELECTskrypty , CREATE, ALTER, lub DROPEXECUTE otwierane w edytorze zapytań.
  • Głębokie odświeżenie: odświeżenie dowolnego węzła powoduje rekursywną aktualizację wszystkich rozwiniętych węzłów podrzędnych, tak aby odzwierciedlić zmiany w schemacie bez rozłączania połączenia.

Aby uzyskać szczegółowe informacje, zobacz Eksplorator obiektów.

Edytor zapytań i funkcja IntelliSense

Edytor zapytań udostępnia rozbudowaną powierzchnię edycji bazy danych PostgreSQL SQL. Funkcja IntelliSense oferuje uzupełniania kontekstowe dla nazw tabel, nazw kolumn, funkcji, schematów, słów kluczowych i klauzul sprzężenia.

  • Uruchom zapytanie i uruchom bieżącą instrukcję: uruchom pełną zawartość edytora lub tylko instrukcję na kursorze.
  • Fragmenty kodu: wstaw typowe wzorce SQL, takie jak CREATE TABLE, INSERTi SELECT.
  • Historia zapytań: dostęp do poprzednio uruchamianych zapytań z palety poleceń w celu ich ponownego uruchomienia lub zmodyfikowania.

Aby uzyskać szczegółowe informacje, zobacz Edytor zapytań i Funkcja IntelliSense.

Wyniki zapytania

Wyniki są wyświetlane w panelu Wyniki zapytania PostgreSQL poniżej edytora. Siatka wyników obsługuje sortowanie, filtrowanie i zmienianie rozmiaru kolumn.

  • Eksportuj: zapisz wyniki w plikach CSV, JSON lub Excel.
  • Wizualizacja wykresu: wizualizowanie wyników jako wykresów liniowych, słupków, kołowych lub punktowych.
  • Widok grafu: wyniki zapytania grafu apache AGE przełączają się automatycznie do widoku węzła i krawędzi.
  • Karta „Komunikaty”: sprawdź liczbę wierszy, czasy wykonania i komunikaty serwera.

Aby uzyskać szczegółowe informacje, zobacz Edytor zapytań i Funkcja IntelliSense.

Wizualizator planu zapytania

Wizualizator planu zapytania przedstawia EXPLAIN dane wyjściowe w wielu interaktywnych formatach, dzięki czemu można zidentyfikować wąskie gardła wydajności.

  • Cztery widoki: Widok drzewa, Widok Icicle, Widok tabeli i Widok źródłowy.
  • Metryki: sprawdź oszacowania kosztów, rzeczywiste liczby wierszy, czas wykonywania i użycie buforu na węzeł.
  • Plany importu: wizualizowanie zapisanych plików planu lub zawartości edytora bez połączenia z bazą danych na żywo.
  • Analiza Copilot: wybierz pozycję Analizuj za pomocą narzędzia Copilot (lub Analizuj za pomocą AI w Cursor), aby uzyskać wygenerowane przez AI wyjaśnienie planu.

Aby uzyskać szczegółowe informacje, zobacz Wizualizator planu zapytań.

Wizualizator schematu

Wizualizator schematu generuje interakcyjny diagram relacji jednostek. Tabele są przedstawiane jako przeciągalne węzły z wymienionymi w nich kolumnami, a relacje kluczy obcych są wyświetlane jako linie łączące.

  • Schematy kodowane kolorami: każdy schemat otrzymuje odrębny kolor na potrzeby szybkiej identyfikacji.
  • Przełącznik legendy: pokaż lub ukryj legendę schematu, aby zmaksymalizować przestrzeń diagramu.

Aby uzyskać szczegółowe informacje, zobacz Wizualizator schematu.

Pulpit nawigacyjny serwera

Na pulpicie nawigacyjnym serwera są wyświetlane właściwości połączenia, wersja serwera i stan protokołu SSL dla dowolnego połączonego serwera. W przypadku serwerów elastycznych usługi Azure Database for PostgreSQL wyświetlane są również metryki usługi Azure Monitor. Karty Badania umożliwiają przechodzenie do szczegółów określonych obszarów działania serwera.

  • Przegląd: monitorowanie procesora, pamięci, pamięci masowej, połączeń, IOPS i innych wskaźników pogrupowanych według kategorii.
  • Zapytania: wyświetl najważniejsze instrukcje SQL sklasyfikowane według czasu wykonywania, liczby wywołań lub innych metryk z przechodzeniem do szczegółów poszczególnych zapytań.
  • Oczekiwania: analizuj zdarzenia oczekiwania za pomocą tabeli rankingowej i wykresu zmian w czasie.
  • Sesje: sprawdzanie aktywnych sesji, blokowanie drzew i działanie blokady.
  • Akcje paska narzędzi: łączenie, rozłączanie, otwieranie nowego edytora zapytań, uruchamianie wizualizatora schematu, otwieranie czatu sztucznej inteligencji lub uruchamianie Azure akcji zarządzania z poziomu paska narzędzi pulpitu nawigacyjnego.

Aby uzyskać szczegółowe informacje, zobacz Pulpit nawigacyjny serwera.

zarządzanie serwerem Azure

Zarządzanie Azure Database for PostgreSQL elastycznymi zasobami serwera bez opuszczania programu VS Code.

  • Uruchamianie, zatrzymywanie i ponowne uruchamianie: kontrolowanie cyklu życia serwera z drzewa Połączeń lub pulpitu nawigacyjnego.
  • Reguły zapory: wyświetlanie i aktualizowanie reguł dostępu do sieci.
  • Parametry: przeglądanie i modyfikowanie parametrów.
  • Klonowanie serwera: duplikuj istniejącą konfigurację serwera.

Aby uzyskać szczegółowe informacje, zobacz zarządzanie serwerem Azure.

Tworzenie serwera

Aprowizuj nowe serwery PostgreSQL bezpośrednio z programu VS Code.

  • Docker: utwórz lokalny serwer PostgreSQL w kontenerze platformy Docker na potrzeby programowania i testowania.
  • Azure Database for PostgreSQL — elastyczny serwer: przejdź przez konfigurację krok po kroku, aby skonfigurować region, warstwę obliczeniową, magazyn danych i uwierzytelnianie.
  • Azure HorizonDB (wersja zapoznawcza): aprowizowanie natywnego dla chmury, wysoce skalowalnego klastra PostgreSQL z konfigurowalnymi rdzeniami wirtualnymi i opcjonalnymi funkcjami sztucznej inteligencji.

Aby uzyskać szczegółowe informacje, zobacz Tworzenie serwera PostgreSQL.

Integracja z kopilotem

Rozszerzenie integruje się z asystentami AI w obszarach takich jak czat, działania edytora i wieloetapowe przepływy pracy narzędzi.

  • @pgsql uczestnik na czacie: zadawaj w języku naturalnym pytania dotyczące swoich baz danych, generuj zapytania lub uzyskaj pomoc w zakresie zagadnień związanych z PostgreSQL w panelu GitHub Copilot Chat. Tylko Visual Studio Code. Aby uzyskać szczegółowe informacje, zobacz uczestnik czatu @pgsql.
  • Akcje edytora: kliknij prawym przyciskiem myszy pozycję SQL w edytorze, aby wyjaśnić zapytanie, przepisać je pod kątem optymalizacji lub przeanalizować plan wykonania z podmenu AI Query Actions . Dostępne zarówno w Visual Studio Code, jak i w Cursor.
  • Tryb agenta: agent sztucznej inteligencji bezpośrednio korzysta z narzędzi PostgreSQL, łącząc wnioskowanie sztucznej inteligencji z operacjami na działającej bazie danych. Dostępne zarówno w Visual Studio Code, jak i w Cursor. Aby uzyskać szczegółowe informacje, zobacz Tryb agenta.

Przegląd wszystkich funkcji AI można znaleźć w sekcji Integracja z Copilotem.

Serwer MCP

Rozszerzenie rejestruje serwer protokołu MCP (Model Context Protocol), który uwidacznia narzędzia PostgreSQL, w tym zarządzanie połączeniami, eksplorację schematu, wykonywanie zapytań i wizualizację planu zapytań do obsługiwanych hostów obsługujących sztuczną inteligencję. Zewnętrzne narzędzia sztucznej inteligencji mogą programowo korzystać z połączeń PostgreSQL za pośrednictwem tej rejestracji.

Aby uzyskać szczegółowe informacje, zobacz Serwer MCP.

Używanie narzędzia psql w terminalu

Otwórz psql sesję w terminalu połączoną z dowolną bazą danych w drzewie Połączenia lub uruchom pliki .sql bezpośrednio z menu kontekstowego edytora za pomocą psql. Zapewnia to pełny dostęp do natywnych funkcji psql, takich jak \ metapolecenia, COPY i interaktywne skryptowanie.

Aby uzyskać szczegółowe informacje, zobacz Używanie narzędzia psql w terminalu.

Migracja bazy danych Oracle do bazy danych PostgreSQL

Proces migracji wspomagany przez sztuczną inteligencję pomaga konwertować schematy i obiekty bazy danych Oracle do składni SQL zgodnej z PostgreSQL.

  • Migracja z przewodnikiem: połącz się ze źródłem Oracle, wybierz obiekty do migracji i przejrzyj przekonwertowane dane wyjściowe.
  • Konwersja wspomagana przez sztuczną inteligencję: model Microsoft Foundry tłumaczy składnię specyficzną dla oracle, typy danych i kod proceduralny na odpowiedniki postgreSQL.

Aby uzyskać szczegółowe informacje, zobacz Migracja z Oracle do PostgreSQL.

Obsługiwane systemy operacyjne

System operacyjny Architecture Notes
Windows x64, Arm64 Arm64 wymaga Windows 11.
macOS x64, Arm64 -
Linux x64, Arm64 Wymaga glibc wersji 2.35 lub nowszej.

Opinie i wsparcie

Aby zgłosić usterkę lub zażądać funkcji, zgłoś problem w repozytorium GitHub vscode-pgsql.