$shift (agregação)

Nesta página

Definição

Comportamento
Exemplos

Definição

Novidades na versão 5.0.

$shift

Retorna o valor de umaexpressã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
saída	Especifica uma expressão para avaliar e retornar na saída.
por	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.
default	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.

Comportamento

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

Exemplos

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.

Deslocar Usando um Inteiro Positivo

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" }

Deslocar Usando um Número Inteiro Negativo

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 }

Voltar

$setUnion

$size