Ferramentas do Servidor MCP do Azure para o Banco de Dados do Azure para MySQL

As ferramentas do Servidor MCP do Azure ajudam você a gerenciar servidores, bancos de dados, configurações e esquemas do Banco de Dados do Azure para MySQL. Você pode usar as ferramentas para obter e listar servidores e bancos de dados, consultar esquemas de tabela e dados e definir parâmetros de servidor usando prompts de linguagem natural.

O Banco de Dados do Azure para MySQL é um serviço de banco de dados relacional gerenciado baseado na edição da comunidade MySQL. Para obter mais informações, consulte a documentação do Banco de Dados do Azure para MySQL.

Observação

Parâmetros de ferramenta: as ferramentas do Servidor MCP do Azure definem parâmetros para os dados necessários para concluir tarefas. Alguns desses parâmetros são específicos para cada ferramenta e estão documentados abaixo. Outros parâmetros são globais e compartilhados por todas as ferramentas. Para obter mais informações, consulte parâmetros de ferramenta.

Obter bancos de dados de servidores MySQL

Liste servidores, bancos de dados ou tabelas no Azure Database for MySQL em sua assinatura. Por padrão, essa ferramenta retorna todos os servidores. Especifique o parâmetro server para listar os bancos de dados em um servidor, ou especifique os parâmetros server e database para listar as tabelas em um banco de dados.

Os prompts de exemplo incluem:

  • "Liste todos os servidores MySQL no grupo de recursos 'rg-prod' com o nome de usuário 'dbadmin'."
  • "Mostre meus servidores MySQL para o grupo de recursos 'web-rg' usando o nome de usuário 'mysqluser'."
  • "Quais servidores MySQL estão no grupo de recursos 'rg-staging' para o nome de usuário 'adminuser'?"
  • "Liste todos os bancos de dados MySQL no servidor 'mysql-server-01' no grupo de recursos 'rg-prod' usando o nome de usuário 'dbadmin'."
  • "Mostre-me os bancos de dados MySQL no servidor 'mysql-dbserver' para o grupo de recursos 'rg-dev' com o nome de usuário 'mysqluser'."
  • "Liste todas as tabelas no banco de dados MySQL 'salesdb' no servidor 'mysql-server-01' no grupo de recursos 'rg-prod' usando o nome de usuário 'dbadmin'."
  • "Mostre-me as tabelas no banco de dados 'inventário' no servidor 'mysql-dbserver' para o grupo de recursos 'rg-test' com o nome de usuário 'mysqluser'."
Parâmetro Obrigatório ou opcional Description
Grupo de recursos Obrigatório O nome do grupo de recursos do Azure que contém os recursos.
Nome de usuário Obrigatório O nome de usuário para acessar o servidor do Banco de Dados do Azure para MySQL.
Nome do banco de dados Opcional O nome do banco de dados do Azure para MySQL de onde listar tabelas. Requer o parâmetro de nome do servidor.
Nome do servidor Opcional O nome do servidor do Azure Database para MySQL a partir do qual listar as bases de dados.

Dicas de anotação da ferramenta:

Destrutivo: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Necessário: ❌

Exemplos

  • Liste todos os servidores do Banco de Dados do Azure para MySQL na assinatura 'contoso-subscription' e no grupo de recursos 'prod-rg'.
  • Listar bancos de dados no servidor 'mysql-prod-01' no grupo de recursos 'prod-rg'.
  • Liste tabelas no banco de dados 'salesdb' no servidor 'mysql-prod-01' no grupo de recursos 'prod-rg'.

Consultar o banco de dados MySQL

A ferramenta Protocolo MCP executa uma consulta SQL SELECT segura e somente leitura em um banco de dados do Azure Database for MySQL Flexible Server. Use essa ferramenta para recuperar ou inspecionar dados da tabela sem modificá-los. A ferramenta rejeita instruções não-SELECT como INSERT, , UPDATE, DELETE, REPLACE, MERGE, , TRUNCATE, , ALTER, , CREATEe DROP. Ele também rejeita multideclarações, comentários que ocultam escritas, controle de transação (BEGIN/COMMIT/ROLLBACK), INTO OUTFILE, e outras palavras-chave destrutivas. Essa ferramenta executa apenas uma única SELECT instrução para garantir a integridade dos dados.

Para obter melhores resultados, liste as colunas necessárias em vez de usar SELECT *. Adicione WHERE filtros, use LIMIT/OFFSET para paginação e adicione ORDER BY para resultados determinísticos. Evite retornar dados confidenciais desnecessários.

Os prompts de exemplo incluem:

  • "Execute a consulta 'SELECT id, name, email FROM customers WHERE id > 100 ORDER BY name LIMIT 50' no banco de dados 'ecommerce_db' no grupo de recursos 'rg-prod' no servidor 'mysql-prod-server' como usuário 'readonlyuser'."
Parâmetro Obrigatório ou opcional Description
Nome do banco de dados Obrigatório O banco de dados MySQL que deve ser acessado.
Consulta Obrigatório Consulta a ser executada em um banco de dados MySQL.
Grupo de recursos Obrigatório O nome do grupo de recursos do Azure. Esse grupo de recursos é um contêiner lógico para recursos do Azure.
Nome do servidor Obrigatório O servidor MySQL a ser acessado.
Nome de usuário Obrigatório O nome de usuário para acessar o servidor MySQL.

Dicas de anotação da ferramenta:

Destrutivo: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Necessário: ❌

Obter configuração do servidor

Essa ferramenta faz parte das ferramentas do PROTOCOLO MCP (Model Context Protocol). Ele recupera detalhes de configuração abrangentes para uma instância do Servidor Flexível do Banco de Dados do Azure para MySQL especificada. A ferramenta retorna configurações de servidor, parâmetros de desempenho, configurações de segurança e características operacionais que ajudam você a gerenciar e otimizar o banco de dados. A saída é JSON e inclui ServerName, Location, Version, SKU, StorageSizeGB, BackupRetentionDays e GeoRedundantBackup.

Os prompts de exemplo incluem:

  • "Mostre-me a configuração do servidor MySQL 'mysql-prod' no grupo de recursos 'rg-prod' com o usuário 'dbadmin'."
Parâmetro Obrigatório ou opcional Description
Grupo de recursos Obrigatório O nome do grupo de recursos do Azure que contém o servidor.
Nome do servidor Obrigatório O nome da instância do Servidor Flexível do Banco de Dados do Azure para MySQL.
Nome de usuário Obrigatório O nome de usuário a ser autenticado no servidor.

Dicas de anotação da ferramenta:

Destrutivo: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Necessário: ❌

Obter parâmetro de servidor

Esta ferramenta do Protocolo de Contexto do Modelo (MCP) recupera o valor atual de um único parâmetro de configuração de servidor no Azure Database for MySQL Flexible Server. Use essa ferramenta para inspecionar uma configuração, como max_connections, wait_timeoutou slow_query_log, antes de alterá-la. Essa ferramenta requer uma conta de usuário com privilégios suficientes para ler parâmetros de servidor.

Os prompts de exemplo incluem:

  • "Mostre-me o valor do parâmetro 'connection_timeout' no grupo de recursos 'rg-prod' para o servidor MySQL 'my-mysql-server' com o nome de usuário 'dbadmin'."
Parâmetro Obrigatório ou opcional Description
Parâmetro Obrigatório O parâmetro MySQL a ser acessado.
Grupo de recursos Obrigatório O nome do grupo de recursos do Azure. Esse grupo de recursos é um contêiner lógico para recursos do Azure.
Nome do servidor Obrigatório O servidor MySQL a ser acessado.
Nome de usuário Obrigatório O nome de usuário para acessar o servidor MySQL.

Dicas de anotação da ferramenta:

Destrutivo: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Necessário: ❌

Atualizar parâmetro do servidor

Essa ferramenta, parte do Protocolo de Contexto de Modelo (MCP), atualiza uma única configuração em um servidor do Banco de Dados do Azure para MySQL. Especifique o grupo de recursos, o nome do servidor, o nome de usuário e o valor a ser definido.

Os prompts de exemplo incluem:

  • "Defina o parâmetro 'connection_timeout' como o valor '20' no nome do servidor 'mysql-prod' no grupo de recursos 'rg-prod' com o nome de usuário 'dbadmin'."
Parâmetro Obrigatório ou opcional Description
Parâmetro Obrigatório O parâmetro MySQL a ser acessado.
Grupo de recursos Obrigatório O nome do grupo de recursos do Azure. Esse grupo de recursos é um contêiner lógico para recursos do Azure.
Nome do servidor Obrigatório O servidor MySQL a ser acessado.
Nome de usuário Obrigatório O nome de usuário para acessar o servidor MySQL.
Valor Obrigatório O valor a ser definido para o parâmetro MySQL.

Dicas de anotação da ferramenta:

Destrutivo: ✅ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ❌ | Segredo: ❌ | Local Necessário: ❌

Exemplos

  • Defina autocommit como 'ON' para o servidor 'my-mysql-server' no grupo de recursos 'prod-rg' usando o usuário 'dbadmin'.
  • Defina slow_query_log como 'ON' para o servidor 'analytics-db' no grupo de recursos 'analytics-rg' usando o usuário 'monitor'.
  • Defina max_connections como '200' para o servidor 'web-db-server' no grupo de recursos 'web-rg' usando o usuário 'dbadmin'.

Obter esquema de tabela

Essa ferramenta MCP (Protocolo de Contexto de Modelo) recupera informações detalhadas de esquema para uma tabela específica em uma instância do Servidor Flexível do Banco de Dados do Azure para MySQL. Ele retorna metadados abrangentes, incluindo definições de coluna, tipos de dados, restrições, índices e relações. Esses metadados ajudam você a entender a estrutura da tabela e dá suporte ao desenvolvimento de aplicativos.

Os prompts de exemplo incluem:

  • "Mostrar o esquema da tabela 'orders' no banco de dados 'salesdb' no servidor 'mysql-prod' dentro do grupo de recursos 'rg-db-prod' como usuário 'dbadmin'."
Parâmetro Obrigatório ou opcional Description
Nome do banco de dados Obrigatório O banco de dados MySQL que deve ser acessado.
Grupo de recursos Obrigatório O nome do grupo de recursos do Azure que contém o servidor.
Nome do servidor Obrigatório O servidor MySQL que hospeda o banco de dados.
Nome da tabela Obrigatório A tabela da qual serão recuperadas informações de esquema.
Nome de usuário Obrigatório O nome de usuário a ser autenticado no servidor MySQL.

Dicas de anotação da ferramenta:

Destrutivo: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Necessário: ❌