Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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.
No Visual Studio Code, selecione o ícone PostgreSQL na Barra de Atividades para abrir Ligações.
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.
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.
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.
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.
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.
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.
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.
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_activityconsulta epg_locksantes de chamarpg_terminate_backend()).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
EXPLAINno 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 CONCURRENTLYpara 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.
- Inspecionar a saída de
Para recomendações de parâmetros do servidor (como ajustes de
work_memou 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.Verifique novamente as métricas do servidor em tempo real e os planos de consulta para confirmar que a carga de trabalho foi recuperada.
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 |