Modificar resultados de queries

Agrupar por valores de campo

Para agrupar los resultados por el valor de uno o más campos, enumere los campos en la cláusula group by. Para agrupar por varios campos, separe los nombres de los campos con comas.

Este ejemplo realiza las siguientes operaciones:

• Recupera documentos que tienen un valor title igual a "Hairspray" de la colección sample_mflix.movies.

• Agrupa las películas por el campo year, que devuelve una fila por cada año de lanzamiento distinto.

• Ordena los resultados por sus valores year en orden ascendente.

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: 1988
Year: 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: 1988
Year: 2007

La extensión Hibernate ORM traduce esta consulta al siguiente flujo de trabajo. La cláusula where se convierte en una etapa $match que se ejecuta antes de la agrupación. La cláusula order by se convierte en una etapa $sort que ordena según la clave de agrupación:

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

Agrupar por una expresión calculada

Una clave de agrupación puede ser una expresión calculada en lugar de una referencia de campo. La extensión Hibernate ORM almacena la expresión en un subcampo generado _id llamado k<n>. Cuando se escribe la misma expresión en la cláusula select o having, la extensión Hibernate ORM la resuelve a ese subcampo en lugar de recalcularla.

La extensión ORM de Hibernate asocia una expresión a una clave de agrupación solo cuando ambas se escriben de forma idéntica. Por ejemplo, una clave de year + 1 no coincide con una ocurrencia de 1 + year.

También puede ordenar por una clave de expresión calculada. Escriba la expresión en la cláusula order by exactamente como la escribió en la cláusula group by.

El siguiente ejemplo agrupa los documentos que tienen un title de "Hairspray" por la década en la que fueron publicados y ordena los resultados en orden ascendente:

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: 1980
Decade: 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: 1980
Decade: 2000

La extensión Hibernate ORM traduce esta consulta al siguiente flujo de trabajo, en el que las etapas $sort y $project leen la clave de agrupación de _id.k0 en lugar de recalcular la expresión:

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

También puede seleccionar una expresión calculada que contenga una clave de agrupación. En este caso, la extensión Hibernate ORM agrupa por la clave y calcula la expresión a partir de la clave en la etapa $project.

Para obtener más información sobre las expresiones calculadas, consulte la sección "Uso de expresiones calculadas" en la guía "Especificar una consulta".

Filtrar resultados agrupados

Para eliminar grupos de los resultados, utilice la cláusula having. La extensión Hibernate ORM utiliza la cláusula having para filtrar por la clave de agrupación. Puede combinar varias condiciones utilizando los operadores and y or.

Este ejemplo realiza las siguientes operaciones:

• Recupera las películas "Hairspray" de la colección sample_mflix.movies.

• Agrupa las películas por el campo year, que devuelve una fila por cada año de lanzamiento distinto.

• Filtra los grupos para incluir solo valores year mayores que 2000.

• Ordena los resultados por año en orden ascendente.

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

La extensión Hibernate ORM traduce esta consulta al siguiente flujo de procesamiento. La cláusula where se convierte en una etapa $match que se ejecuta antes de la agrupación. La cláusula having se convierte en una segunda etapa $match que se ejecuta después de la agrupación y filtra según la clave de agrupación:

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