Partilhar via


Ferramentas do Azure MCP Server para Base de Dados SQL do Azure

O Azure MCP Server permite-lhe gerir recursos do Base de Dados SQL do Azure, incluindo criar, eliminar, atualizar e listar bases de dados, com prompts em linguagem natural.

Base de Dados SQL do Azure é um serviço de base de dados relacional na cloud Microsoft Azure que oferece alta disponibilidade, escalabilidade e segurança. Para mais informações, consulte Base de Dados SQL do Azure documentação.

Note

Parâmetros das ferramentas: As ferramentas Azure MCP Server definem parâmetros para os dados necessários para completar 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.

Criar Banco de Dados SQL

Crie uma nova Base de Dados SQL do Azure num SQL Server existente. Crie uma base de dados com níveis de desempenho configuráveis, limites de tamanho e outras definições. Devolve a informação recém-criada da base de dados, incluindo detalhes de configuração.

Exemplos de prompts incluem:

  • "Crie uma base de dados SQL chamada 'my-database' com nível SKU Premium no servidor 'my-sql-server'."
  • "Crie uma nova base de dados SQL chamada 'products-db' no grupo de recursos 'meu-grupo-de recursos' no servidor 'my-sql-server'."
  • "Crie uma base de dados SQL 'reports-db' com um tamanho máximo de 2GB no servidor 'my-sql-server'."
Parameter Obrigatório ou opcional Description
Nome da base de dados Required O nome do Base de Dados SQL do Azure.
Grupo de recursos Required O nome do grupo de recursos Azure. Isto é um contentor lógico para recursos do Azure.
Nome do servidor Required O nome do servidor Azure SQL.
Collation Opcional O agrupamento para o banco de dados (por exemplo, SQL_Latin1_General_CP1_CI_AS).
Nome do pool de elasticidade Opcional O nome do pool elástico ao qual atribuir o banco de dados.
Tamanho máximo de bytes Opcional O tamanho máximo do banco de dados em bytes.
Escala de leitura Opcional Opção de escala de leitura para a base de dados (Ativada ou Desativada).
Capacidade de SKU Opcional A capacidade de SKU (contagem de DTU ou vCore) para o banco de dados.
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).
Zona redundante Opcional Indica se a base de dados deve ser redundante em zona.

Dicas de anotação da ferramenta:

Destruidor: ✅ | Idempotente: ❌ | Mundo Aberto: ❌ | Somente Leitura: ❌ | Segredo: ❌ | Local Obrigatório: ❌

Criar SQL Server

Crie um novo servidor SQL do Azure no grupo de recursos e localização especificados. O servidor está configurado com as credenciais de administrador fornecidas e as definições opcionais. O comando devolve o servidor criado juntamente com as suas propriedades, incluindo o nome de domínio totalmente qualificado.

Exemplos de prompts incluem:

  • "Crie um servidor SQL do Azure chamado 'my-sql-server' na localização 'eastus' com login de administrador 'sqladmin'."
  • "Configura um novo servidor SQL chamado 'prod-sql-server' no grupo de recursos 'meu-grupo-recurso' com a tua palavra-passe de administrador."
  • "Crie um servidor SQL com o nome 'dev-sql-server' no grupo de recursos 'dev-resource-group' localizado em 'westus2'."
Parameter Obrigatório ou opcional Description
Login de 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 A região do Azure onde o servidor SQL será criado.
Grupo de recursos Required O nome do grupo de recursos Azure, que é um contentor lógico para recursos Azure.
Nome do servidor Required Nome do Azure SQL Server.
Acesso à rede pública Opcional Se o acesso à rede pública está habilitado para o servidor SQL (Enabled ou Disabled).
Versão Opcional A versão do SQL Server a criar (atualmente apenas 12.0 é suportada).

Dicas de anotação da ferramenta:

Destruidor: ✅ | Idempotente: ❌ | Mundo Aberto: ❌ | Somente Leitura: ❌ | Segredo: ❌ | Local Obrigatório: ❌

Criar uma regra de firewall para SQL Server

Cria uma regra de firewall para um Azure SQL Server. As regras de firewall controlam quais os endereços IP autorizados a ligar-se ao SQL Server. Pode especificar um único endereço IP (definindo o IP inicial e final para o mesmo valor) ou um intervalo de endereços IP. Este comando devolve a regra de firewall criada com as suas propriedades.

Exemplos de prompts incluem:

  • "Crie uma regra de firewall chamada 'allow-office-ip' para SQL Server 'my-sql-server' no grupo de recursos 'my-resource-group'."
  • "Adicione uma regra de firewall para o SQL Server 'my-sql-server' permitindo intervalos de IP '203.0.113.0' a '203.0.113.255'."
  • "Crie uma nova regra de firewall para o Azure SQL Server 'prod-sql-server' com limites de IP de '198.51.100.0' a '198.51.100.255'."
Parameter Obrigatório ou opcional Description
Endereço IP final Required O endereço IP final do intervalo de regras de firewall.
Nome da regra do firewall Required O nome da regra de firewall.
Grupo de recursos Required O nome do grupo de recursos Azure. Isto é um contentor lógico para recursos do Azure.
Nome do servidor Required O nome do Azure SQL Server.
Endereço IP inicial Required O endereço IP inicial do intervalo de regras de firewall.

Dicas de anotação da ferramenta:

Destruidor: ✅ | Idempotente: ❌ | Mundo Aberto: ❌ | Somente Leitura: ❌ | Segredo: ❌ | Local Obrigatório: ❌

Excluir Banco de Dados SQL

Apaga uma base de dados de um Azure SQL Server. Esta operação idempotente remove a base de dados especificada do servidor, retornando Deleted = false se a base de dados não existir ou Deleted = true se foi removida com sucesso.

Exemplos de prompts incluem:

  • "Apague a base de dados SQL 'my-database' do servidor 'my-sql-server'."
  • "Remover a base de dados 'old-database' do grupo de recursos 'my-resource-group' no servidor 'my-sql-server'."
  • "Apaga a base de dados 'test-database' do SQL Server 'dev-sql-server'."
Parameter Obrigatório ou opcional Description
Nome da base de dados Required O nome do Base de Dados SQL do Azure.
Grupo de recursos Required O nome do grupo de recursos Azure. Isto é um contentor lógico para recursos do Azure.
Nome do servidor Required O nome do Azure SQL Server.

Dicas de anotação da ferramenta:

Destruidor: ✅ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente Leitura: ❌ | Segredo: ❌ | Local Obrigatório: ❌

Eliminar o SQL Server

Remova o servidor SQL do Azure especificado da sua subscrição do Azure, incluindo todas as bases de dados associadas. Esta operação apaga permanentemente todos os dados do servidor e não pode ser revertida. Use force para contornar a confirmação.

Exemplos de prompts incluem:

  • "Eliminar o servidor SQL 'meu-sql-servidor' no grupo de recursos 'meu-grupo-de-recursos'."
  • Remover o servidor 'old-sql-server' do SQL do Azure do meu grupo de recursos.
  • "Eliminar permanentemente o 'test-sql-server' do SQL Server sem confirmação."
Parameter Obrigatório ou opcional Description
Grupo de recursos Required O nome do grupo de recursos Azure. Isto é um contentor lógico para recursos do Azure.
Nome do servidor Required O nome do Azure SQL Server.
Força Opcional Forçar a eliminação do servidor sem pedidos de confirmação.

Dicas de anotação da ferramenta:

Destruidor: ✅ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente Leitura: ❌ | Segredo: ❌ | Local Obrigatório: ❌

Eliminar regra de firewall no SQL Server

Eliminar uma regra de firewall de um Azure SQL Server. Esta operação remove a regra do firewall especificada, que pode restringir o acesso aos endereços IP anteriormente permitidos por esta regra. A operação é idempotente; se a regra não existir, não é devolvido qualquer erro.

Exemplos de prompts incluem:

  • Apague a regra do firewall 'allow-office-ip' do grupo de recursos 'meu-grupo-de-recursos' no SQL Server 'my-sql-server'.
  • "Remover a regra do firewall 'temp-access-rule' para SQL Server 'my-sql-server' no grupo de recursos 'my-resource-group'."
  • Eliminar a regra de firewall 'regra-firewall-antiga' do meu servidor SQL 'dev-sql-server'.
Parameter Obrigatório ou opcional Description
Nome da regra do firewall Required O nome da regra de firewall.
Grupo de recursos Required O nome do grupo de recursos Azure. Isto é um contentor lógico para recursos do Azure.
Nome do servidor Required O nome do Azure SQL Server.

Dicas de anotação da ferramenta:

Destruidor: ✅ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente Leitura: ❌ | Segredo: ❌ | Local Obrigatório: ❌

Obtenha detalhes do Base de Dados SQL do Azure

Recupere informações sobre bases de dados SQL do Azure num SQL Server. Pode mostrar detalhes de uma base de dados SQL do Azure específica pelo nome ou listar todas as bases de dados SQL do Azure dentro do SQL Server especificado. Esta ferramenta fornece informações sobre a base de dados, incluindo detalhes de configuração e estado atual.

Exemplos de prompts incluem:

  • "Liste todas as bases de dados no grupo de recursos 'my-rg' para o servidor 'meu-servidor'."
  • Obtenha detalhes da base de dados SQL do Azure 'my-database' no grupo de recursos 'my-rg' e no servidor 'my-server'.
  • Mostrar todas as bases de dados do SQL do Azure no grupo de recursos 'my-rg' no servidor 'meu-servidor'.
  • Recuperar a base de dados SQL do Azure 'my-database' do grupo de recursos 'my-rg' no servidor 'my-server'.
Parameter Obrigatório ou opcional Description
Grupo de recursos Required O nome do grupo de recursos Azure. Isto é um contentor lógico para recursos do Azure.
Nome do servidor Required O nome do Azure SQL Server.
Nome da base de dados Opcional O nome do Base de Dados SQL do Azure.

Dicas de anotação da ferramenta:

Destruidor: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente Leitura: ✅ | Segredo: ❌ | Local Obrigatório: ❌

Obtenha a lista de piscinas elásticas

Lista todos os pools elásticos SQL num Azure SQL Server, incluindo o seu SKU, capacidade, estado e limites da base de dados. Pode consultar o inventário do pool elástico, verificar a utilização do pool, comparar configurações de pools ou encontrar pools disponíveis para colocação em bases de dados. A ferramenta devolve um array JSON de pools elásticos com detalhes completos da configuração.

Exemplos de prompts incluem:

  • Liste todos os pools elásticos no grupo de recursos 'meu-grupo-de-recursos' para o servidor SQL 'my-sql-server'.
  • "Mostra-me os pools elásticos no grupo de recursos 'prod-resource-group' para SQL Server 'prod-sql-server'."
  • Quais são os pools elásticos que existem no meu servidor SQL 'dev-sql-server' no grupo de recursos 'dev-resource-group'?
Parameter Obrigatório ou opcional Description
Grupo de recursos Required O nome do grupo de recursos Azure. Isto é um contentor lógico para recursos do Azure.
Nome do servidor Required O nome do Azure SQL Server.

Dicas de anotação da ferramenta:

Destruidor: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente Leitura: ✅ | Segredo: ❌ | Local Obrigatório: ❌

Obtenha a lista de regras do firewall

Recupere uma lista de regras de firewall para um Azure SQL Server. Este comando recupera todas as regras do firewall configuradas para o servidor SQL especificado, incluindo os seus intervalos de endereços IP e nomes de regras. Devolve um array de objetos de regras de firewall com as suas propriedades.

Exemplos de prompts incluem:

  • "Liste todas as regras do firewall no grupo de recursos 'meu-grupo-recurso' para SQL Server 'my-sql-server'."
  • "Mostra-me as regras do firewall no grupo de recursos 'prod-resource-group' para SQL Server 'prod-sql-server'."
  • "Que regras de firewall são definidas para SQL Server 'dev-sql-server' no grupo de recursos 'dev-resource-group'?"
Parameter Obrigatório ou opcional Description
Grupo de recursos Required O nome do grupo de recursos Azure. Isto é um contentor lógico para recursos do Azure.
Nome do servidor Required O nome do Azure SQL Server.

Dicas de anotação da ferramenta:

Destruidor: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente Leitura: ✅ | Segredo: ❌ | Local Obrigatório: ❌

Obtenha informações sobre servidores SQL

Recuperar detalhes sobre servidores SQL do Azure num grupo de recursos. Mostrar informação para um servidor SQL do Azure específico pelo nome ou listar todos os servidores SQL do Azure dentro do grupo de recursos especificado. Devolve informações abrangentes sobre o servidor, incluindo detalhes de configuração e o estado atual.

Exemplos de prompts incluem:

  • "Liste todos os servidores SQL do Azure no grupo de recursos 'meu-grupo-recurso'."
  • "Mostra-me todos os servidores SQL do Azure no grupo de recursos 'prod-resource-group'."
  • "Mostra-me os detalhes do servidor SQL do Azure 'my-sql-server'."
  • Obtenha informações sobre o servidor SQL do Azure 'prod-sql-server'.
  • "Mostrar as propriedades do servidor SQL do Azure 'dev-sql-server'."
Parameter Obrigatório ou opcional Description
Grupo de recursos Required O nome do grupo de recursos Azure. Isto é um contentor lógico para recursos do Azure.
Nome do servidor Opcional O nome do servidor SQL do Azure.

Dicas de anotação da ferramenta:

Destruidor: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente Leitura: ✅ | Segredo: ❌ | Local Obrigatório: ❌

Listar administradores do Microsoft Entra ID

Liste os administradores do Microsoft Entra ID configurados para um servidor SQL. Este comando recupera todos os administradores do Entra ID, incluindo os seus nomes de visualização, IDs de objeto e informações do locatário.

Exemplos de prompts incluem:

  • "Listar administradores do Microsoft Entra ID para SQL Server 'prod-sql-server' no grupo de recursos 'prod-resource-group'."
  • Mostra-me os administradores do Entra ID configurados para o SQL Server 'dev-sql-server' no grupo de recursos 'dev-resource-group'.
  • "Que administradores do Microsoft Entra ID estão configurados para o meu servidor SQL 'analytics-sql-server' no grupo de recursos 'data-resource-group'?"
Parameter Obrigatório ou opcional Description
Grupo de recursos Required O nome do grupo de recursos Azure.
Nome do servidor Required O nome Azure SQL Server (por exemplo, prod-sql-server).

Dicas de anotação da ferramenta:

Destruidor: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente Leitura: ✅ | Segredo: ❌ | Local Obrigatório: ❌

Renomear Base de Dados SQL

Renomeia uma Base de Dados SQL do Azure existente para um novo nome dentro do mesmo SQL Server. Este comando altera o identificador do recurso da base de dados, preservando a sua configuração e dados. Devolve a informação atualizada da base de dados com o novo nome.

Exemplos de prompts incluem:

  • Renomeie a base de dados 'minha-base-de-dados' no servidor 'my-sql-server' para 'my-database-v2' no grupo de recursos 'my-resource-group'.
  • "Renomear a minha base de dados SQL de 'antiga-base de dados' para 'nova-base de dados' no servidor 'prod-sql-server'."
Parameter Obrigatório ou opcional Description
Nome da base de dados Required O nome do Base de Dados SQL do Azure.
Novo nome do banco de dados Required O novo nome para Base de Dados SQL do Azure.
Grupo de recursos Required O nome do grupo de recursos Azure. Isto é um contentor lógico para recursos do Azure.
Nome do servidor Required O nome do Azure SQL Server.

Dicas de anotação da ferramenta:

Destruidor: ✅ | Idempotente: ❌ | Mundo Aberto: ❌ | Somente Leitura: ❌ | Segredo: ❌ | Local Obrigatório: ❌

Atualizar o Banco de Dados SQL

Escalar e configurar as definições de desempenho do Base de Dados SQL do Azure. Atualize o SKU, camada de computação, capacidade de armazenamento ou opções de redundância de uma base de dados existente para responder aos requisitos de desempenho em mudança. Este comando devolve a configuração atualizada da base de dados, incluindo alterações de escalabilidade aplicadas.

Exemplos de prompts incluem:

  • Alterar a ordenação da base de dados SQL 'my-database' no servidor 'my-sql-server' no grupo de recursos 'my-resource-group'.
  • "Atualize a base de dados SQL 'my-database' no servidor 'my-sql-server' para ter um tamanho máximo de 2GB."
Parameter Obrigatório ou opcional Description
Nome da base de dados Required O nome do Base de Dados SQL do Azure.
Grupo de recursos Required O nome do grupo de recursos Azure. Isto é um contentor lógico para recursos do Azure.
Nome do servidor Required O nome do Azure SQL Server.
Collation Opcional O agrupamento para o banco de dados (por exemplo, SQL_Latin1_General_CP1_CI_AS).
Nome do pool de elasticidade Opcional O nome do pool elástico ao qual atribuir o banco de dados.
Tamanho máximo de bytes Opcional O tamanho máximo do banco de dados em bytes.
Escala de leitura Opcional Opção de escala de leitura para a base de dados (Ativada ou Desativada).
Capacidade de SKU Opcional A capacidade de SKU (contagem de DTU ou vCore) para o banco de dados.
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).
Zona redundante Opcional Se o banco de dados deve ter redundância de zona.

Dicas de anotação da ferramenta:

Destruidor: ✅ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente Leitura: ❌ | Segredo: ❌ | Local Obrigatório: ❌