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.

$sample (estágio de agregação )

$sample

Seleciona aleatoriamente o número especificado de documentos a partir dos documentos de entrada.

$sample sintaxe de estágio :

{ $sample: { size: <positive integer N> } }

N é o número de documentos para selecionar aleatoriamente. Defina N como um número inteiro maior ou igual a 1.

Se todas as seguintes condições forem verdadeiras, o $sample usará um cursor pseudoaleatório para selecionar os documentos N:

  • $sample é o primeiro estágio do pipeline.

  • N é inferior a 5% do total de documentos na coleção.

    Observação

    Você não pode configurar o limite que o $sample usa para determinar quando verificar a coleção inteira. O limite é 5%. Se o tamanho for maior que 5% do número total de documentos na coleção, o $sample realizará uma classificação top-k por um valor aleatório gerado. A classificação top-k pode transbordar para o disco se os documentos de amostra forem maiores que 100 MB.

  • A coleção contém mais de 100 documentos.

O cursor pseudoaleatório não oferece garantias de uma amostra aleatória uniforme. Ele seleciona documentos descendo a estrutura B-tree interna da coleção aleatoriamente, portanto, os resultados podem ser distorcidos em relação a algumas partes da coleção. A distorção é mais provável quando:

  • Os documentos na coleção não estão distribuídos uniformemente, o que leva a uma estrutura de árvore desequilibrada.

  • A coleção tem um alto número de documento excluir.

  • Um grande número de documentos não está visível para a transação do cursor.

Se o seu caso de uso exigir uma amostra uniforme, evite o cursor pseudoaleatório. Para fazer isso, execute $sample após outro estágio ou defina N como mais de 5% dos documento na coleção.

Se qualquer uma das condições anteriores for falsa, $sample:

  • Lê todos os documentos gerados de um estágio de agregação anterior ou de uma varredura de coleção.

  • Executa uma classificação aleatória para selecionar N documentos. As classificações aleatórias estão sujeitas às restrições de memória de classificação.

    Observação

    As visualizações são o resultado de pipelines de agregação. Quando você usa $sample em um modo de exibição, o MongoDB acrescenta o estágio ao final da sintaxe do pipeline de agregação do modo de exibição. Portanto, o estágio $sample em uma exibição nunca é o primeiro estágio e sempre resulta em uma varredura de coleção.

Se você usar $sample em um cluster fragmentado, cada fragmento executará a operação de amostra de forma independente. mongos faz uma amostra do resultado mesclado da operação de amostragem de cada fragmento e retorna o número solicitado de documentos.

O exemplo a seguir usa a coleção movies do conjunto de dados de amostra sample_mflix. Para obter detalhes sobre como carregar esse conjunto de dados em sua implantação, consulte Carregar o conjunto de dados de amostra.

A seguinte operação de agregação seleciona aleatoriamente 3 documentos da coleção movies:

db.movies.aggregate( [ { $sample: { size: 3 } }, { $project: { _id: 0, title: 1, year: 1, genres: 1 } } ])

A operação retorna três documentos aleatórios.

Avalie esta página