Używaj agentów bazy danych w Visual Studio Code

Agenci bazy danych integrują się z Visual Studio Code, dzięki czemu możesz konfigurować agentów, przeglądać badania wydajności wspomagane przez AI, sprawdzać stan serwera na żywo oraz wykonywać ręczne odpowiedzi bez opuszczania edytora.

Important

Database Agents for Azure Database for PostgreSQL elastyczny serwer jest obecnie dostępny jako ograniczony podgląd w Visual Studio Code. Dostęp jest ograniczony i wymaga zatwierdzenia. Aby poprosić o dostęp, wypełnij formularz uczestnictwa w ograniczonym podglądzie agentów bazy danych.

Weryfikuj diagnozy generowane przez AI, instrukcje SQL i zmiany parametrów na serwerze działającym przed podjęciem działań oraz śledź proces zatwierdzania i zarządzania zmianami w swojej organizacji.

Note

  • elastyczny serwer Azure Database for PostgreSQL: Dostępny już jako ograniczony podgląd w Visual Studio Code. Wkrótce pojawi się wsparcie dla agentów bazy danych PostgreSQL w Fabric Database Hub.
  • Azure SQL Database: Wkrótce pojawi się wsparcie w Visual Studio Code. Dziś korzystaj z Database Hub dla Azure SQL Database.

Prerequisites

Important

Database Agents for Azure Database for PostgreSQL jest w ograniczonym podglądzie. Zanim będzie można włączyć tę funkcję, musisz zażądać dostępu za pośrednictwem formularza uczestnictwa i otrzymać zatwierdzenie.

  • Użyj działającego elastycznego serwera Azure Database for PostgreSQL na PostgreSQL 16 lub nowszym w obsługiwanym ograniczonym regionie podglądu (South Central US,West US 3 lub Sweden Central).
  • Zainstaluj Visual Studio Code (zalecana wersja 1.102.0 lub nowsza dla narzędzi agenta Model Context Protocol (MCP)).
  • Zainstaluj rozszerzenie PostgreSQL dla Visual Studio Code (wersja 1.32.0 lub nowsza).
  • Zaloguj się za pomocą tożsamości Microsoft Entra, która ma dostęp do zasobu serwera Azure (w tym uprawnienie Azure RBAC do zapisu na zasobach serwera podczas konfigurowania agenta bazy danych), a także poświadczenia PostgreSQL i dostęp do sieci do łączenia się i wykonywania zapytań.
  • (Opcjonalnie) Zainstaluj GitHub Copilot w Visual Studio Code, aby korzystać z Zapytaj funkcję Copilot o tę sekcję oraz narzędzi trybu agenta.

Otwórz Agent bazy danych dla swojego serwera

Podłącz swój elastyczny serwer Azure Database for PostgreSQL w rozszerzeniu PostgreSQL, aby otworzyć Agenta bazy danych lub wyświetlić ustalenia na pulpicie serwera.

  1. W Visual Studio Code wybierz ikonę PostgreSQL na pasku aktywności, aby otworzyć Połączenia.

  2. W sekcji Serwery dodaj lub połącz się z elastycznym serwerem Azure Database for PostgreSQL i zaloguj się przy użyciu konta Azure, jeśli pojawi się monit.

  3. Kliknij prawym przyciskiem myszy połączony węzeł serwera:

    • Wybierz Agent bazy danych , aby skonfigurować i zarządzać Agentem bazy danych dla serwera.
    • Wybierz Dashboard, aby otworzyć panel serwera i przejrzeć aktywne dochodzenia oraz problemy.

    Zrzut ekranu drzewa Połączeń PostgreSQL w Visual Studio Code pokazujący menu kontekstowe serwera z Dashboardem i Agentem Bazy Danych.

  4. Jeśli pasek narzędzi pulpitu wyświetla Wykryto serwer Azure, wybierz Pobierz metadane, aby rozszerzenie rozpoznało tożsamość zasobu Azure serwera. Jeśli pojawi się Niekompletne metadane Azure, wybierz Pobierz metadane w banerze, aby dokończyć rozpoznawanie dzierżawy.

Przejrzyj problem

Możesz przeglądać i zarządzać problemami z agentem bazy danych PostgreSQL bezpośrednio na karcie Dashboard serwera w Visual Studio Code.

  1. Otwórz Panel dla swojego serwera. Gdy Agent bazy danych prowadzi dochodzenie lub wykrył problemy na serwerze, na górze panelu pojawia się baner Dochodzenie z liczbą problemów — wybierz Pokaż pierwszy z N problemów , aby przejść bezpośrednio do wyników.

  2. Rozwiń problem, aby sprawdzić jego poziom ważności, status (np. WYKRYTO lub ZDIAGNOZOWANO), znacznik czasu wykrycia oraz analizę generowaną przez AI:

    • ZALECANE DZIAŁANIE obejmuje zalecaną zmianę (z wygenerowanym kodem SQL oraz opcjami Otwórz w edytorze i Kopiuj), Dlaczego jest to bezpieczne, kod SQL Wycofanie (również z opcjami Otwórz w edytorze i Kopiuj) oraz Zobacz pełne szczegóły.
    • OCZEKIWANY WYNIK podsumowuje przewidywaną poprawę obciążenia i udostępnia składany plan Rollback.
    • Przyciski akcji na dole problemu pozwalają wybrać Przejrzyj akcję, Oznacz jako zastosowane ręcznie lub Odrzuć problem.

    Zrzut ekranu problemu z agentem bazy danych PostgreSQL na panelu serwera Visual Studio Code, pokazujący baner Analiza, Zalecane działanie, Dlaczego to jest bezpieczne, Rollback SQL, Oczekiwany wynik oraz przyciski akcji problemu.

  3. Aby zbadać sekcję problemu z AI, wybierz ikonę iskry (Zapytaj funkcję Copilot about this section) obok nagłówka takiego jak ZALECANE DZIAŁANIE lub OCZEKIWANY WYNIK. Czat GitHub Copilot otwiera się z wstępnie załadowanymi szczegółami ustrukturyzowanego problemu, dzięki czemu możesz zadawać pytania uzupełniające i przeglądać na żywo metryki serwera, sesje lub plany realizacji.

    Zrzut ekranu z wyboru opcji Zapytaj funkcję Copilot o tę sekcję obok Zalecanej akcji w przypadku problemu z agentem bazy danych PostgreSQL, otwierając GitHub Copilot Chat z wstępnie załadowanymi szczegółami problemu.

Odpowiedz na problem

Zebrane dowody odzwierciedlają stan serwera w momencie diagnozy problemu, a wyniki generowane przez AI mogą być niekompletne lub nieprawidłowe. Zweryfikuj każdą rekomendację względem serwera na żywo przed wprowadzeniem zmian.

  1. Użyj panelu nawigacyjnego serwera (karty Zapytania, Oczekiwania i Sesje ) lub otwórz edytor zapytań, aby potwierdzić, czy wykryty warunek jest nadal aktywny na serwerze na żywo (na przykład zapytania pg_stat_activity i pg_locks przed wywołaniem pg_terminate_backend()).

  2. Dla zmian SQL (takich jak tworzenie indeksu lub uruchamianieANALYZE), wybierz Otwórz w edytorze lub Kopiuj w bloku SQL Zalecana zmiana w ZALECANEJ AKCJI:

    • Przeglądaj EXPLAIN wyniki w Query Plan Visualizer podczas weryfikacji zmian zapytań lub indeksów.
    • Przejrzyj wpływ blokad i zasobów (na przykład unikanie CREATE INDEX CONCURRENTLY blokowania zapisów na aktywnych tabelach) i miej gotowy Rollback SQL.
    • Uruchom zatwierdzone polecenie ręcznie zgodnie z autoryzowaną procedurą bazy danych.
  3. Aby uzyskać rekomendacje dotyczące parametrów serwera (takich jak dostrajanie work_mem lub ustawienia autovacuum), kliknij prawym przyciskiem myszy serwer w obszarze Połączenia>Serwery i wybierz Zarządzanie serwerem>. Jeśli zmiana parametru statycznego wymaga ponownego uruchomienia, użyj Server Management> podczas zatwierdzonego okna konserwacji.

    Zrzut ekranu menu kontekstowego serwera PostgreSQL w Visual Studio Code z podświetleniem Zarządzania serwerem i parametrów serwera.

  4. Ponownie sprawdź metryki serwera na żywo i plany zapytań, aby potwierdzić, że obciążenie wróciło do normy.

  5. Wróć do problemu na pulpicie i wybierz Oznacz jako zastosowane ręcznie, aby zarejestrować, że zakończyłeś naprawę, lub wybierz Odrzuć problem, jeśli nie jest potrzebna zmiana. Wciąż możesz przeglądać szczegóły oddalenia w oddalonych problemach.

Dostępność Surface według silnika bazy danych

Podczas podglądu wsparcie Agentów Bazy Danych w Visual Studio Code i Fabric Database Hub różni się w zależności od silnika:

Silnik Visual Studio Code Fabric Database Hub
Azure Database for PostgreSQL – elastyczny serwer Dostępne teraz (ograniczony podgląd) za pośrednictwem rozszerzenia PostgreSQL (Database Agent i Dashboard) Wkrótce dostępne dla agentów baz danych (monitorowanie środowiska bazowego i metryk jest dostępne w Monitor an Azure Database for PostgreSQL flexible server)
Azure SQL Database Wkrótce Dostępne teraz (wersja podglądowa) w Database Hub