Fazer query com instruções MongoSQL

Declaração SELECT

SELECT * FROM sessions;

O MongoSQL retorna todos os documentos da collection Sessions.

Declaração LIMIT

SELECT * FROM users LIMIT 2;

O MongoSQL retorna dois documentos da collection Users.

Declaração ONDE

SELECT * FROM users WHERE name = 'Jon Snow';

O MongoSQL retorna documentos da collection Users onde o name do usuário é Jon Snow.

Com palavra-chave

A palavra-chave WITH facilita a criação de fontes de dados derivadas para uso subsequente.

WITH RecentSales AS (
  SELECT customer_id, SUM(amount) AS total_sales
  FROM sales
  WHERE sale_date > '2025-01-01'
  GROUP BY customer_id
)
SELECT customer_id, total_sales
FROM RecentSales
WHERE total_sales > 1000;

O MongoSQL retorna documentos da collection Sales que tenham customer_id com vendas totais maiores que 1000 depois de 1 de janeiro de 2025.

achatar

FLATTEN nivela os dados semiestruturados (pares de nome-valor em formato JSON) em colunas separadas. Os nomes de campo se tornam nomes de coluna que contêm todos os valores desse campo em linhas.

A sintaxe para nivelar documentos aninhados é uma função FLATTEN que você pode usar na cláusula FROM com uma fonte de dados e opções.

SELECT *
FROM FLATTEN(<data source>
 WITH DEPTH => <integer>,
 SEPARATOR => <string>
)

Exemplo de nivelamento

Em um cenário de exemplo, uma coleção customerInfo contém documentos estruturados da seguinte maneira:

{
  id: 1,
  location: "New York",
  customer: {
    age: 50,
    email: "customer@email.com",
    satisfaction: 5
  }
}

Se você executar a query SELECT * FROM customerInfo, o MongoSQL retornará documentos com os seguintes campos de nível superior:

Se você executar a query SELECT * FROM FLATTEN(customerInfo), o MongoSQL retornará documentos com os seguintes campos de nível superior:

Quando você usa FLATTEN, cada campo nivelado do documento original se torna um campo de nível superior no conjunto de resultados. Os campos aninhados são concatenados com seus nomes de campo pai e separados pelo delimitador padrão, _.

Unwind

UNWIND desconstrói um campo de array da fonte de dados de entrada para gerar uma linha de saída para cada item nessa array. Para saber mais sobre unwind, consulte a documentação do estágio de agregação $unwind.

A sintaxe para desenrolar campos de array é uma função UNWIND que você pode usar na cláusula FROM com uma fonte de dados e opções.

SELECT *
FROM UNWIND(<data source>
 WITH PATH | PATHS => <array_paths>,
 INDEX => <identifier>,
 OUTER => <bool>
)

Exemplo de desenrolamento: campos de nível superior

Em um cenário de exemplo, uma coleção customerInfo contém documentos estruturados da seguinte maneira:

{
  id: 1,
  location: "New York",
  customer: {
    age: 50,
    email: "customer@email.com",
    satisfaction: 5
  },
  visits: [
    {
      year: 2020,
      score: 10
    },
    {
      year: 2021,
      score: 8
    },
    {
      year: 2022
      score: 7
    }
  ]
}

Se você executar a query SELECT * FROM customerInfo, o MongoSQL retornará documentos com os seguintes campos de nível superior:

Se você executar a query SELECT * FROM UNWIND(customerInfo WITH PATH => visits, INDEX => idx), o MongoSQL retornará documentos com os seguintes campos de nível superior:

Quando você usa UNWIND com PATH => visits, cada objeto visits se torna uma linha da tabela.

Exemplo de desenrolamento: arrays aninhadas e irmanadas

Em um cenário de exemplo, uma coleção customerInfo contém documentos estruturados da seguinte maneira:

{
  "id": 1,
  "location": "New York",
  "customer": {
    "age": 50,
    "email": "customer@email.com",
    "satisfaction": 5
  },
  "visits": [
    {
      "year": 2020,
      "score": 10
    },
    {
      "year": 2021,
      "score": 8
    },
    {
      "year": 2022,
      "score": 7
    }
  ],
  "purchases": [
    {
      "transaction": "1A",
      "transactions": [
        {
          "amount": 100
        },
        {
          "amount": 150
        }
      ]
    },
    {
      "transaction": "2B",
      "transactions": [
        {
          "amount": 200
        }
      ]
    }
  ]
}

Suponha que você execute a seguinte query:

SELECT
  visits.year AS visit_year, visits.score AS visit_score,
  purchases.transaction AS transaction_id,
  purchases.transactions.amount AS purchase_amount,
  visit_idx, purchase_idx,
  purchases_transactions_idx AS transaction_idx
FROM UNWIND(
  customerInfo WITH PATHS => (
    visits[OUTER => FALSE, INDEX => visit_idx],
    purchases[INDEX => purchase_idx].transactions[OUTER => FALSE]
  ),
  INDEX => idx,
  OUTER => TRUE
)

A query anterior faz o seguinte:

• Desenrola a array visits e atribui um nome de índice visit_idx para acompanhar a posição do índice dentro da array desenrolada. Não inclui visits ausente ou vazio configurando OUTER => FALSE.

• Desenrola a array purchases e desenrola a array transactions dentro de cada objeto purchases . Ele preserva qualquer array purchases ausente ou vazia usando OUTER => TRUE. Ele também atribui um nome de índice purchase_idx para rastrear a posição do índice dentro da array desenrolada purchases e um nome de índice purchases_transactions_idx para rastrear a posição dentro da array desenrolada transactions dentro de cada objeto purchases.

• Seleciona os subcampos year e score dos objetos visits, o subcampo transaction dos objetos purchases e o subcampo amount dos objetos transactions dentro de cada objetopurchases, e todos os campos de índice.

Na query anterior:

• OUTER => TRUE é definido como um parâmetro de nível superior para a fonte de dados UNWIND, tornando-o o valor padrão usado para todos os PATHS, a menos que o valor OUTER do nível do caminho seja diferente.

• INDEX => idx é definido como um parâmetro de nível superior para a fonte de dados UNWIND, tornando-o o valor padrão usado para todos os PATHS, a menos que o valor INDEX do nível do caminho seja diferente.

  Por exemplo, transactions não especificou um valor INDEX específico. Portanto, ele usa esse valor de nível superior para criar o nome do índice, anexando _idx ao caminho completo.

O MongoSQL retorna documentos com os seguintes campos:

Exemplo combinado de FLATTEN e UNwindd

O exemplo a seguir combina as funções FLATTEN e UNWIND.

Em um cenário de exemplo, uma coleção customerInfo contém documentos estruturados da seguinte maneira:

{
  id: 1,
  location: "New York",
  customer: {
    age: 50,
    email: "customer@email.com",
    satisfaction: 5
  },
  visits: [
    {
      year: 2020,
      score: 10
    },
    {
      year: 2021,
      score: 8
    },
    {
      year: 2022
      score: 7
    }
  ]
}

Se você executar a query SELECT * FROM customerInfo, o MongoSQL retornará documentos com os seguintes campos de nível superior:

Se você executar a query Select * from FLATTEN(UNWIND(customerInfo WITH PATH => visits, INDEX => idx)), o MongoSQL retornará documentos com os seguintes campos de nível superior:

Quando você usa as funções FLATTEN e UNWIND , a array visits é desenrolada e o documento resultante é achatado.