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.

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 => <array_path>,
 INDEX => <identifier>,
 OUTER => <bool>
)

Exemplo de desenrolar

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