Fazer query com instruções Atlas SQL

Declaração SELECT

SELECT * FROM sessions;

O Atlas SQL retorna todos os documentos da collection Sessions.

Declaração LIMIT

SELECT * FROM users LIMIT 2;

O Atlas SQL retorna dois documentos da collection Users.

Declaração ONDE

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

O Atlas SQL 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 Atlas SQL retorna documentos da collection Sales que têm 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 pode ser usada na cláusula FROM em conjunto 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 Atlas SQL retornará documentos com os seguintes campos de nível superior:

Se você executar a query SELECT * FROM FLATTEN(customerInfo), o Atlas SQL 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 descompactar campos de array é uma função UNWIND que pode ser usada na cláusula FROM em conjunto 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 Atlas SQL 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 Atlas SQL 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 v.year AS visit_year, v.score AS visit_score, p.transaction AS transaction_id, t.amount AS purchase_amount
FROM UNWIND(
  customerInfo WITH PATHS => (
    visits[INDEX => visit_idx],
    purchases[OUTER => TRUE, INDEX => purchase_idx].transactions[]
  ),
  INDEX => idx,
  OUTER => FALSE
)

A query anterior faz o seguinte:

• Desenrola a array visits e atribui um nome de índice visit_idx para rastrear a posição do índice dentro da array desenrolada.

• Desenrola a array purchases e desenrola a array transactions dentro de cada objeto purchases . Ele também preserva qualquer compra com uma array transactions ausente ou vazia usando OUTER => TRUE.

O Atlas SQL retorna documentos com os seguintes campos:

Nos resultados, cada linha contém dados de uma única entrada visits e uma única entrada transactions.

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 Atlas SQL 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 Atlas SQL 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.