GraphQL + App Sync: Working with Multiple Datasources
Zusammenfassung
Kurz
Der Bericht zeigt anhand einer AppSync-API mit drei DynamoDB-Tabellen, wie Pipeline Resolver Eingaben vor dem Anlegen einer Beziehung prüfen und feldgebundene Unit Resolver relationale Daten bei Bedarf nachladen können. Der Autor hält diesen Aufbau für wiederverwendbarer als das manuelle Zusammensetzen jeder Antwort und empfiehlt relationale Felder, die jeweils direkt aus einer Datenquelle auflösbar sind; systematische Leistungsvergleiche enthält der Artikel nicht.
Mittel
Der Artikel beschreibt, wie AWS AppSync GraphQL-Felder über mehrere DynamoDB-Tabellen hinweg auflösen kann. Das Beispiel umfasst Tabellen für Pokémon, Besitzer und ihre Viele-zu-viele-Zuordnungen.
Für das Anlegen einer Zuordnung empfiehlt der Autor einen Pipeline Resolver: Zwei Funktionen prüfen zunächst, ob Pokémon und Besitzer existieren, und speichern fehlende Datensätze beziehungsweise Fehler im `stash` des Kontexts. Eine letzte Funktion legt die Zuordnung nur bei erfolgreicher Prüfung an. Für Abfragen lädt ein Resolver zuerst den Hauptdatensatz; Resolver an relationalen Typfeldern holen bei Bedarf weitere Zuordnungen und Datensätze. Sie verwenden dafür laut Bericht `ctx.source`, also den Wert des übergeordneten Feldes. Sekundärindizes auf Pokémon- und Besitzer-ID sollen die Beispielabfragen per Query ermöglichen.
Der Autor meint, so könne AppSync relationale Felder nur dann auflösen, wenn sie in der GraphQL-Auswahl angefragt werden. Das erspare das manuelle Zusammensetzen jeder Antwort für jede Abfrage und Mutation. Er empfiehlt, relationale Felder direkt über jeweils einen Unit Resolver und eine Datenquelle abrufbar zu halten. Die Vorteile werden anhand von Beispielen erläutert, aber nicht durch systematische Leistungs- oder Vergleichsmessungen belegt.
Ausführlich lesen
Der Bericht erklärt anhand einer beispielhaften AWS-AppSync-API, wie sich GraphQL-Abfragen und Mutationen über mehrere Datenspeicher hinweg auflösen lassen. Als Beispiel dienen drei DynamoDB-Tabellen: Pokémon, Besitzer und eine Zuordnungstabelle für ihre Viele-zu-viele-Beziehung. Der Autor betont, dass sich die Idee seiner Ansicht nach auch auf andere Kombinationen von Datenquellen übertragen lässt.
Für eine Mutation, die eine Zuordnung anlegt, reicht laut Bericht ein einzelner Unit Resolver nicht aus, wenn vor dem Schreiben sowohl die Pokémon-ID als auch die Besitzer-ID geprüft werden sollen: Ein solcher Resolver ist jeweils an eine Datenquelle gebunden. Der Artikel empfiehlt dafür einen Pipeline Resolver. Dessen Vorverarbeitung legt Eingaben und Speicher für Validierungsfehler im `stash` des Kontexts ab. Zwei aufeinanderfolgende Funktionen lesen die jeweiligen Einträge aus den Tabellen und vermerken fehlende Datensätze. Eine abschließende Funktion bricht bei ungültigen Eingaben oder Validierungsfehlern mit einer Fehlermeldung ab und schreibt andernfalls die Zuordnung. Der Autor zeigt dazu Beispielcode und Testeingaben. Die Reihenfolge der beiden Prüfungen sei unerheblich; die Schreibfunktion müsse jedoch zuletzt ausgeführt werden.
Für Abfragen relationaler Daten schlägt der Bericht einen anderen Aufbau vor: Der Hauptresolver lädt zunächst nur den angefragten Pokémon- oder Besitzer-Datensatz. Resolver an einzelnen Typfeldern laden bei Bedarf anschließend die zugehörigen Zuordnungen und deren Pokémon- oder Besitzerinformationen aus weiteren Datenquellen. Dafür greifen sie laut Erklärung über `ctx.source` auf den Wert des übergeordneten Feldes zu. Für die Zuordnungstabelle empfiehlt der Autor je einen globalen sekundären Index auf Besitzer- und Pokémon-ID, damit die Beispiele die Einträge per Query statt per Scan mit Filter finden.
Der Autor stellt als Vorteil dar, dass AppSync die relationalen Felder entsprechend der angefragten GraphQL-Auswahl auflösen könne. Dadurch müsse man zusammengesetzte Ergebnisse nicht für jede Mutation und Abfrage erneut selbst zusammenbauen. Ein zuvor leerer `owner`-Wert bei der Mutation werde verfügbar, sobald der Feldresolver für `owner` eingerichtet sei; entsprechend könne eine Besitzerabfrage ohne zusätzlichen Resolveraufbau für jede Beziehung auch Pokémoninformationen liefern. Der Bericht führt Beispielabfragen und Ausgaben für diese Abläufe an.
Als Einschränkung empfiehlt der Autor, relationale Felder möglichst so zu modellieren, dass sie mit einem einzelnen Unit Resolver und einer Datenquelle abrufbar sind. Deshalb führt das Beispiel von einem Pokémon zunächst zu Zuordnungsdatensätzen und nicht direkt zu einer Liste von Besitzern. Der Artikel erklärt das Vorgehen an einem konkreten Schema und DynamoDB-Beispiel; er berichtet keine systematischen Leistungs- oder Vergleichsmessungen. Die Aussage, der feldweise Ansatz sei besser, ist ausdrücklich die persönliche Einschätzung des Autors.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Luna lieferte zwei Zusammenfassungen (kurz und mittel); beide wurden geprüft und sind inhaltlich weitgehend treu. Die Formulierung, AppSync könne relationale Felder nur dann auflösen, wenn sie angefragt werden, verschärft die Aussage des Berichts, der vom Entscheiden des Systems anhand der konkreten Abfrage spricht. Da keine Fragen zur Einordnung angegeben waren, ist die Einordnung leer.
Im Bericht, aber nicht in der Zusammenfassung
- Das Beispiel, dass das Feld owner in der Antwort von createRelation zunächst null liefert und nach dem Feld-Resolver korrekt gefüllt wird, fehlt in beiden Zusammenfassungen.
- Der Bericht beschreibt den Schemakreis Owner-Pokemon-Owner und entscheidet sich bewusst dafür, ihn zuzulassen; die Zusammenfassungen erwähnen dies nicht.
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.