Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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
- Otwórz program Visual Studio Code.
- Otwórz widok Rozszerzenia (
Ctrl+Shift+XlubCmd+Shift+Xw systemie macOS). - Wyszukaj postgresql.
- 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, lubDROPEXECUTEotwierane 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,INSERTiSELECT. - 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.