TL;DR — O conector built-in do Azure Cosmos DB para Logic Apps Standard chegou ao GA, oferecendo desempenho muito superior ao conector gerenciado: latência reduzida (execução in-process), throughput escalável e recursos avançados como trigger de change feed em tempo real, bulk operations e autenticação via Entra ID com managed identities. Para empresas brasileiras, isso significa workflows de integração mais rápidos, menor complexidade de segurança e custos previsíveis — ideal para cenários de sincronização de dados, pipelines de IA e arquiteturas orientadas a eventos.
Por que um conector built-in?
O Azure Logic Apps oferece dois tipos de conectores: os gerenciados (managed), que rodam em infraestrutura multitenant compartilhada, e os built-in, que executam diretamente no runtime single-tenant do Logic Apps. Os conectores built-in trazem vantagens significativas:
- Menor latência. As operações executam in-process, eliminando o salto de rede para um serviço externo de conector.
- Maior throughput. Sem throttling compartilhado — a performance escala com o plano do Logic Apps.
- Funcionalidades mais ricas. Acesso a capacidades como o trigger de change feed, inexistente no conector gerenciado.
- Melhor custo-benefício. Os conectores built-in rodam no compute do Logic Apps e não são faturados separadamente, o que reduz custos em escala.
Para equipes de engenharia no Brasil que lidam com integrações críticas, como sincronização de pedidos entre sistemas legados e modernos, ou pipelines de dados em tempo real, essa diferença de latência e throughput pode representar a viabilidade ou não de um projeto.
O que está incluído?
Trigger de change feed em tempo real
O trigger nativo "When an item is created or modified" utiliza o change feed do Azure Cosmos DB para disparar workflows sempre que documentos são criados ou atualizados em um container monitorado. É o mesmo padrão battle-tested usado no Azure Functions e no change feed processor, agora disponível diretamente no Logic Apps.
Use para:
- Sincronizar dados com sistemas downstream em tempo real
- Disparar notificações quando pedidos, perfis ou estoque mudam
- Alimentar pipelines de IA com dados frescos
- Construir arquiteturas orientadas a eventos sem código customizado
O trigger gerencia checkpointing automaticamente via um lease container. Você precisa apontar para um existente ou configurar Create Lease Container como true — caso contrário, o trigger não dispara.
Operações CRUD e query completas
O conector fornece um conjunto completo de operações de documento:
| Ação | Descrição |
|---|---|
| Create or update item | Criar ou substituir um item (com upsert) |
| Create or update many items in bulk | Inserir ou atualizar vários itens em lote em uma única operação |
| Read an item | Leitura pontual por ID e partition key |
| Query items | Executar consultas SQL do Cosmos DB com parametrização completa |
| Patch an item | Atualizações parciais sem substituir o documento inteiro |
| Delete an item | Remover um documento por ID e partition key |
Cada operação retorna metadados detalhados como request charges, ETags para concorrência otimista, session tokens para consistência e activity IDs para diagnóstico.
Bulk operations
A ação "Create or update many items in bulk" foi projetada para ingestão de dados em alto volume. Seja carregando dados de sistemas externos, processando arquivos batch ou hidratando um container como parte de um pipeline de IA, as bulk operations permitem escrever muitos itens em uma única ação com throughput otimizado.
Operações de patch
A ação "Patch an item" permite atualizações parciais em documentos. Você modifica propriedades específicas sem ler e substituir o documento inteiro. Ideal para workflows que atualizam campos de status, adicionam itens a arrays ou incrementam contadores — evitando o overhead de um ciclo read-modify-write.
Como fica a autenticação com Microsoft Entra ID?
Organizações com políticas de segurança rigorosas agora podem autenticar no Azure Cosmos DB usando Microsoft Entra ID com managed identities, eliminando a dependência de chaves de acesso. O conector ainda suporta autenticação por connection string, mas o Entra ID oferece uma opção passwordless alinhada ao modelo zero-trust da Microsoft:
- Suporte a managed identities (system-assigned ou user-assigned) no Logic App.
- RBAC granular com as roles Cosmos DB Built-in Data Contributor e Data Reader.
- Sem secrets para rotacionar — adeus à sobrecarga operacional de gerenciar chaves.
Isso é especialmente relevante em ambientes corporativos brasileiros onde políticas de compliance (como LGPD) e arquiteturas de confiança zero exigem eliminar credenciais estáticas.
Cenários de IA e workflows inteligentes
A combinação do trigger de change feed, bulk operations e queries torna este conector um aliado natural para workflows com inteligência artificial.
Knowledge Base as a Service (KBaaS) para agentic workflows
O Azure Logic Apps recentemente introduziu o recurso Knowledge Base-as-a-Service, que usa o Azure Cosmos DB como data e vector store subjacente. Com KBaaS, você faz upload de documentos não estruturados (PDFs, Word, planilhas) e o serviço automaticamente faz parsing, chunking, sumarização e vetorização, armazenando tudo em containers do Cosmos DB com políticas de indexação já configuradas.
Quando um agente em um workflow agentic consulta a base de conhecimento, o serviço reescreve a query se necessário, gera um vector embedding, realiza uma busca semântica contra o Cosmos DB e retorna os chunks mais relevantes para o LLM gerar a resposta. É um pipeline RAG totalmente gerenciado, executado no ambiente do Logic Apps Standard, sem código customizado.
Pipelines de embedding customizados
Você também pode criar pipelines próprios de embedding que disparam quando novos documentos chegam no Cosmos DB. Use o trigger de change feed para detectar novos itens, chame um modelo de embedding (via Azure OpenAI connector ou HTTP action) e escreva o vector de volta no mesmo container ou em outro — tudo dentro de um único workflow do Logic Apps, sem código ou infraestrutura separada.
Ingestão de dados para RAG
Para aplicações RAG customizadas que exigem mais controle que o KBaaS oferece, use workflows do Logic Apps Standard para orquestrar todo o pipeline de preparação de dados:
- Ingestão de documentos de qualquer fonte (mais de 400 conectores)
- Transformação de conteúdo (chunking, limpeza, enriquecimento) com código inline ou serviços externos
- Embedding de texto usando Azure OpenAI ou outros endpoints
- Armazenamento de documentos com vectors no Azure Cosmos DB usando a ação de bulk upsert
Esse padrão se integra naturalmente com as capacidades de vector search e integrated embeddings do Azure Cosmos DB para cenários completos de IA.
Reações em tempo real com IA
Combine o trigger de change feed com serviços de IA para workflows que reagem de forma inteligente a mudanças nos dados:
- Um novo ticket de suporte chega, é resumido por um LLM e roteado para o time certo
- Uma avaliação de produto chega, passa por análise de sentimento, e avaliações negativas são sinalizadas para follow-up
- Um perfil de cliente é atualizado, recomendações são recalculadas e o cache de personalização é renovado
Consistência de sessão
O conector expõe session tokens como entrada e saída em cada operação, garantindo consistência no nível de sessão. Na prática, você pode ler suas próprias escritas dentro de um workflow passando o token de sessão retornado por uma ação de escrita para a próxima leitura ou query. Isso é crítico para workflows onde operações posteriores dependem de resultados anteriores dentro da mesma execução.
Saiba mais
📘 Azure Cosmos DB built-in connector reference
📘 Connect to Azure Cosmos DB from workflows in Azure Logic Apps
📘 Create Knowledge Bases for Agentic Workflows
📘 Azure Cosmos DB change feed
📘 Microsoft Entra ID authentication for the connector
Perguntas Frequentes
Qual a principal vantagem do conector built-in em relação ao managed connector?
O conector built-in executa in-process no runtime do Logic Apps Standard, eliminando o hop de rede para um serviço externo. Isso reduz drasticamente a latência, aumenta o throughput (sem throttling compartilhado) e permite funcionalidades como change feed trigger e bulk operations, que não existem no conector gerenciado.
Preciso criar um lease container para usar o change feed trigger?
Sim, o trigger de change feed exige um lease container para checkpoint. Você pode apontar para um existente ou definir a flag Create Lease Container como true para criação automática. O padrão é false, então sem essa configuração o trigger não dispara workflows.
Como funciona a autenticação com Microsoft Entra ID nesse conector?
O conector suporta autenticação via Entra ID com managed identities (system-assigned ou user-assigned), eliminando a necessidade de chaves de acesso. Basta atribuir as roles Cosmos DB Built-in Data Contributor ou Data Reader ao Logic App para acesso com privilégios mínimos — ideal para ambientes que exigem zero-trust e sem rotação de secrets.
Esse conector pode ser usado em pipelines de IA e RAG?
Sim. O trigger de change feed pode alimentar embeddings em tempo real, e as bulk operations permitem ingerir grandes volumes de dados vetorizados no Cosmos DB. Combinado com o Azure OpenAI connector, você constrói pipelines completos de RAG sem código customizado. A Microsoft também oferece Knowledge Base-as-a-Service (KBaaS) que usa o Cosmos DB como data store nativo.
Quais operações CRUD estão disponíveis no conector?
O conector oferece Create or update item (upsert), Create or update many items in bulk, Read an item (point-read por ID e partition key), Query items (SQL parametrizado), Patch an item (atualizações parciais) e Delete an item. Todas retornam metadados como request charges, ETags e session tokens para consistência.
Artigo originalmente publicado em Azure Updates - Latest from Azure Charts.
