Ordenar Consultas de Lista

Os resultados da sua consulta podem ser ordenados usando o argumento sort. A ordem de classificação (ascendente vs. descendente) é definida especificando ASC ou DESC para o nome do campo.

Nos exemplos a seguir, temos uma tabela chamada students, que contém campos e relações como createdAt, firstName, email.

Usando Classificação em Consultas

Aqui está uma consulta onde os resultados serão ordenados em ordem ascendente por data de criação.

Solicitação

query MyQuery1 {
  students(sort: [CREATEDAT]) {
    items {
      id
      createdAt
      firstName
      email
    }
  }
}

Resposta

{
  "data": {
    "students": {
      "items": [
        {
          "id": "287cff0a-345b-4cca-9e9a-75a2161238fd",
          "createdAt": "2025-12-02T05:01:31.054581Z",
          "firstName": "James",
          "email": "james.smith@example.com"
        },
        {
          "id": "97fb89ac-e0ad-44f5-b671-24a1b751287c",
          "createdAt": "2025-12-02T05:03:17.180675Z",
          "firstName": "John",
          "email": "john.williams@example.com"
        },
        {
          "id": "429cf99f-4481-49c4-adb4-605731b20eb2",
          "createdAt": "2025-12-04T14:16:53.049955Z",
          "firstName": "Mary",
          "email": "mary.brown@example.com"
        }
      ]
    }
  }
}

Classificação Aninhada e Multi-campo

Os resultados da sua consulta podem ser ordenados por atributos em tabelas relacionadas, bem como usando múltiplos objetos de classificação. Eles são classificados em prioridade pela ordem em que são recebidos.

Solicitação

query MyQuery1 {
  students(
    sort: [
      { firstName: ASC },
      { email: DESC }
    ]
  ) {
    items {
      id
      firstName
      email
    }
  }
}

Resposta

{
  "data": {
    "students": {
      "items": [
        {
          "id": "287cff0a-345b-4cca-9e9a-75a2161238fd",
          "firstName": "James",
          "email": "james.smith@example.com"
        },
        {
          "id": "97fb89ac-e0ad-44f5-b671-24a1b751287c",
          "firstName": "John",
          "email": "john.williams@example.com"
        },
        {
          "id": "429cf99f-4481-49c4-adb4-605731b20eb2",
          "firstName": "Mary",
          "email": "mary.brown@example.com"
        }
      ]
    }
  }
}