ソートリストクエリ

クエリの結果は、sort引数を使用して並べ替えることができます。並べ替え順序（昇順と降順）は、フィールド名にASCまたはDESCを指定することで設定されます。

以下の例では、createdAt、firstName、emailなどのフィールドとリレーションを持つstudentsというテーブルがあります。

クエリでの並べ替えの使用

ここでは、結果が作成日の昇順で並べ替えられるクエリを示します。

リクエスト

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

レスポンス

{
  "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"
        }
      ]
    }
  }
}

ネストされた並べ替えと複数フィールドの並べ替え

クエリの結果は、関連テーブルの属性や、複数のソートオブジェクトを使用して並べ替えることができます。これらは、受信された順序で優先順位付けされます。

リクエスト

レスポンス