Conceito e mecanismo
Em Cosmos DB, partition key e id identificam um item no respetivo âmbito. Quando ambos são conhecidos, um point read pode evitar uma consulta geral. A escolha da chave deve considerar distribuição de carga e padrões de acesso.
Uma política de indexação ampla facilita consultas, mas acrescenta custo às escritas; remove caminhos apenas depois de verificar utilização e medir o efeito. Consistência Session oferece garantias dentro da sessão, com contexto que pode precisar de atravessar componentes.
Não é uma promessa de leitura globalmente forte. Para vetores, define modelo, dimensão, métrica e política de índice. Trocar o modelo de embeddings pode exigir reprocessamento e migração, mesmo que o restante documento mantenha a mesma estrutura.
Aplicação guiada
Num pipeline fictício que alimenta pesquisa de procedimentos, trata o change feed como um contrato de alterações. Latest version inclui creates e updates, pode omitir versões intermédias e não captura eliminações físicas. Se é necessário retirar documentos do índice, desenha marcador de eliminação com retenção suficiente ou um modo suportado adequado.
All versions and deletes tem requisitos próprios, incluindo continuous backup e compatibilidade de SDK. O processador nativo não está disponível de forma idêntica em todas as linguagens: Python pode usar opções suportadas de pull ou Functions conforme o modo.
Consumidores devem tolerar reprocessamento e reconciliar efeitos externos. Guarda contagens, atraso e falhas por etapa para que uma execução verde não esconda documentos antigos ainda recuperáveis.
Eliminar um documento na origem não remove a entrada derivada se o pipeline só observa latest version sem um desenho de eliminação.
Armadilhas comuns
RU disponível como consulta eficiente; sessão como todos os clientes; vetor como array intercambiável; change feed como todas as versões e deletes em qualquer SDK.
Tópicos relacionados: Containers, artefactos e revisões · PostgreSQL, vetores e cache · Mensagens, eventos e Functions
Define o contrato de acesso e de alterações antes de construir a sincronização.
Referências
- Latest-version and all-versions-and-deletes modes and SDK support · Microsoft documentation accessed 2026-09-30; AI-200 guide updated 2026-05-05
- Partition key and point-read identity · Microsoft documentation accessed 2026-09-30; AI-200 guide updated 2026-05-05
- Cosmos indexing policies and RU tradeoffs · Microsoft documentation accessed 2026-09-30; AI-200 guide updated 2026-05-05
- Consistency guarantees and tradeoffs · Microsoft documentation accessed 2026-09-30; AI-200 guide updated 2026-05-05
- Cosmos vector policies dimensions and distance · Microsoft documentation accessed 2026-09-30; AI-200 guide updated 2026-05-05
- Change feed processing and at-least-once delivery · Microsoft documentation accessed 2026-09-30; AI-200 guide updated 2026-05-05