Skip to content

Agregações SQL ​

Use expressões de agregação na lista de SELECT de db.query<T>. Declare cada campo de resultado em T com o tipo indicado abaixo e dê a cada expressão um alias explícito com AS que corresponda ao campo.

ExpressãoArgumentoCampo de resultado
COUNT(*) AS totalTodas as linhas correspondentestotal: i64
COUNT(column) AS totalValores presentes na colunatotal: i64
SUM(column) AS sumColuna i64 ou f64sum: i64? ou sum: f64?
AVG(column) AS averageColuna i64 ou f64average: f64?
MIN(column) AS minimumColuna i64, f64 ou stringTipo opcional da coluna
MAX(column) AS maximumColuna i64, f64 ou stringTipo opcional da coluna

COUNT(*) conta linhas; COUNT(column) conta linhas com valor nessa coluna. Ambos retornam 0 quando não há valores correspondentes. As demais agregações retornam um opcional vazio nesse caso; use ?? ou faça narrowing antes de usar o valor. Uma consulta de agregação sem GROUP BY retorna uma linha mesmo quando nenhuma linha de origem corresponde.

Exemplo ​

Este exemplo pressupõe que o snapshot local do schema contém db_examples(id: i64) e que o banco de dados em execução tem a mesma tabela.

tyrus
import { DbError, db } from "tyrus:db";

interface CountRow {
    total: i64;
}

interface StatsRow {
    sum: i64?;
    average: f64?;
    minimum: i64?;
    maximum: i64?;
}

interface GroupRow {
    groupId: i64;
    total: i64;
}

async function countExamples(): Promise<Result<CountRow[], DbError>> {
    const rows = await db.query<CountRow>("SELECT COUNT(*) AS total FROM db_examples", []) onfail {
        return Err(data);
    };
    return Ok(rows);
}

async function readStats(): Promise<Result<StatsRow[], DbError>> {
    const rows = await db.query<StatsRow>("""
        SELECT SUM(id) AS sum,
               AVG(id) AS average,
               MIN(id) AS minimum,
               MAX(id) AS maximum
        FROM db_examples
    """, []) onfail {
        return Err(data);
    };
    return Ok(rows);
}

async function listGroups(): Promise<Result<GroupRow[], DbError>> {
    const rows = await db.query<GroupRow>("SELECT id AS groupId, COUNT(*) AS total FROM db_examples GROUP BY groupId ORDER BY total DESC", []) onfail {
        return Err(data);
    };
    return Ok(rows);
}

É possível combinar várias agregações em um SELECT.

GROUP BY ​

Use GROUP BY para combinar colunas comuns e agregações. Toda coluna comum selecionada deve aparecer na lista de agrupamento, pelo nome da coluna, pelo nome qualificado ou pelo alias explícito de SELECT. SELECT * não é aceito com GROUP BY; liste as colunas de resultado explicitamente. HAVING filtra grupos após a agregação e pode se referir a colunas agrupadas ou aliases de agregação. Vincule valores por parâmetros ?. ORDER BY pode se referir a uma coluna agrupada ou a um alias de agregação. O resultado contém uma linha por grupo ou um array vazio se não houver grupos correspondentes.

Este exemplo retorna uma linha para cada valor de id:

tyrus
import { DbError, db } from "tyrus:db";

interface GroupRow {
    groupId: i64;
    total: i64;
}

async function listGroups(): Promise<Result<GroupRow[], DbError>> {
    const minimumTotal: i64 = 1;
    const rows = await db.query<GroupRow>("""
        SELECT id AS groupId, COUNT(*) AS total
        FROM db_examples
        GROUP BY groupId
        HAVING total > ?
        ORDER BY total DESC
    """, [minimumTotal]) onfail {
        return Err(data);
    };
    return Ok(rows);
}

O SQL deve ser um literal de string, e valores dinâmicos pertencem ao array separado de parâmetros.