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.

$shift (operador de expressão )

Novidade na versão 5.0.

$shift

Retorna o valor de uma expressão aplicada a um documento em uma posição especificada em relação ao documento atual na $setWindowFields partição de estágio .

O valor $setWindowFields do campo sortBy do estágio determina a ordem do documento. Para obter mais informações sobre como o MongoDB compara campos com tipos diferentes, consulte Ordem de comparação de BSON.

$shift está disponível somente no estágio $setWindowFields.

$shift sintaxe:

{ $shift: { output: <output expression>, by: <integer>, default: <default expression> }}

$shift pega um documento com estes campos:

Campo
Descrição

Especifica uma expressão para avaliar e retornar na saída.

Especifica um integer com uma posição numérica de documento relativa ao documento atual na saída.

Por exemplo:

  • 1 especifica a posição do documento após o documento atual.

  • -1 especifica a posição do documento antes do documento atual.

  • -2 especifica a posição do documento, que é duas posições antes do documento atual.

Especifica uma expressão padrão opcional para avaliar se a posição do documento está fora da $setWindowFields janela de estágio implícita . A janela implícita contém todos os documentos na partição.

A expressão padrão deve avaliar para um valor constante.

Se você não especificar uma expressão padrão , $shift retornará null para documentos cujas posições estão fora da janela de estágio $setWindowFields implícita.

$shift retorna um erro se você especificar uma janela no estágio $setWindowFields .

Crie uma collection cakeSales que contenha vendas de bolo nos estados da Califórnia (CA) e de Washington (WA):

db.cakeSales.insertMany( [ { _id: 0, type: "chocolate", orderDate: new Date("2020-05-18T14:10:30Z"), state: "CA", price: 13, quantity: 120 }, { _id: 1, type: "chocolate", orderDate: new Date("2021-03-20T11:30:05Z"), state: "WA", price: 14, quantity: 140 }, { _id: 2, type: "vanilla", orderDate: new Date("2021-01-11T06:31:15Z"), state: "CA", price: 12, quantity: 145 }, { _id: 3, type: "vanilla", orderDate: new Date("2020-02-08T13:13:23Z"), state: "WA", price: 13, quantity: 104 }, { _id: 4, type: "strawberry", orderDate: new Date("2019-05-18T16:09:01Z"), state: "CA", price: 41, quantity: 162 }, { _id: 5, type: "strawberry", orderDate: new Date("2019-01-08T06:12:03Z"), state: "WA", price: 43, quantity: 134 }] )

A coleção cakeSales é utilizada nos seguintes exemplos.

Este exemplo usa $shift no estágio $setWindowFields para gerar o quantity das vendas de bolo de cada documento, seguindo o documento atual para cada state:

db.cakeSales.aggregate( [ { $setWindowFields: { partitionBy: "$state", sortBy: { quantity: -1 }, output: { shiftQuantityForState: { $shift: { output: "$quantity", by: 1, default: "Not available" } } } } }] )

No exemplo:

  • partitionBy: "$state" particiona os documentos na collection por state. Existem partições para CA e WA.

  • sortBy: { quantity: -1 } ordena os documentos em cada partição por quantity em ordem decrescente (-1), de modo que o quantity mais alto seja o primeiro.

  • output depois de sortBy:

    • Define o campo shiftQuantityForState para o valor quantity dos documentos em cada state.

    • Usa $shift para retornar o valor quantity do documento que segue o documento atual na saída.

      • A posição do documento é especificada usando $shift por integer definido como 1.

      • Para documentos fora da janela implícita, $shift retorna "Not available", que é especificado usando a expressão padrão .

Neste exemplo de resultado, o valor quantity deslocado é mostrado no campo shiftQuantityForState para cada documento retornado:

{ "_id" : 4, "type" : "strawberry", "orderDate" : ISODate("2019-05-18T16:09:01Z"), "state" : "CA", "price" : 41, "quantity" : 162, "shiftQuantityForState" : 145 }{ "_id" : 2, "type" : "vanilla", "orderDate" : ISODate("2021-01-11T06:31:15Z"), "state" : "CA", "price" : 12, "quantity" : 145, "shiftQuantityForState" : 120 }{ "_id" : 0, "type" : "chocolate", "orderDate" : ISODate("2020-05-18T14:10:30Z"), "state" : "CA", "price" : 13, "quantity" : 120, "shiftQuantityForState" : "Not available" }{ "_id" : 1, "type" : "chocolate", "orderDate" : ISODate("2021-03-20T11:30:05Z"), "state" : "WA", "price" : 14, "quantity" : 140, "shiftQuantityForState" : 134 }{ "_id" : 5, "type" : "strawberry", "orderDate" : ISODate("2019-01-08T06:12:03Z"), "state" : "WA", "price" : 43, "quantity" : 134, "shiftQuantityForState" : 104 }{ "_id" : 3, "type" : "vanilla", "orderDate" : ISODate("2020-02-08T13:13:23Z"), "state" : "WA", "price" : 13, "quantity" : 104, "shiftQuantityForState" : "Not available" }

Este exemplo usa $shift no estágio $setWindowFields para gerar o quantity das vendas de bolo de cada documento antes do documento atual para cada state:

db.cakeSales.aggregate( [ { $setWindowFields: { partitionBy: "$state", sortBy: { quantity: -1 }, output: { shiftQuantityForState: { $shift: { output: "$quantity", by: -1, default: "Not available" } } } } }] )

No exemplo:

  • partitionBy: "$state" particiona os documentos na collection por state. Existem partições para CA e WA.

  • sortBy: { quantity: -1 } ordena os documentos em cada partição por quantity em ordem decrescente (-1), de modo que o quantity mais alto seja o primeiro.

  • output depois de sortBy:

    • Define o campo shiftQuantityForState para o valor quantity dos documentos em cada state.

    • Usa $shift para retornar o valor quantity do documento antes do documento atual na saída.

      • A posição do documento é especificada usando $shift por integer definido como -1.

      • Para documentos fora da janela implícita, $shift retorna "Not available", que é especificado usando a expressão padrão .

Neste exemplo de resultado, o valor quantity deslocado é mostrado no campo shiftQuantityForState para cada documento retornado:

{ "_id" : 4, "type" : "strawberry", "orderDate" : ISODate("2019-05-18T16:09:01Z"), "state" : "CA", "price" : 41, "quantity" : 162, "shiftQuantityForState" : "Not available" }{ "_id" : 2, "type" : "vanilla", "orderDate" : ISODate("2021-01-11T06:31:15Z"), "state" : "CA", "price" : 12, "quantity" : 145, "shiftQuantityForState" : 162 }{ "_id" : 0, "type" : "chocolate", "orderDate" : ISODate("2020-05-18T14:10:30Z"), "state" : "CA", "price" : 13, "quantity" : 120, "shiftQuantityForState" : 145 }{ "_id" : 1, "type" : "chocolate", "orderDate" : ISODate("2021-03-20T11:30:05Z"), "state" : "WA", "price" : 14, "quantity" : 140, "shiftQuantityForState" : "Not available" }{ "_id" : 5, "type" : "strawberry", "orderDate" : ISODate("2019-01-08T06:12:03Z"), "state" : "WA", "price" : 43, "quantity" : 134, "shiftQuantityForState" : 140 }{ "_id" : 3, "type" : "vanilla", "orderDate" : ISODate("2020-02-08T13:13:23Z"), "state" : "WA", "price" : 13, "quantity" : 104, "shiftQuantityForState" : 134 }
Avalie esta página