Partilhar via


Ferramentas do Azure SQL para a visão geral do Azure MCP Server

O Servidor MCP do Azure permite gerenciar recursos do Banco de Dados SQL do Azure usando prompts de linguagem natural. Esta referência de ferramentas SQL do Azure fornece comandos abrangentes para gerenciar bancos de dados, servidores, regras de firewall e pools elásticos sem sintaxe complexa.

O Banco de Dados SQL do Azure é um mecanismo de banco de dados de plataforma como serviço (PaaS) totalmente gerenciado que lida com a maioria das funções de gerenciamento de banco de dados, como atualização, aplicação de patches, backups e monitoramento sem o envolvimento do usuário.

Note

Parâmetros da ferramenta: as ferramentas do Servidor MCP do Azure definem parâmetros para os dados de que precisam 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 da ferramenta.

Banco de dados: Criar banco de dados

Crie um novo banco de dados em um SQL Server do Azure existente. Este comando cria um banco de dados com camadas de desempenho configuráveis, limites de tamanho e outras configurações.

Exemplos de prompts incluem:

  • Criar banco de dados: "Crie um novo banco de dados SQL chamado 'sales-data' no servidor 'prod-sql-server' no grupo de recursos 'my-resource-group'"
  • Especificar camada: "Criar um 'inventário' de banco de dados SQL com a camada Básica no servidor 'eastus-sql' no grupo de recursos 'my-resource-group'"
  • Grupo de recursos: "Crie um novo banco de dados chamado 'customer-info' no SQL Server 'analytics-sql' no grupo de recursos 'my-resource-group'"
Parameter Obrigatório ou opcional Description
Grupo de recursos Required O nome do grupo de recursos do Azure. Este é um contêiner lógico para recursos do Azure.
Server Required O nome do SQL Server do Azure.
Base de dados Required O nome do Banco de Dados SQL do Azure.
Nome da SKU Opcional O nome da SKU para o banco de dados (por exemplo, Basic, , S0P1, GP_Gen5_2).
Nível de SKU Opcional A camada de SKU para o banco de dados (por exemplo, Basic, , StandardPremium, GeneralPurpose).
Capacidade de SKU Opcional A capacidade de SKU (contagem de DTU ou vCore) para o banco de dados.
Collation Opcional O agrupamento para o banco de dados (por exemplo, SQL_Latin1_General_CP1_CI_AS).
Tamanho máximo de bytes Opcional O tamanho máximo do banco de dados em bytes.
Nome do pool elástico Opcional O nome do pool elástico ao qual atribuir o banco de dados.
Zona redundante Opcional Se o banco de dados deve ser redundante de zona.
Escala de leitura Opcional Opção de escala de leitura para o banco de dados (Enabled ou Disabled).

Dicas de anotação da ferramenta:

Destrutiva: ✅ | Idempotente: ❌ | Mundo Aberto: ❌ | Somente leitura: ❌ | Segredo: ❌ | Local Obrigatório: ❌

Banco de dados: Excluir banco de dados

Exclua um banco de dados SQL.

Exemplos de prompts incluem:

  • Excluir banco de dados: "Exclua o banco de dados SQL 'sales-data' do servidor 'prod-sql-server' no grupo de recursos 'my-resource-group'"
  • Remover do grupo de recursos: "Remover banco de dados 'inventário' do servidor SQL 'eastus-sql' no grupo de recursos 'my-resource-group'"
  • Excluir pelo nome: "Exclua o banco de dados chamado 'customer-info' no servidor 'analytics-sql' no grupo de recursos 'my-resource-group'"
Parameter Obrigatório ou opcional Description
Grupo de recursos Required O nome do grupo de recursos do Azure. Este é um contêiner lógico para recursos do Azure.
Server Required O nome do SQL Server do Azure.
Base de dados Required O nome do Banco de Dados SQL do Azure.

Dicas de anotação da ferramenta:

Destrutiva: ✅ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ❌ | Segredo: ❌ | Local Obrigatório: ❌

Base de dados: Listar bases de dados

Lista todos os bancos de dados em seu recurso de nuvem com seus detalhes de configuração, status, SKU e desempenho. Use quando precisar: exibir o inventário do banco de dados, verificar o status do banco de dados, comparar configurações de banco de dados ou localizar bancos de dados para operações de gerenciamento.

Exemplos de prompts incluem:

  • Listar bancos de dados: "Mostrar todos os bancos de dados no meu servidor 'eastus-sql' no grupo de recursos 'my-resource-group'"
  • Inventário de banco de dados: "Listar bancos de dados no grupo de recursos 'my-resource-group' no servidor 'eastus-sql'"
  • Verifique o status do banco de dados: "Quais bancos de dados estão atualmente ativos no meu servidor 'eastus-sql' no grupo de recursos 'my-resource-group'?"
Parameter Obrigatório ou opcional Description
Grupo de recursos Required O nome do grupo de recursos do Azure. Este é um contêiner lógico para recursos do Azure.
Server Required O nome do recurso.

Dicas de anotação da ferramenta:

Destrutiva: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Obrigatório: ❌

Banco de dados: Renomear banco de dados

Renomeie um banco de dados existente para um novo nome dentro do mesmo servidor SQL do Azure.

Exemplos de prompts incluem:

  • Renomear banco de dados: "Renomeie o banco de dados SQL 'sales-data' no servidor 'prod-sql-server' no grupo de recursos 'my-resource-group' para 'sales-archive'"
  • Renomeie com servidor explícito: "Renomeie meu banco de dados SQL do Azure 'inventory' para 'inventory-2025' no servidor 'eastus-sql' no grupo de recursos 'my-resource-group'"
Parameter Obrigatório ou opcional Description
Grupo de recursos Required O nome do grupo de recursos do Azure. Este é um contêiner lógico para recursos do Azure.
Server Required O nome do SQL Server do Azure.
Base de dados Required O nome do Banco de Dados SQL do Azure.
Novo nome do banco de dados Required O novo nome para o Banco de Dados SQL do Azure.

Dicas de anotação da ferramenta:

Destrutiva: ✅ | Idempotente: ❌ | Mundo Aberto: ❌ | Somente leitura: ❌ | Segredo: ❌ | Local Obrigatório: ❌

Banco de dados: Mostrar detalhes do banco de dados

Recupera informações detalhadas sobre um banco de dados específico. Use este comando para verificar a configuração, a camada de desempenho, o tamanho e outras características do seu banco de dados.

Exemplos de prompts incluem:

  • Ver detalhes da base de dados: "Mostre-me detalhes para a base de dados 'inventory' no meu servidor 'eastus-sql' no grupo de recursos 'my-resource-group'"
  • Verifique a configuração do banco de dados: "Você pode me dizer as especificações e o estado atual do meu banco de dados customer-db no servidor 'prod-sql-server' no grupo de recursos 'my-resource-group'?"
  • Verifique a camada de desempenho: "Qual camada de serviço para o servidor 'prod-sql-server' no grupo de recursos 'my-resource-group' está usando meu banco de dados de análise?"
Parameter Obrigatório ou opcional Description
Grupo de recursos Required O nome do grupo de recursos do Azure. Este é um contêiner lógico para recursos do Azure.
Server Required O nome do recurso.
Base de dados Required O nome do banco de dados no recurso.

Dicas de anotação da ferramenta:

Destrutiva: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Obrigatório: ❌

Banco de dados: Atualizar banco de dados

Atualize as definições de configuração para um Banco de Dados SQL do Azure existente.

Exemplos de prompts incluem:

  • Atualizar camada de desempenho: "Atualize a camada de desempenho do banco de dados SQL 'sales-data' no servidor 'prod-sql-server' no grupo de recursos 'my-resource-group'"
  • Dimensionar banco de dados SKU: "Dimensionar o banco de dados SQL 'inventário' no servidor 'eastus-sql' no grupo de recursos 'my-resource-group' para usar o SKU do S3"
  • Alterar as configurações do banco de dados: "Atualize o banco de dados SQL do Azure 'analytics' para usar a camada Premium no servidor 'eastus-sql' no grupo de recursos 'my-resource-group'"
Parameter Obrigatório ou opcional Description
Grupo de recursos Required O nome do grupo de recursos do Azure. Este é um contêiner lógico para recursos do Azure.
Server Required O nome do SQL Server do Azure.
Base de dados Required O nome do Banco de Dados SQL do Azure.
Nome da SKU Opcional O nome da SKU para o banco de dados (por exemplo, Basic, , S0P1, GP_Gen5_2).
Nível de SKU Opcional A camada de SKU para o banco de dados (por exemplo, Basic, , StandardPremium, GeneralPurpose).
Capacidade de SKU Opcional A capacidade de SKU (contagem de DTU ou vCore) para o banco de dados.
Collation Opcional O agrupamento para o banco de dados (por exemplo, SQL_Latin1_General_CP1_CI_AS).
Tamanho máximo de bytes Opcional O tamanho máximo do banco de dados em bytes.
Nome do pool elástico Opcional O nome do pool elástico ao qual atribuir o banco de dados.
Zona redundante Opcional Se o banco de dados deve ser redundante de zona.
Escala de leitura Opcional Opção de escala de leitura para o banco de dados (Enabled ou Disabled).

Dicas de anotação da ferramenta:

Destrutiva: ✅ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ❌ | Segredo: ❌ | Local Obrigatório: ❌

Autenticação do servidor: listar administradores do Microsoft Entra

Lista os administradores do Microsoft Entra ID configurados para um servidor SQL do Azure. Use este comando para gerenciar e auditar o acesso baseado em identidade ao seu recurso.

Exemplos de prompts incluem:

  • Verifique os usuários administradores: "Mostre-me todos os administradores do Microsoft Entra para o meu servidor 'prod-sql' no grupo de recursos 'my-resource-group'"
  • Acesso de identidade: "Listar administradores do Microsoft Entra para SQL server 'finance-db' no grupo de recursos 'my-resource-group'"
  • Verificação de segurança: "Quem tem acesso de administrador ao servidor 'prod-sql-server' no grupo de recursos 'my-resource-group'?"
Parameter Obrigatório ou opcional Description
Grupo de recursos Required O nome do grupo de recursos do Azure. Este é um contêiner lógico para recursos do Azure.
Server Required O nome do recurso do Azure SQL Server.

Dicas de anotação da ferramenta:

Destrutiva: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Obrigatório: ❌

Servidor: Criar servidor

Cria um novo servidor SQL do Azure no grupo de recursos e local especificados.

Exemplos de prompts incluem:

  • Criar servidor SQL: "Crie um novo servidor SQL do Azure chamado 'prod-sql-server' no grupo de recursos 'my-resource-group' com o usuário admin 'sqladmin' e a senha 'MyStr0ngP@ssw0rd!' no Leste dos EUA"
  • Especifique o usuário admin: "Crie um servidor SQL do Azure com o nome 'eastus-sql' no grupo de recursos 'my-resource-group' no local 'East US' com o usuário admin 'sqladmin' e a senha 'SecureP@ss123!'"
  • Configurar servidor no grupo de recursos: "Configure um novo servidor SQL chamado 'analytics-sql' para o usuário administrador 'sqladmin' com senha 'Analytics2024!' no oeste dos EUA 2 no grupo de recursos 'my-resource-group' com acesso à rede pública habilitado"
Parameter Obrigatório ou opcional Description
Grupo de recursos Required O nome do grupo de recursos do Azure. Este é um contêiner lógico para recursos do Azure.
Server Required O nome do recurso do Azure SQL Server.
Usuário administrador Required O nome de logon do administrador para o servidor SQL.
Palavra-passe de administrador Required A senha de administrador para o servidor SQL.
Localização Required O local da região do Azure onde o servidor SQL é criado.
Versão Opcional A versão do SQL Server a ser criada (por exemplo, 12.0).
Acesso à rede pública Opcional Se o acesso à rede pública está habilitado para o servidor SQL (Enabled ou Disabled).

Dicas de anotação da ferramenta:

Destrutiva: ✅ | Idempotente: ❌ | Mundo Aberto: ❌ | Somente leitura: ❌ | Segredo: ❌ | Local Obrigatório: ❌

Servidor: Excluir servidor

Exclui um servidor SQL do Azure e todos os seus bancos de dados do grupo de recursos especificado.

Exemplos de prompts incluem:

  • Excluir o servidor SQL: "Excluir o servidor SQL do Azure 'prod-sql-server' do grupo de recursos 'my-resource-group'"
  • Remover da assinatura: "Remova o servidor SQL 'test-sql-server' do grupo de recursos 'my-resource-group'"
  • Exclusão permanente: "Excluir o servidor SQL 'analytics-sql' no grupo de recursos 'my-resource-group' permanentemente"
Parameter Obrigatório ou opcional Description
Grupo de recursos Required O nome do grupo de recursos do Azure. Este é um contêiner lógico para recursos do Azure.
Server Required O nome do recurso do Azure SQL Server.
Força Opcional Força a exclusão do servidor sem prompts de confirmação.

Dicas de anotação da ferramenta:

Destrutiva: ✅ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ❌ | Segredo: ❌ | Local Obrigatório: ❌

Servidor: Listar servidores

Lista os servidores SQL do Azure dentro de um grupo de recursos.

Exemplos de prompts incluem:

  • Listar servidores SQL: "Listar todos os servidores SQL do Azure no grupo de recursos 'my-resource-group'"
  • Mostrar todos os servidores: "Mostrar todos os servidores SQL disponíveis no grupo de recursos 'my-resource-group'"
  • Inventário do servidor: "Que servidores SQL tenho no grupo de recursos 'my-resource-group'?"
Parameter Obrigatório ou opcional Description
Grupo de recursos Required O nome do grupo de recursos do Azure. Este é um contêiner lógico para recursos do Azure.
Grupo de recursos Opcional O grupo de recursos pelo qual filtrar servidores.

Dicas de anotação da ferramenta:

Destrutiva: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Obrigatório: ❌

Servidor: Mostrar detalhes do servidor

Recupera informações detalhadas sobre um servidor SQL do Azure, incluindo sua configuração, status e propriedades, como o nome de domínio totalmente qualificado, versão, logon de administrador e configurações de acesso à rede.

Exemplos de prompts incluem:

  • Mostrar detalhes do servidor: "Mostrar os detalhes do servidor SQL do Azure 'prod-sql-server' no grupo de recursos 'my-resource-group'"
  • Obter configuração: "Obtenha os detalhes de configuração para o SQL Server 'analytics-sql' no grupo de recursos 'my-resource-group'"
  • Propriedades de exibição: "Exibir as propriedades do servidor SQL 'eastus-sql' no grupo de recursos 'my-resource-group'"
Parameter Obrigatório ou opcional Description
Grupo de recursos Required O nome do grupo de recursos do Azure. Este é um contêiner lógico para recursos do Azure.
Server Required O nome do recurso do Azure SQL Server.

Dicas de anotação da ferramenta:

Destrutiva: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Obrigatório: ❌

Firewall do servidor: listar regras

Lista todas as regras de firewall para um recurso específico. Use este comando para gerenciar e revisar as configurações de acesso à rede para seu recurso.

Exemplos de prompts incluem:

  • Ver definições da firewall: "Mostrar-me todas as regras de firewall para o meu 'prod-sql-server' no grupo de recursos 'my-resource-group'"
  • Verifique os controles de acesso: "Existem regras de firewall para meu servidor SQL analytics-db no grupo de recursos 'my-resource-group'?"
  • Auditoria de segurança: "Liste as regras de firewall para nosso servidor finance-db no grupo de recursos 'my-resource-group'"
Parameter Obrigatório ou opcional Description
Grupo de recursos Required O nome do grupo de recursos do Azure. Este é um contêiner lógico para recursos do Azure.
Server Required O nome do recurso do Azure SQL Server.

Dicas de anotação da ferramenta:

Destrutiva: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Obrigatório: ❌

Firewall do servidor: Criar regra

Cria uma regra de firewall para um recurso. As regras de firewall controlam quais endereços IP podem se conectar ao recurso. Você pode especificar um único endereço IP (definindo o IP inicial e final com o mesmo valor) ou um intervalo de endereços IP.

Exemplos de prompts incluem:

  • Adicionar regra de firewall: "Criar uma regra de firewall chamada 'office-access' para o meu servidor 'prod-sql' no grupo de recursos 'my-resource-group' permitindo o intervalo de IP 192.168.1.1 a 192.168.1.100"
  • Definir intervalo de acesso: "Preciso definir uma regra de firewall de 'teste' no meu servidor 'analytics-sql' no grupo de recursos 'my-resource-group' para permitir o acesso do intervalo de IP 10.0.0.1 a 10.0.0.255"
  • Permitir IP único: "Criar uma regra de firewall 'allow-single-ip' para permitir o acesso do endereço IP 203.0.113.5 ao meu servidor SQL 'production-uswest' no grupo de recursos 'my-resource-group'"
Parameter Obrigatório ou opcional Description
Grupo de recursos Required O nome do grupo de recursos do Azure. Este é um contêiner lógico para recursos do Azure.
Server Required O nome do recurso do Azure SQL Server.
Regra de firewall Required O nome da regra de firewall.
Endereço IP inicial Required O endereço IP inicial do intervalo de regras de firewall.
Endereço IP final Required O endereço IP final do intervalo de regras de firewall.

Dicas de anotação da ferramenta:

Destrutiva: ✅ | Idempotente: ❌ | Mundo Aberto: ❌ | Somente leitura: ❌ | Segredo: ❌ | Local Obrigatório: ❌

Firewall do servidor: Regra de exclusão

Exclui uma regra de firewall de um recurso. Esta operação remove a regra de firewall especificada, potencialmente restringindo o acesso para os endereços IP que eram anteriormente permitidos por esta regra. Se a regra não existir, nenhum erro será retornado.

Exemplos de prompts incluem:

  • Remover regra de firewall: "Excluir a regra de firewall chamada 'office-access' do meu servidor 'prod-sql' no grupo de recursos 'my-resource-group'"
  • Revogar acesso: "Revogar a regra de firewall 'temp-access' no meu servidor 'test-sql' no grupo de recursos 'my-resource-group'"
  • Excluir regra de acesso: "Remova a regra de firewall 'guest-access' do nosso servidor SQL de desenvolvimento no grupo de recursos 'my-resource-group'"
Parameter Obrigatório ou opcional Description
Grupo de recursos Required O nome do grupo de recursos do Azure. Este é um contêiner lógico para recursos do Azure.
Server Required O nome do recurso do Azure SQL Server.
Regra de firewall Required O nome da regra de firewall.

Dicas de anotação da ferramenta:

Destrutiva: ✅ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ❌ | Segredo: ❌ | Local Obrigatório: ❌

Pools elásticos: Listar pools elásticos

Lista todos os pools elásticos para um recurso específico. Os pools elásticos são uma solução de alocação de recursos que permite gerenciar e dimensionar vários bancos de dados com demandas de recursos variáveis.

Exemplos de prompts incluem:

  • Exibir pools de recursos: "Mostrar todos os pools elásticos no meu servidor 'main-sql' no grupo de recursos 'my-resource-group'"
  • Verifique a elasticidade: "Liste todos os pools elásticos que temos em execução em nosso servidor SQL customer-db no grupo de recursos 'my-resource-group'"
  • Inventário de pool: "Quais pools elásticos são implantados no SQL Server 'main-sql' no grupo de recursos 'my-resource-group'?"
Parameter Obrigatório ou opcional Description
Grupo de recursos Required O nome do grupo de recursos do Azure. Este é um contêiner lógico para recursos do Azure.
Server Required O nome do recurso do Azure SQL Server.

Dicas de anotação da ferramenta:

Destrutiva: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Obrigatório: ❌