Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.
Alterar propriedades do stream
Visão geral
Use as definições de configuração a seguir para especificar pipelines de agregação para fluxos de mudança e preferências de leitura para cursores de fluxo de mudança ao trabalhar com o conector de origem MongoDB Kafka.
Descrição: Um array de pipeline de agregação para executar em seu fluxo de alterações. Você deve definir essa configuração para o documento do evento de fluxo de alterações, não para o campo fullDocument.
Padrão: "[]" Valores aceitos: fase do pipeline de agregação válido
change.stream.full.document
Tipo: string
Descrição: Determina quais valores seu fluxo de alterações retorna em operações de atualizar.
A configuração padrão retorna as diferenças entre o documento original e o documento atualizado.
A configuração updateLookup retorna as diferenças entre o documento original e o documento atualizado, bem como uma cópia de todo o documento atualizado em um ponto no tempo após a atualização.
A configuração whenAvailable retorna o documento atualizado, se disponível.
A configuração required retorna o documento atualizado e levanta um erro se ele não estiver disponível.
Esta configuração é obrigatória para mostrar updateDescription.disambiguatedPaths em eventos de atualização, o que esclarece alterações que envolvem campos ambíguos. Para aprender mais, consulte disambiguatedPaths.
Padrão: false Valores aceitos: true ou false
change.stream.full.document.before.change
Tipo: string
Descrição: Configura a pré-imagem do documento que seu fluxo de alterações retorna nas operações de atualização. A pré-imagem não está disponível para registros de origem publicados durante a cópia de dados existentes, e a configuração da pré-imagem não tem efeito sobre a cópia.
A configuração padrão suprime a pré-imagem do documento.
A configuração whenAvailable retorna a pré-imagem do documento se ela estiver disponível, antes de ser substituída, atualizada ou excluída.
A configuração required retorna a pré-imagem do documento e gera um erro se ela não estiver disponível.
Padrão: "" Valores aceitos: "" ou "whenAvailable" ou "required"
publish.full.document.only
Tipo: booleano
Descrição: Se deve retornar somente o campo fullDocument do documento de evento do fluxo de alterações produzido por qualquer evento de atualizar. O campo fullDocument contém a versão mais atual do documento atualizado. Para aprender mais sobre o campo fullDocument, consulte o Evento atualizar no manual do Servidor.
Quando definido como true, o conector substitui a configuração change.stream.full.document e a define como updateLookup para que o campo fullDocument contenha documentos atualizados.
Padrão: false Valores aceitos: true ou false
publish.full.document.only.tombstone.on.delete
Tipo: booleano
descrição: Se os eventos da lápide devem ser devolvidos quando os documentos são excluídos. Os eventos Tombstone contêm as chaves dos documentos a excluir com valores null. Esta configuração se aplica apenas quando publish.full.document.only é true.
padrão: false Valores aceitos: true ou false
change.stream.document.key.as.key
Tipo: booleano
descrição: Indica se o sistema deve usar a chave do documento para a chave do registro de origem se a chave do documento estiver presente.
Quando definido como true, o conector adiciona chaves dos documentos excluídos aos eventos de marca para exclusão. Quando definido como false, o conector usa o token de continuação como chave de origem para os eventos de marca para exclusão.
Padrão: true Valores aceitos: true ou false
agrupamento
Tipo: string
Descrição: Um JSON documento de agrupamento que especifica as regras de ordenação específicas do idioma que o MongoDB aplica aos documentos retornados pelo fluxo de alterações.
Padrão: "" Valores aceitos: um documento JSON de agrupamento válido
batch.size
Tipo: int
Descrição: O tamanho do lote do cursor do fluxo de alterações.
padrão: 0 Valores aceitos: um número inteiro
poll.await.time.ms
Tipo: long
Descrição: A quantidade máxima de tempo em milissegundos que o servidor aguarda por novas alterações de dados para relatar ao cursor do fluxo de alterações antes de retornar um lote vazio.
padrão: 5000 Valores aceitos: um número inteiro
poll.max.batch.size
Tipo: int
descrição: Número máximo de documentos a serem lidos em um único lote ao pesquisar um cursor de fluxo de alteração para novos dados. Você pode usar essa configuração para limitar a quantidade de dados armazenados internamente no conector.