Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O servidor MCP (Protocolo de Contexto de Modelo do Azure) permite que você gerencie recursos do Azure Cosmos DB com prompts de linguagem natural. Você pode listar contas, bancos de dados e contêineres, executar consultas SQL em contêineres e inspecionar metadados de recursos.
O Azure Cosmos DB é um serviço de banco de dados multimodelo distribuído globalmente. Para obter mais informações, consulte a documentação do Azure Cosmos DB.
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.
Listar contas, bancos de dados ou contêineres
Listar contas, bancos de dados ou contêineres do Azure Cosmos DB. Por padrão, essa ferramenta retorna todas as contas em sua assinatura. Especifique o Account para listar bancos de dados nessa conta, ou especifique tanto o Account quanto o Database para listar contêineres nesse banco de dados. Os resultados são retornados no nível especificado: conta, banco de dados ou contêiner.
Os prompts de exemplo incluem:
- "Liste todas as contas do Azure Cosmos DB na minha assinatura."
- "Mostre-me os bancos de dados na conta do Azure Cosmos DB 'prod-cosmos'."
- "Liste todos os contêineres no banco de dados 'orders-db' para a conta do Azure Cosmos DB 'my-cosmosdb'."
| Parâmetro | Obrigatório ou opcional | Description |
|---|---|---|
| Conta | Opcional | O nome da conta do Azure Cosmos DB. Quando não especificado, lista todas as contas na assinatura. Especifique este parâmetro para listar bancos de dados ou combine com Database para listar contêineres. |
| Banco de dados | Opcional | O nome do banco de dados. É necessário especificar Account. Quando fornecido, lista os contêineres dentro desse banco de dados. |
Dicas de anotação da ferramenta:
Destrutivo: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Necessário: ❌
Consultar itens de contêiner
Consultar itens de um contêiner do Azure Cosmos DB. Forneça o nome da conta, o nome do banco de dados e o nome do contêiner e, opcionalmente, forneça uma consulta SQL para filtrar os resultados. A consulta usa a sintaxe da API SQL do Azure Cosmos DB e a ferramenta retorna itens correspondentes como documentos JSON.
Os prompts de exemplo incluem:
- "Liste todos os itens do contêiner 'orders' no banco de dados 'ecommerce-db' para a conta do Azure Cosmos DB 'contoso-cosmos'."
- "Consultar itens do contêiner 'orders' no banco de dados 'ecommerce-db' para a conta 'contoso-cosmos' usando a consulta SQL 'SELECT * FROM c WHERE c.status = shipped'."
- Mostrar itens que contêm 'outage' no contêiner 'orders' do banco de dados 'sales' para a conta do Azure Cosmos DB 'my-cosmos-account'.
| Parâmetro | Obrigatório ou opcional | Description |
|---|---|---|
| Conta | Obrigatório | O nome da conta do Azure Cosmos DB a ser consultada (por exemplo, contoso-cosmos). |
| Contêiner | Obrigatório | O nome do contêiner a ser consultado (por exemplo, orders). |
| Banco de dados | Obrigatório | O nome do banco de dados a ser consultado (por exemplo, ecommerce-db). |
| Consulta | Opcional | Consulta SQL a ser executada no contêiner. Usa a sintaxe da API SQL do Azure Cosmos DB. |
Dicas de anotação da ferramenta:
Destrutivo: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Necessário: ❌