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ência: Latest-version and all-versions-and-deletes modes and SDK support · AI-200 current guide updated2026-05-05; Azure technical documentation2026-09-30