O que são os Agentes de Base de Dados?

Database Agents ajuda os proprietários de aplicações e os administradores de bases de dados a detetar, investigar e responder a problemas de desempenho suportados no Base de Dados SQL do Azure e no servidor flexível do Base de Dados do Azure para PostgreSQL.

Utilize Agentes de Base de Dados para:

  • Detetar condições de desempenho de base de dados suportadas.
  • Revise resumos de problemas, evidências e orientações.
  • Acompanhe a investigação, o fecho da ocorrência e a recorrência.

Onde utiliza os Agentes de Base de Dados depende do motor da base de dados durante a pré-visualização:

  • Base de Dados SQL do Azure: Disponível no Fabric Database Hub. O suporte para Visual Studio Code está a chegar em breve.
  • Servidor flexível do Base de Dados do Azure para PostgreSQL: Disponível como pré-visualização limitada no Visual Studio Code. O suporte no Fabric Database Hub chegará em breve.

Os Agentes de Base de Dados utilizam a sua identidade existente, permissões de recursos do Azure e permissões da base de dados. Não concede acesso adicional nem contorna os seus requisitos atuais de aprovação e gestão de alterações.

Importante

Database Agents está em pré-visualização. Investiga problemas suportados e fornece orientação. Não pode aplicar uma alteração à base de dados diretamente a partir de um incidente. Todos os cenários requerem uma resposta manual através do seu fluxo de trabalho autorizado de base de dados.

Note

Database Agents para Base de Dados do Azure para PostgreSQL flexible server está atualmente disponível como uma 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 na pré-visualização limitada do Database Agents.

Como o Database Agents funciona

Os Database Agents criam um fluxo de trabalho operacional guiado para bases de dados e servidores selecionados:

  1. Detetar uma condição de base de dados suportada.
  2. Investigue a condição e recolha provas.
  3. Guie ou recomende a próxima resposta com base no tipo de problema.
  4. Acompanhe a investigação e o estado do problema até ao encerramento ou reincidência.

Todos os problemas fornecem orientação para uma resposta manual. As permissões existentes da base de dados e os controlos operacionais continuam a aplicar-se.

Como o Database Agents utiliza a IA

O Database Agents deteta e investiga problemas do Base de Dados SQL do Azure sem um grande modelo de linguagem (LLM). Esta investigação central não consome capacidade do Copilot.

Para problemas de CPU elevados e de consultas de longa duração, pode opcionalmente utilizar assistência de IA contextual para explorar as evidências. A IA contextual utiliza um LLM e a capacidade do Copilot atribuída pelo seu administrador.

Cada investigação do Base de Dados do Azure para PostgreSQL é assistida por IA. Os Agentes de Base de Dados utilizam um grande modelo de linguagem (LLM) para diagnosticar a condição e recomendar uma resposta manual. O processamento de modelos de IA corre na Zona de Dados dos EUA para regiões dos EUA (Sul Central dos EUA e Oeste dos EUA 3) e na Zona de Dados da UE para a Suécia Central.

Durante a pré-visualização restrita, não paga pelas investigações do Database Agents para PostgreSQL. A faturação começa antes da disponibilidade geral, e a Microsoft notifica previamente os clientes inscritos antes de iniciar a faturação.

Introdução

Antes de ativar os Agentes de Base de Dados, confirme os seguintes pré-requisitos.

Prerequisites

  • Inicie sessão no Fabric com uma identidade que tenha acesso às bases de dados SQL do Azure que pretende monitorizar.
  • Utilize uma base de dados SQL do Azure suportada.
  • Se a base de dados for serverless, confirme que está ativa para que os Agentes de Base de Dados a possam avaliar.
  • Confirme que a base de dados está na região suportada associada à região principal do inquilino Fabric.
  • Complete a configuração aplicável do Base de Dados SQL do Azure em Ativar monitorização de desempenho para Microsoft SQL.
  • Confirme que tem permissão de leitura da base de dados para visualizar problemas.
  • Confirme que tem permissão de escrita para controlo de acesso baseado em funções Azure (Azure RBAC) no recurso Azure para cada base de dados selecionada ao guardar um agente.

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.

  • Instale o Visual Studio Code e a extensão PostgreSQL para Visual Studio Code (versão 1.32.0 ou posterior). O suporte para Agentes de Base de Dados PostgreSQL no Fabric Database Hub chegará em breve.
  • 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.
  • Inicie sessão no Visual Studio Code com uma identidade que tenha acesso ao recurso do servidor Azure (incluindo permissão de escrita RBAC Azure no recurso do servidor ao configurar um agente), além das credenciais PostgreSQL para se ligar ao servidor.

Para instruções completas de configuração, consulte Ativar e habilitar Agentes de Base de Dados ou Utilizar Agentes de Base de Dados no Visual Studio Code.

Abra os Agentes de Base de Dados

  1. Abra o Database Hub.
  2. Selecione Gerir agentes.
  3. Selecione Definições do agente de base de dados.

Nas definições do agente de base de dados, pode selecionar bases de dados SQL do Azure, rever as respetivas políticas de agente e guardar a configuração. O suporte para Base de Dados SQL do Azure no Visual Studio Code chegará em breve.

Durante a pré-visualização limitada, acede aos Agentes de Base de Dados para PostgreSQL a partir do Visual Studio Code (o suporte no Fabric Database Hub chegará em breve):

  1. Abra o Visual Studio Code e selecione o ícone PostgreSQL na Barra de Atividades para abrir Conexões.
  2. Em Servidores, clique com o botão direito do rato no seu servidor flexível Base de Dados do Azure para PostgreSQL conectado.
  3. Selecione Agente de Base de Dados para configurar o agente ou selecione Painel para rever investigações e problemas ativos.

Para o fluxo de trabalho completo do Visual Studio Code, consulte Utilizar Agentes de Base de Dados no Visual Studio Code.

1. Detetar um problema compatível

Os Agentes de Base de Dados avaliam bases de dados e servidores selecionados de acordo com as políticas de agente guardadas.

Cenários de problemas suportados para Base de Dados SQL do Azure incluem:

  • Utilização elevada da CPU.
  • Memória elevada.
  • I/O elevada.
  • Consulta de longa duração.
  • Consulta bloqueadora
  • Índice em falta.
  • Eliminar índices não utilizados ou duplicados.
  • Regressão do plano de consulta.

Cenários de problemas suportados para Base de Dados do Azure para PostgreSQL incluem:

Scenario Os Agentes de Base de Dados de Condições investigam
Esgotamento da conexão Limites de conexão de funções e acumulação de sessões.
Inchaço de tuplas mortas Acumulação de tuplas mortas, degradação da atualização só de tupla de heap (HOT) e inchaço de índice devido ao churn de atualização.
Uso Elevado de CPU Incompatibilidade de tipo de índice, estatísticas obsoletas e consultas não indexadas.
Inativo na transação Retenção de snapshots por sessões inativas durante uma transação.
Contenção de bloqueio Bloqueios de linha e bloqueios de tabela.
Regressão do plano de consulta Estrangulamentos de Gather, seleção incorreta do tipo de junção, reverificações de bitmaps com perdas e eliminação de índices de suporte.
Derrame da ordenação e pressão de memória Spills de agregados completos, junções de hash, ordenações grandes e consultas paralelas.

Quando ativa uma base de dados, servidor ou cenário, pode demorar cerca de 15 minutos a gerar um novo problema. A criação de incidentes pode terminar mais cedo.

Separadamente, ativar a monitorização de desempenho pode demorar aproximadamente 15 minutos a propagar-se para a lista e configuração da base de dados antes de poder registar a base de dados. Os Agentes de Base de Dados não conseguem detetar nem criar problemas para uma base de dados antes do registo.

2. Rever a investigação e as provas

Abra um incidente para compreender a condição detetada e decidir o que fazer a seguir. Dependendo do tipo de problema e do seu estado atual, os Agentes de Base de Dados podem fornecer:

  • Um resumo da condição.
  • Provas capturadas.
  • Recomendações.
  • Orientação para uma resposta manual.
  • O estado e histórico do incidente atual.

As provas recolhidas descrevem a condição na altura em que foi detetada. Revise o estado atual e as evidências disponíveis antes de tomar uma ação.

Para problemas de CPU elevada e de consultas de longa duração, a assistência de IA contextual utiliza competências adicionais para o ajudar a explorar a evidência. Botões de pedido na ação Recomendada abrem o painel Copilot com o problema como contexto; Explique porquê exibe uma explicação em linha; e Analisar consulta lenta fornece sugestões em linha para uma consulta capturada. Esta assistência utiliza a capacidade do Copilot atribuída pelo seu administrador e não aplica alterações à base de dados.

Para estes passos opcionais de investigação, consulte Investigar com IA contextual.

Como as investigações PostgreSQL são assistidas por IA, o resumo, análise, ação recomendada (incluindo Alteração recomendada, Porque isto é seguro e Rollback SQL) e o resultado esperado são gerados por um LLM. No Painel do servidor no Visual Studio Code, pode também selecionar Perguntar ao Copilot sobre esta secção para explorar um problema no GitHub Copilot Chat. Valide o diagnóstico e quaisquer instruções SQL sugeridas ou alterações nos parâmetros do servidor em tempo real antes de agir.

Para orientações detalhadas de revisão, consulte Rever um problema de desempenho de Agentes de Base de Dados.

3. Decida como responder

A resposta manual recomendada depende do cenário do problema. Database Agents não executa a resposta.

Siga as orientações e responda manualmente

Todos os problemas fornecem resultados de investigação e orientações para remediação manual.

Revise as evidências e orientações, verifique novamente a condição atual e complete a resposta adequada através do fluxo de trabalho autorizado da base de dados. Verifique a condição atual após a resposta. Se o problema permanecer aberto depois de terminar, feche-o.

Para orientações de resposta e verificação, consulte Rever um problema de desempenho dos Agentes de Base de Dados.

4. Acompanhar o estado do problema

O Database Agents atualiza um incidente à medida que investiga a condição ou determina que esta já não necessita de atenção.

No Database Hub, os estados dos problemas são:

  • Ativo: A condição necessita de atenção.
  • A investigar: Database Agents está a recolher ou analisar provas.
  • Investigação concluída: Estão disponíveis orientações. Execute a ação manualmente.
  • Falhou: A investigação não se concluiu com sucesso.
  • Encerrado: O problema já não está ativo e permanece disponível no histórico.

No Dashboard do servidor Visual Studio Code, o Agente de Base de Dados apresenta o progresso da investigação ativa no banner Investigação e acompanha cada problema desde Detetado e Diagnosticado até à resolução — como quando seleciona Marcar Aplicado manualmente após concluir uma alteração ou Descartar problema quando não é necessária qualquer ação.

Uma falha na investigação não significa que uma alteração de base de dados ou servidor tenha falhado. Os Agentes de Base de Dados não executam automaticamente alterações de base de dados ou servidores sem a sua ação.

As investigações são automaticamente repetidas até três vezes em caso de erros reintentáveis. Depois de uma investigação chegar a Falhada ou Investigação concluída, atualizar ou reabrir o problema não regenera os detalhes em falta. Confirme a permissão de leitura na base de dados ou servidor e contacte o Suporte da Microsoft se faltarem detalhes da investigação.

5. Reveja o histórico do problema e a recorrência

Um problema pode fechar-se após completar uma resposta manual ou após a monitorização determinar que a condição foi resolvida. Encerrado é o estado final em qualquer dos casos. Revise o histórico de problemas e a condição da base de dados ou do servidor em tempo real para compreender o resultado. Fechar um problema não prova, por si só, que a carga de trabalho recuperou.

Se uma condição voltar a ocorrer após o encerramento de um problema, os Agentes de Base de Dados criam um novo problema e preservam o problema encerrado no histórico.

Utilize Database Agents de forma responsável

A revisão do operador é necessária para as conclusões e recomendações do Database Agent.

Os Database Agents não substituem:

  • Autenticação e autorização da base de dados.
  • Processos de aprovação existentes.
  • Requisitos de gestão da mudança.
  • Validação de produção.
  • Responsabilidade humana pelas alterações na base de dados.

Bases de dados e servidores suportados

Os Agentes de Base de Dados suportam bases de dados SQL do Azure, incluindo bases de dados serverless e Hyperscale.

Atualmente, o Database Agents não suporta:

  • SQL do Azure elastic pools.
  • Bases de dados serverless com um vCore.
  • Azure SQL Managed Instance.
  • SQL Server nas Máquinas Virtuais do Azure.
  • SQL Server ativado pelo Azure Arc.

Os Agentes de Base de Dados suportam o servidor flexível Base de Dados do Azure para PostgreSQL que executa PostgreSQL 16 ou posterior em várias camadas de computação do Servidor Flexível (incluindo Burstable, Uso Geral e Otimizado para Memória) e configurações de implementação. O suporte para Azure HorizonDB está a chegar em breve.

O suporte para PostgreSQL está atualmente disponível como uma pré-visualização limitada no Visual Studio Code, e o suporte no Fabric Database Hub chegará em breve. O acesso é limitado e requer aprovação. Para solicitar acesso, preencha o formulário de participação na pré-visualização limitada dos Agentes de Base de Dados.

Limitações da pré-visualização pública

  • Disponibilidade do Surface: O Base de Dados SQL do Azure é atualmente suportado no Fabric Database Hub; O suporte para Visual Studio Code chegará em breve.
  • Disponibilidade regional: A base de dados deve estar na região suportada associada à região de origem do tenant do Fabric. A inscrição entre regiões não é suportada.
  • Disponibilidade na Surface: Os Agentes de Base de Dados PostgreSQL estão atualmente disponíveis apenas como uma pré-visualização limitada no Visual Studio Code. O suporte no Fabric Database Hub chegará em breve.
  • Regiões de pré-visualização limitadas e zonas de dados: O suporte do PostgreSQL está inicialmente disponível para servidores no Sul Central dos EUA, West US 3 e Suécia Central, com processamento de IA na Zona de Dados dos EUA e na Zona de Dados da UE.
  • Disponibilidade de problemas: Uma base de dados, servidor ou cenário recém-ativado pode demorar aproximadamente 15 minutos a produzir um novo problema.
  • Resposta manual: Revise as recomendações e realize alterações através do seu fluxo de trabalho autorizado da base de dados.
  • Comportamento de pré-visualização: Os problemas, configurações e regiões suportados podem mudar durante a pré-visualização.

Para a lista completa e os passos de recuperação, consulte Limitações e resolução de problemas dos Agentes de Base de Dados.

Troubleshoot

Uma base de dados ou servidor não aparece

Confirme que a base de dados é suportada, na região suportada e visível para a sua identidade. Se a base de dados estiver em modo serverless, confirme que está reativada. Confirme que a monitorização de desempenho para Microsoft SQL está ativada e permita aproximadamente 15 minutos para que a ativação se propague para a lista e configuração da base de dados. Se a base de dados continuar a não aparecer, contacte o Suporte da Microsoft.

Confirme que recebeu aprovação para a pré-visualização limitada, que instalou a extensão PostgreSQL para Visual Studio Code (versão 1.32.0 ou posterior) e que o servidor flexível executa PostgreSQL 16 ou posterior, está a correr (não parado), está numa região de pré-visualização limitada suportada (South Central US, West US 3 ou Swedish Central) e tem metadados do Azure carregados no Dashboard do servidor (Fetch Metadata). Note que os Agentes de Base de Dados PostgreSQL ainda não estão disponíveis no Fabric Database Hub (em breve). Se o servidor ou agente ainda não aparecer no Visual Studio Code, contacte Suporte da Microsoft.

Uma configuração de agente não pode ser guardada

Guardar valida o agente e a sua permissão de escrita no recurso Azure para cada base de dados ou servidor selecionado. Se qualquer base de dados ou servidor selecionado falhar na verificação de permissões, a gravação completa falha. Remova recursos para os quais não tem permissão da seleção e guarde a configuração restante. Para outros erros ou falhas contínuas, consulte Não é possível guardar um agente ou este não fica ativo.

Não aparece um novo problema

Espere pelo menos 15 minutos, confirme que a condição de origem permanece ativa, confirme que a opção correspondente de política do agente está ativada e atualize a lista de problemas.

A lista de bases de dados ou de servidores não pode ser carregada

Confirme que a sua identidade consegue ler os recursos já guardados para o tenant. Tente novamente com uma identidade que possa aceder aos recursos configurados.

O Agente de Base de Dados não retorna após uma interrupção regional do serviço

Não precisa de reconfigurar ou reativar os Agentes de Base de Dados. Depois de o serviço ser restaurado, atualize o Database Hub ou o Visual Studio Code e tente novamente a operação. Se os Agentes de Base de Dados não regressarem, contacte o Suporte da Microsoft.

Próximo passo