Modificar Resultados da Query

Agrupar por valores de campo

Para agrupar resultados pelo valor de um ou mais campos, liste os campos na cláusula group by. Para agrupar por vários campos, separe os nomes dos campos com vírgula.

Este exemplo executa as seguintes operações:

• Recuperar documento que tenha um valor title de "Hairspray" da coleção sample_mflix.movies.

• Agrupa os filmes pelo campo year, o que retorna uma linha para cada ano de lançamento distinto.

• Classifica os resultados pelos seus valores year em ordem crescente.

var groupResult = session.createQuery(                "select year from Movie where title = :title group by year order by year",                Integer.class)        .setParameter("title", "Hairspray")        .getResultList();for (var year : groupResult) {    System.out.println("Year: " + year);}

Year: 1988Year: 2007

var groupResult = entityManager.createQuery(                "select m.year from Movie m where m.title = :title group by m.year order by m.year",                Integer.class)        .setParameter("title", "Hairspray")        .getResultList();for (var year : groupResult) {    System.out.println("Year: " + year);}

Year: 1988Year: 2007

A extensão Hibernate ORM traduz esta query para o seguinte pipeline. A cláusula where torna-se um estágio $match que executar antes do agrupamento. A cláusula order by torna-se um estágio $sort que classifica na chave de agrupamento:

[  { "$match": { "title": { "$eq": "Hairspray" } } },  { "$group": { "_id": { "year": "$year" } } },  { "$sort": { "_id.year": 1 } },  { "$project": { "_id#year": "$_id.year", "_id": 0 } }]

Agrupar por uma expressão computada

Uma chave de agrupamento pode ser uma expressão computada em vez de uma referência de campo. A extensão Hibernate ORM armazena a expressão em um subcampo _id gerado chamado k<n>. Quando você grava a mesma expressão na cláusula select ou having, a extensão Hibernate ORM a resolve para esse subcampo em vez de recalculá-la.

A extensão Hibernate ORM corresponde a uma expressão com uma chave de agrupamento apenas quando você grava as duas de forma idêntica. Por exemplo, uma chave de year + 1 não corresponde a uma ocorrência de 1 + year.

Você também pode ordenar por uma chave de expressão computada. Grave a expressão na cláusula order by exatamente como você a grava na cláusula group by.

O exemplo a seguir agrupa documentos que têm um title de "Hairspray" pela década em que foram lançados e classifica os resultados em ordem crescente:

var groupExpressionResult = session.createQuery(                "select year / 10 * 10 from Movie where title = :title group by year / 10 * 10 order by year / 10 * 10",                Integer.class)        .setParameter("title", "Hairspray")        .getResultList();for (var decade : groupExpressionResult) {    System.out.println("Decade: " + decade);}

Decade: 1980Decade: 2000

var groupExpressionResult = entityManager.createQuery(                "select m.year / 10 * 10 from Movie m where m.title = :title group by m.year / 10 * 10 order by m.year / 10 * 10",                Integer.class)        .setParameter("title", "Hairspray")        .getResultList();for (var decade : groupExpressionResult) {    System.out.println("Decade: " + decade);}

Decade: 1980Decade: 2000

A extensão Hibernate ORM traduz esta query para o seguinte pipeline, no qual os estágios $sort e $project lêem a chave de agrupamento de _id.k0 em vez de recalcular a expressão:

[  { "$match": { "title": { "$eq": "Hairspray" } } },  {    "$group": {      "_id": {        "k0": {          "$multiply": [            { "$toInt": { "$divide": [ "$year", 10 ] } },            10          ]        }      }    }  },  { "$sort": { "_id.k0": 1 } },  { "$project": { "#c_1": "$_id.k0", "_id": 0 } }]

Você também pode selecionar uma expressão calculada que contenha uma chave de agrupamento. Nesse caso, a extensão Hibernate ORM agrupa pela chave e calcula a expressão a partir da chave no estágio $project.

Para aprender mais sobre expressões computadas, consulte a seção Usar expressões computadas no guia Especificar uma query.

Filtro resultados agrupados

Para remover grupos dos resultados, use a cláusula having. A extensão Hibernate ORM usa a cláusula having para filtro na chave de agrupamento. Você pode combinar várias condições usando os operadores and e or.

Este exemplo executa as seguintes operações:

• Recupera os "Hairspray" filmes da coleção sample_mflix.movies.

• Agrupa os filmes pelo campo year, o que retorna uma linha para cada ano de lançamento distinto.

• Filtro os grupos para incluir apenas valores de year maiores que 2000.

• Classifique os resultados por ano em ordem crescente.

var havingResult = session.createQuery(                "select year from Movie where title = :title group by year having year > 2000 order by year",                Integer.class)        .setParameter("title", "Hairspray")        .getResultList();for (var year : havingResult) {    System.out.println("Year: " + year);}

Year: 2007

var havingResult = entityManager.createQuery(                "select m.year from Movie m where m.title = :title group by m.year having m.year > 2000 order by m.year",                Integer.class)        .setParameter("title", "Hairspray")        .getResultList();for (var year : havingResult) {    System.out.println("Year: " + year);}

Year: 2007

A extensão Hibernate ORM traduz esta query para o seguinte pipeline. A cláusula where torna-se um estágio $match que executar antes do agrupamento. A cláusula having torna-se um segundo estágio $match que executa após o agrupamento e os filtros na chave de agrupamento:

[  { "$match": { "title": { "$eq": "Hairspray" } } },  { "$group": { "_id": { "year": "$year" } } },  { "$match": { "_id.year": { "$gt": 2000 } } },  { "$sort": { "_id.year": 1 } },  { "$project": { "_id#year": "$_id.year", "_id": 0 } }]