Query Elenco Filtrato

Puoi filtrare i risultati della tua query. Negli esempi seguenti, abbiamo una tabella chiamata students, che contiene campi e relazioni come createdAt, firstName, email, age.

Utilizzo di Filtri nelle Query

Interroga un elenco di record filtrati. Nota l’argomento filter.

Richiesta

query MyQuery1 {
  students(
    filter: {
      createdAt: {
        gt: "2025-12-01T13:00:00.000Z"
      },
      email: {
        contains: "williams"
      }
    }
  ) {
    items {
      id
      createdAt
      firstName
      email
    }
  }
}

Risposta

{
  "data": {
    "students": {
      "items": [
        {
          "id": "97fb89ac-e0ad-44f5-b671-24a1b751287c",
          "createdAt": "2025-12-02T05:03:17.180675Z",
          "firstName": "John",
          "email": "john.williams@example.com"
        },
        {
          "id": "e25c4955-7ea7-4a83-a3de-d4c7427cc9fa",
          "createdAt": "2025-12-04T14:18:15.955194Z",
          "firstName": "Robert",
          "email": "robert.williams@example.com"
        }
      ]
    }
  }
}

Filtri Condizionali

I filtri condizionali utilizzano le chiavi AND e OR.

Utilizzo di AND

Quando viene specificato AND, tutti gli oggetti filtro devono restituire vero.

Richiesta

query MyQuery1 {
  students(
    filter: {
      AND: {
        email: {
          contains: "johnson"
        },
        isActive: {
          not_equals: false
        }
      }
      }
  ) {
    items {
      id
      createdAt
      firstName
      email
      isActive
    }
  }
}

Risposta

{
  "data": {
    "students": {
      "items": [
        {
          "id": "13fcb5bf-a8a4-4e55-860f-74f425944ec0",
          "createdAt": "2025-12-04T20:30:58.586321Z",
          "firstName": "Mary",
          "email": "mary.johnson@example.com",
          "isActive": true
        }
      ]
    }
  }
}

Utilizzo di OR

Quando viene specificato OR, almeno un oggetto filtro deve restituire vero.

Richiesta

query MyQuery1 {
  students(
    filter: {
      OR: {
        firstName: {
          equals: "Mary"
        },
        lastName: {
          equals: "Williams"
        }
      }
    }
  ) {
    items {
      id
      createdAt
      firstName
      email
      isActive
    }
  }
}

Risposta

{
  "data": {
    "students": {
      "items": [
        {
          "id": "429cf99f-4481-49c4-adb4-605731b20eb2",
          "createdAt": "2025-12-04T14:16:53.049955Z",
          "firstName": "Mary",
          "email": "mary.brown@example.com",
          "isActive": true
        },
        {
          "id": "97fb89ac-e0ad-44f5-b671-24a1b751287c",
          "createdAt": "2025-12-02T05:03:17.180675Z",
          "firstName": "John",
          "email": "john.williams@example.com",
          "isActive": true
        },
        {
          "id": "13fcb5bf-a8a4-4e55-860f-74f425944ec0",
          "createdAt": "2025-12-04T20:30:58.586321Z",
          "firstName": "Mary",
          "email": "mary.johnson@example.com",
          "isActive": true
        },
        {
          "id": "0174dc55-d494-4ebc-a0e9-13575461cad4",
          "createdAt": "2025-12-05T15:20:10.123456Z",
          "firstName": "Robert",
          "email": "robert.williams@example.com",
          "isActive": true
        }
      ]
    }
  }
}