Utilizar Agentes de Base de Dados no Visual Studio Code

O Database Agents integra-se com o Visual Studio Code para que possa configurar agentes, analisar investigações de desempenho assistidas por IA, inspecionar o estado do servidor em tempo real e realizar ações manuais de resposta sem sair do editor.

Importante

Database Agents for Base de Dados do Azure para PostgreSQL servidor flexível está atualmente disponível como pré-visualização limitada no Visual Studio Code. O acesso é limitado e requer aprovação. Para solicitar acesso, preencha o formulário de participação pré-visualizada limitada dos Agentes de Base de Dados.

Valide os diagnósticos gerados por IA, as instruções SQL e as alterações de parâmetros com base no servidor em produção antes de tomar qualquer medida e siga o fluxo de trabalho de aprovação e gestão de alterações da sua organização.

Note

  • Base de Dados do Azure para PostgreSQL flexible server: Já disponível em pré-visualização limitada no Visual Studio Code. O suporte para Agentes de Base de Dados PostgreSQL no Fabric Database Hub chegará em breve.
  • Base de Dados SQL do Azure: Suporte no Visual Studio Code chegará em breve. Hoje, utilize o Database Hub para Base de Dados SQL do Azure.

Prerequisites

Importante

Database Agents for Base de Dados do Azure para PostgreSQL está em pré-visualização limitada. Antes de poder ativar esta funcionalidade, deve solicitar acesso através do formulário de participação e obter aprovação.

  • Utilize um servidor flexível Base de Dados do Azure para PostgreSQL em execução no PostgreSQL 16 ou posterior numa região de pré-visualização limitada suportada (South Central US, West US 3 ou Sweden Central).
  • Instale Visual Studio Code (recomenda-se a versão 1.102.0 ou posterior para as ferramentas do agente Model Context Protocol (MCP)).
  • Instale a extensão PostgreSQL para Visual Studio Code (versão 1.32.0 ou posterior).
  • Inicie sessão com uma identidade Microsoft Entra que tenha acesso ao recurso do servidor Azure (incluindo permissão de escrita RBAC Azure no recurso do servidor ao configurar o Agente de Base de Dados), além de credenciais PostgreSQL e acesso à rede para ligar e executar consultas.
  • (Opcional) Instale o GitHub Copilot no Visual Studio Code para usar Perguntar ao Copilot sobre esta secção e as ferramentas do modo Agente.

Abrir o Database Agent para o seu servidor

Ligue o seu servidor flexível do Base de Dados do Azure para PostgreSQL à extensão PostgreSQL para abrir o Agente de Base de Dados ou visualizar os resultados no painel do servidor.

  1. No Visual Studio Code, selecione o ícone PostgreSQL na Barra de Atividades para abrir Ligações.

  2. Em Servidores, adicione ou ligue-se ao seu servidor flexível Base de Dados do Azure para PostgreSQL e inicie sessão com a sua conta Azure se solicitado.

  3. Clique com o botão direito do rato no nó do servidor ligado:

    • Selecione Agente de Base de Dados para configurar e gerir o Agente de Base de Dados para o servidor.
    • Selecione Dashboard para abrir o dashboard do servidor e rever investigações e problemas ativos.

    Captura de ecrã da árvore de Ligações PostgreSQL no Visual Studio Code a mostrar o menu contextual do servidor com o Dashboard e o Agente de Base de Dados.

  4. Se a barra de ferramentas do dashboard mostrar Azure Server Detected, selecione Recolher Metadados para que a extensão resolva a identidade do recurso Azure do servidor. Se aparecer Metadata Azure Incompleto, selecione Fetch Metadata no banner para concluir a resolução do inquilino.

Reveja um problema

Pode rever e gerir problemas do Agente de Base de Dados PostgreSQL diretamente no separador Dashboard do servidor no Visual Studio Code.

  1. Abra o Dashboard do seu servidor. Quando o Agente de Base de Dados está a investigar ou detetou problemas no servidor, aparece um banner de Investigação no topo do painel com a contagem de problemas — selecione Ver primeiro de N problemas para saltar diretamente para os resultados.

  2. Expanda um problema para inspecionar a sua gravidade, estado (como DETETADO ou DIAGNOSTICADO), carimbo temporal de deteção e análise gerada por IA:

    • A AÇÃO RECOMENDADA inclui a alteração recomendada (com SQL gerado e Abrir no editor e controlos Copy ), Porque isto é seguro, Rollback SQL (também com Abrir no editor e Copy) e Ver detalhes completos.
    • RESULTADO ESPERADO resume a melhoria prevista da carga de trabalho e fornece um plano de reversão colapsável.
    • Os botões de ação na parte inferior do problema permitem-lhe escolher Rever ação, Marcar aplicado manualmente ou Descartar problema.

    Captura de ecrã de um problema do Agente de Base de Dados PostgreSQL no dashboard do servidor Visual Studio Code mostrando o banner Investigação, Ação recomendada, Porque isto é seguro, Reverter SQL, Resultado esperado e botões de ação.

  3. Para explorar uma secção de problemas com IA, selecione o ícone de brilho (Perguntar ao Copilot sobre esta secção) ao lado de um título como AÇÃO RECOMENDADA ou RESULTADO ESPERADO. O GitHub Copilot Chat abre com os detalhes estruturados do problema pré-carregados para que possas fazer perguntas de seguimento e inspecionar métricas do servidor, sessões ou planos de execução em tempo real.

    Captura de ecrã de selecionar Perguntar ao Copilot sobre esta secção ao lado de Ação recomendada num problema do Agente de Base de Dados PostgreSQL, abrindo o GitHub Copilot Chat com os detalhes do problema pré-carregados.

Responder a um problema

As evidências recolhidas refletem o estado do servidor quando o problema foi diagnosticado, e os resultados gerados por IA podem ser incompletos ou incorretos. Valide todas as recomendações em relação ao servidor ativo antes de efetuar alterações.

  1. Utilize o Painel do servidor (separadores Consultas, Esperas e Sessões ) ou abra um editor de consultas para confirmar se a condição detetada ainda está ativa no servidor ao vivo (por exemplo, em pg_stat_activity consulta e pg_locks antes de chamar pg_terminate_backend()).

  2. Para alterações SQL (como criar um índice ou executar ANALYZE), selecione Abrir no editor ou Copiar no bloco Alterar SQL recomendado em ACÇÃO RECOMENDADA:

    • Inspecionar a saída de EXPLAIN no Visualizador de Planos de Consulta ao validar alterações de consulta ou índice.
    • Revise o bloqueio e o impacto dos recursos (por exemplo, manter CREATE INDEX CONCURRENTLY para evitar bloquear escritas em tabelas ativas) e mantenha o SQL de Rollback pronto.
    • Execute manualmente a instrução aprovada através do seu fluxo de trabalho autorizado na base de dados.
  3. Para recomendações de parâmetros do servidor (como ajustes de work_mem ou definições do autovacuum), clique com o botão direito do rato no servidor em Ligações>Servidores e selecione Gestão do Servidor>Parâmetros do Servidor. Se uma alteração de parâmetro estático exigir um reinício, utilize Gestão do Servidor>Reiniciar servidor durante uma janela de manutenção aprovada.

    Captura de ecrã do menu contextual do servidor PostgreSQL no Visual Studio Code a destacar a Gestão do Servidor e os Parâmetros do Servidor.

  4. Verifique novamente as métricas do servidor em tempo real e os planos de consulta para confirmar que a carga de trabalho foi recuperada.

  5. Volte ao problema no painel de controlo e selecione Marcar aplicado manualmente para registar que concluiu a remediação, ou selecione Descartar problema se não for necessária alteração. Ainda pode rever os detalhes da dispensa nas questões dispensadas.

Disponibilidade da Surface pelo motor de base de dados

Durante a pré-visualização, o suporte para Agentes de Base de Dados em Visual Studio Code e Fabric Database Hub varia consoante o motor:

Engine Código do Visual Studio Fabric Database Hub
Servidor flexível Base de Dados do Azure para PostgreSQL Disponível agora (pré-visualização limitada) através da extensão PostgreSQL (Agente de Base de Dados e Dashboard) Em breve para Agentes de Base de Dados (a monitorização do inventário base e das métricas está disponível em Monitorizar um servidor flexível do Base de Dados do Azure para PostgreSQL)
Base de Dados SQL do Azure Brevemente Disponível agora (pré-visualização) no Database Hub