Wesloo
Alle ThemenThemen

Webtechnologien

GraphQL: Abfragesprache und Laufzeit für APIs

Kurze Antwort

GraphQL ist eine Abfragesprache und Laufzeit für APIs. Clients bestimmen, welche Felder und verknüpften Daten sie in einer Operation erhalten. Ein stark typisiertes Schema beschreibt die verfügbaren Typen, Felder und Operationen.

Das Wichtigste

  • Clients fordern nur die benötigten Felder an, statt fester Endpunkte.
  • Das Schema definiert Typen, Felder, Beziehungen und Operationen in der Schema Definition Language.
  • Queries lesen Daten, Mutationen ändern Daten, Subscriptions können Echtzeitupdates liefern.
  • Ein Server kann Daten aus mehreren Quellen in einem Graphen zusammenführen.
  • Fehler können neben Teildaten in der Antwort stehen.

Was ist GraphQL?

GraphQL ist eine Abfragesprache und eine Laufzeit für APIs. Ein GraphQL-Dienst legt fest, welche Fähigkeiten Clients nutzen dürfen. Der Client bestimmt die empfangenen Daten und fordert nur benötigte Felder an, anstatt feste Endpunkte mit vordefinierten Antworten zu nutzen. Die Antwort folgt der Struktur der Anfrage. GraphQL ist auf Frontend-Entwickler zugeschnitten, weil Abfragen die Struktur von Ansichten widerspiegeln können. Produkte arbeiten oft mit Ansichtshierarchien; GraphQL-Abfragen können diese nachbilden. Ein Server kann Daten aus getrennten Quellen zusammenführen und als einheitlichen Graphen ausgeben. Die Sprache hängt nicht von einer bestimmten Datenbank oder Speicherengine ab. Im Vergleich zu einer REST API wählt der Client die Felder selbst aus.

Wie funktioniert eine GraphQL-Abfrage?

Eine GraphQL-API basiert auf einem Schema. Das Schema definiert verfügbare Typen, Felder, Beziehungen und Operationen in der Schema Definition Language. Query ist ein erforderlicher Wurzeloperationstyp; Mutation und Subscription sind optional. Typen beschreiben Datenstrukturen und Werte, darunter skalare Typen, Objekttypen, Enums, Interfaces, Unions und Eingabeobjekte. Clients geben in einer Query genau die Felder an, die sie brauchen, auch verknüpfte Daten. Queries können Variablen enthalten, um Abfragen wiederverwendbar zu machen. Der Server führt die Abfrage aus und liefert eine Antwort, deren Struktur der Anfrage folgt.

Schema und Typen

Das Schema ist stark typisiert. Es legt fest, welche Daten und Operationen über die API verfügbar sind. Ein Ausrufezeichen bei einem Feld bedeutet, dass das Feld nicht null zurückgeben darf. Diese Typinformation hilft Clients und Werkzeugen, verfügbare Felder zu erkennen. GraphQL-APIs können sich selbst beschreiben; Clients und Werkzeuge können das Schema nach Typen und Fähigkeiten abfragen. Das macht die API zu einer Plattform für gemeinsame Werkzeuge und Client-Bibliotheken. Ein stark typisiertes Schema erinnert an die Frage, wie streng ein Typsystem Regeln durchsetzt, wie bei statischer und dynamischer Typisierung.

Queries, Mutationen und Subscriptions

Queries rufen Daten vom Server ab. Mutationen verändern Daten, etwa durch Erstellen, Aktualisieren oder Löschen von Datensätzen; wie sie wirken, hängt von der Serverimplementierung ab. Subscriptions können Echtzeitupdates liefern, wenn sie implementiert sind. Fragmente erlauben es, den Datenbedarf einer Komponente in ihrer Nähe zu definieren und in einer Abfrage zu erfüllen. Dadurch lassen sich Datenanforderungen modular organisieren. GraphQL nutzt deklarative Datenabfrage; wer sich für funktionale Programmierung interessiert, erkennt ähnliche Ideen.

Beispiel für Mutationen

Eine Mutation kann Operationen wie createBook, updateBook oder deleteBook definieren. Ein Buchtyp kann die Felder id, title und author enthalten. Die Operation createBook kann title und author als Pflichtangaben verlangen, während updateBook einzelne Felder optional lässt. deleteBook kann einen booleschen Wert zurückgeben. Diese Beispiele zeigen, wie Mutationen Datenänderungen über das Schema ausdrücken. Die konkrete Wirkung hängt von der Serverimplementierung ab.

GraphQL und REST im Vergleich

AspektGraphQLREST
DatenabrufClient wählt Felder und verknüpfte Daten in einer OperationOft feste Endpunkte mit vordefinierten Antworten
EndpunkteEin Endpunkt kann viele Abfragen bedienenMehrere Endpunkte für Ressourcen
TypsystemStark typisiertes SchemaTypen oft außerhalb der API definiert
EchtzeitSubscriptions möglich, wenn implementiertMeist separate Mechanismen

Vorteile für Frontend und Backend

GraphQL ist auf die Denkweise von Frontend-Entwicklern und die Struktur von Ansichten ausgerichtet. Abfragen spiegeln UI-Strukturen wider und ermöglichen eine natürliche Datenanfrage in der Form der Antwort. Clients bestimmen die empfangenen Daten und fordern nur das an, was sie auf Feldebene brauchen. Das kann überflüssige Daten reduzieren. Beispiel: Ein Client braucht einen Beitrag und Informationen zum Autor. Bei REST können dafür mehrere Anfragen nötig sein, wenn Beitrag und Autor über getrennte Endpunkte bereitstehen. GraphQL kann beides in einer Abfrage abrufen, wenn das Schema die Beziehung definiert. Die Antwort folgt der Struktur der angeforderten Felder.

Fragmente unterstützen Datenbedarfe nahe bei Komponenten. Ein Server kann Daten aus mehreren Quellen verarbeiten und als einheitlichen Graphen ausgeben. Das hilft, bestehende Systeme und Geschäftslogik in eine gemeinsame API-Struktur einzubinden. GraphQL läuft über HTTP; dabei spielen Methoden, Header, Statuscodes und Endpunktgestaltung eine Rolle. GraphQL ist eine Abfragesprache für APIs, keine allgemeine Programmiersprache; wer die Geschichte der Programmiersprachen betrachtet, sieht ähnliche Themen wie Typsysteme und Abstraktion.

Fehler, Governance und Betrieb

Wenn bei der Ausführung ein Fehler auftritt, kann die Antwort Teildaten und Fehlerdetails enthalten, je nach Fehler und Schema-Nullbarkeit. Für den Betrieb sind Schema-Governance und Prüfprozesse wichtig. Modelle für Schema-Eigentum und Governance können zentral, föderiert oder hybrid sein. Reviews und automatisierte Prüfungen helfen, das Schema konsistent, sicher und leicht weiterentwickelbar zu halten. Fehlerbehandlung kann top-level errors und errors-as-data unterscheiden; die Wahl hängt davon ab, ob ein Fehler außergewöhnlich oder erwartet ist.

Dateiuploads lassen sich in GraphQL als Mutationen kapseln. Das ist ein empfohlener Weg, Dateiverarbeitung in eine API einzubinden. Best Practices für Design und Betrieb umfassen graphbasiertes Denken, HTTP-Bereitstellung, Fehlerbehandlung und Schema-Governance.

Schema-Governance in der Praxis

Ein gesundes GraphQL-API beginnt mit einem gut gepflegten Schema. Teams können zentrale, föderierte oder hybride Modelle für Schema-Eigentum wählen. Reviews und automatisierte Prüfungen halten das Schema konsistent, sicher und leicht weiterentwickelbar, während das Team wächst. Graphbasiertes Denken hilft, das Schema an Geschäftslogik und bestehende Systeme auszurichten. Wer von RESTful-Endpunkten wechselt, sollte diese Ausrichtung bewusst planen. Dateiuploads werden als Mutationen gekapselt, damit Dateiverarbeitung Teil der API bleibt.

Wann ist GraphQL sinnvoll?

GraphQL ist sinnvoll, wenn Clients unterschiedliche Datenmengen benötigen und verknüpfte Daten in einer Anfrage abrufen sollen. Es passt zu Produkten mit komplexen Ansichtshierarchien und zu APIs, die sich über mehrere Datenquellen erstrecken. Ein stark typisiertes Schema hilft, verfügbare Operationen klar zu beschreiben. Wer von RESTful-Endpunkten zu graphbasiertem Denken wechselt, sollte das Schema an Geschäftslogik und bestehende Systeme anpassen. GraphQL ist keine Datenbank und keine Speicherengine, sondern eine Schicht für Abfrage und Manipulation von Daten.

Grenzen und Alternativen

GraphQL ist nicht für jeden Fall die beste Wahl. Wenn Clients einfache, gleichförmige Daten benötigen, können feste Endpunkte ausreichen. GraphQL bringt zusätzliche Komplexität durch Schema, Resolver und Governance mit. Die Vorteile zeigen sich besonders bei komplexen Ansichtshierarchien, unterschiedlichen Client-Anforderungen und mehreren Datenquellen. Ein stark typisiertes Schema und klare Fehlerbehandlung helfen, diese Komplexität zu beherrschen. Die Entscheidung sollte auf den Datenflüssen und Client-Bedürfnissen basieren.

Weitere häufige Fragen

Ist GraphQL eine Datenbank?

Nein. GraphQL ist eine Abfragesprache und Laufzeit für APIs. Sie ist nicht an eine bestimmte Datenbank oder Speicherengine gebunden.

Braucht GraphQL mehrere Endpunkte?

Nicht zwingend. Ein GraphQL-Endpunkt kann viele Abfragen bedienen, während Clients die gewünschten Felder selbst auswählen.

Was sind Mutationen in GraphQL?

Mutationen sind Operationen, die Daten verändern, etwa durch Erstellen, Aktualisieren oder Löschen von Datensätzen. Ihr Verhalten hängt von der Serverimplementierung ab.

Kann GraphQL Echtzeitupdates liefern?

Ja, wenn Subscriptions implementiert sind. Sie sind ein optionaler Wurzeloperationstyp im Schema.

Wie behandelt GraphQL Fehler?

Bei einem Fehler kann die Antwort Teildaten und Fehlerdetails enthalten, abhängig vom Fehler und der Nullbarkeit im Schema.

Verwandte Seiten

  • Client Side vs Server Side Rendering Unterschied

    SSR erzeugt das HTML auf dem Server, CSR im Browser. SSR kann erste Darstellung und Auffindbarkeit verbessern, CSR bietet mehr Interaktivität bei höherem Aufwand im Browser.

  • Was ist WebSocket? Protokoll und Anwendung

    WebSocket ist ein standardisiertes Netzwerkprotokoll, das eine dauerhafte, bidirektionale Verbindung zwischen Client und Server über einen einzelnen TCP-Kanal bereitstellt. Nach einem anfänglichen Handshake können beide Parteien jederzeit ohne erneute HTTP-Anfragen Daten austauschen. Das Protokoll eignet sich vor allem für Anwendungen mit hohem Bedarf an Datenübertragungen in Echtzeit bei minimaler Latenz.

  • Web-Cookies: Funktionsweise, Typen und Sicherheit

    Web-Cookies sind kompakte Textdateien, die ein Webserver über HTTP-Header an den Browser übermittelt, um die prinzipielle Zustandslosigkeit von HTTP auszugleichen. Der Browser speichert diese Datensätze lokal ab und sendet sie bei nachfolgenden Anfragen automatisch an denselben Host zurück. Auf diese Weise lassen sich Anmeldesitzungen, Spracheinstellungen und Warenkörbe zuverlässig aufrechterhalten.

  • Webcache: Funktionsweise, Typen und Cache-Control

    Ein Webcache speichert Kopien von Webressourcen lokal, damit wiederholte Aufrufe schneller laden und weniger Daten übertragen werden. Server steuern die Frische über HTTP-Header wie Cache-Control, während Browser alte Einträge bei Bedarf entfernen. Das Leeren hilft vor allem bei veralteten oder beschädigten Dateien, nicht bei Passwörtern oder Einstellungen.

  • Was ist CORS Policy? Grundlagen und Funktionsweise

    Mit CORS Policy legen Server über HTTP-Header fest, von welchen Origins ein Browser Ressourcen laden darf. Er erweitert die Same-Origin Policy kontrolliert und nutzt bei bestimmten Anfragen eine Preflight-Prüfung über OPTIONS. Falsche Konfigurationen können Sicherheitsrisiken erzeugen, besonders bei Anmeldedaten.

  • Was ist eine REST API Schnittstelle? Grundlagen

    Eine REST API ist eine besondere Form von API, die REST-Regeln über HTTP anwendet und mit Ressourcen arbeitet. Sie ist eine API, doch APIs können auch anderen Regeln folgen.

Wie diese Seite entstanden ist

Vor dem Schreiben wurde das Thema in den unten genannten Quellen recherchiert. Danach hat die Seite automatische Qualitätsprüfungen bestanden.

Einen Fehler auf dieser Seite melden