Schritt 2: Überprüfen des Datenmodells und der Implementierungsdetails

Tabelle – In DynamoDB ist eine Tabelle eine Sammlung von Elementen (das bedeutet, Datensätzen) und jedes Element ist eine Sammlung von Name-Wert-Paaren, die Attribute genannt werden.

In diesem Tic-Tac-Toe Beispiel speichert die Anwendung alle Spieldaten in einer Tabelle. Games Die Anwendung erstellt pro Spiel ein Element in der Tabelle und speichert alle Spieldaten als Attribute. Ein tic-tac-toe Spiel kann bis zu neun Züge haben. Da DynamoDB-Tabellen über kein Schema in Fällen verfügen, in denen nur der Primärschlüssel das erforderliche Attribut ist, kann die Anwendung eine unterschiedliche Anzahl von Attributen pro Spiel speichern.

Die Tabelle Games verfügt über einen einfachen Primärschlüssel, der aus einem Attribut des Typs Zeichenfolge, GameId, besteht. Die Anwendung weist jedem Spiel eine eindeutige ID zu. Weitere Informationen zu DynamoDB-Primärschlüsseln finden Sie unter Primärschlüssel.

Wenn ein Benutzer ein tic-tac-toe Spiel startet, indem er einen anderen Benutzer zum Spielen einlädt, erstellt die Anwendung ein neues Element in der Games Tabelle mit Attributen, in denen Spielmetadaten gespeichert werden, wie z. B. die folgenden:

Zudem erstellt die Anwendung ein StatusDate-verkettetes Attribut, das den ersten Spielstatus als PENDING markiert. Der folgende Screenshot zeigt ein Beispielelement, wie es in der DynamoDB-Konsole angezeigt wird:

Während das Spiel voranschreitet, fügt die Anwendung der Tabelle ein Attribut für jeden Spielzug hinzu. Der Attributname ist die Brettposition, zum Beispiel TopLeft oder BottomRight. Ein Zug verfügt beispielsweise über ein TopLeft-Attribut mit dem Wert O, ein TopRight-Attribut mit dem Wert O und ein BottomRight-Attribut mit dem Wert X. Der Attributwert ist entweder O oder X, abhängig davon, welcher Benutzer den Zug gemacht hat. Betrachten Sie beispielsweise das folgende Board:

Verkettete Wertattribute – Das StatusDate-Attribut zeigt ein verkettetes Wertattribut. Anstatt bei diesem Ansatz getrennte Attribute zu erstellen, um den Spielstatus (PENDING, IN_PROGRESS und FINISHED) und das Datum (wann der letzte Zug erfolgte) zu speichern, kombinieren Sie sie als ein einzelnes Attribut. Zum Beispiel IN_PROGRESS_2014-04-30 10:20:32.

Die Anwendung nutzt dann das StatusDate-Attribut bei der Erstellung von sekundären Indizes, indem StatusDate als Sortierschlüssel für den Index angegeben wird. Der Vorteil eines StatusDate-verketteten Wertattributs wird in den Indizes, die im nächsten Abschnitt beschrieben werden, weiter dargestellt.

Globale sekundäre Indizes – Sie können den Primärschlüssel GameId der Tabelle nutzen, um die Tabelle effizient nach Spielelementen abzufragen. Um die Tabelle nach anderen Attributen als den Primärschlüsselattributen abzufragen, unterstützt DynamoDB die Erstellung von sekundären Indizes. In dieser Beispielanwendung erstellen Sie die folgenden zwei sekundären Indizes:

Diese Indizes werden globale sekundäre Indizes genannt, weil der Partitionsschlüssel in diesen Indizes nicht identisch mit dem Partitionsschlüssel (GameId) ist, der in dem Primärschlüssel der Tabelle verwendet wird.

Beachten Sie, dass beide Indizes StatusDate als Sortierschlüssel angeben. Dies ermöglicht Folgendes:

Startseite — Diese Seite bietet dem Benutzer eine einfache Anmeldung, eine CREATESchaltfläche zum Erstellen eines neuen tic-tac-toe Spiels, eine Liste der laufenden Spiele, den Spielverlauf und alle aktiven ausstehenden Spieleinladungen.

Die Homepage wird nicht automatisch aktualisiert. Sie müssen die Seite aktualisieren, um die Listen zu aktualisieren.

Spielseite — Auf dieser Seite wird das Spielfeld angezeigt tic-tac-toe, in dem die Nutzer spielen.

Die Anwendung aktualisiert automatisch die Spielseite im Sekundentakt. Der JavaScript in Ihrem Browser ruft jede Sekunde den Python-Webserver auf, um die Spieltabelle abzufragen, ob sich die Spielelemente in der Tabelle geändert haben. Wenn dies der Fall ist, JavaScript wird eine Seitenaktualisierung ausgelöst, sodass der Benutzer das aktualisierte Board sieht.

Einladungen – Die Liste zeigt bis zu zehn der letzten Einladungen von anderen an, die der angemeldete Benutzer noch nicht angenommen hat. Im vorherigen Screenshot hat Benutzer1 ausstehende Einladungen von Benutzer5 und Benutzer2.

Laufende Spiele – Diese Liste zeigt bis zu zehn der letzten Spiele an, die im Gange sind. Das sind Spiele, die der Benutzer aktiv spielt, die den Status IN_PROGRESS haben. Im Screenshot spielt Benutzer1 aktiv ein tic-tac-toe Spiel mit Benutzer3 und Benutzer4.

Aktueller Verlauf – Die Liste zeigt bis zu zehn der letzten Spiele an, die der Benutzer beendet hat, die den Status FINISHED haben. In dem im Screenshot gezeigten Spiel hat Benutzer1 zuvor mit Benutzer2 gespielt. Die Liste zeigt für jedes abgeschlossene Spiel die Spielergebnis an.

Sie gibt den Index OpponentId-StatusDate-index an, der mit den folgenden Indexschlüsselwerten und Vergleichsoperatoren verwendet wird:

Sie nutzen den OpponentId-StatusDate-index-Index, um Spiele abzurufen, für die der angemeldete Benutzer eingeladen ist – das bedeutet, in denen der angemeldete Benutzer der Gegner ist.

Die Abfrage begrenzt das Ergebnis auf zehn Elemente.

Laufende Spiele, die von dem Benutzer gehostet werden

Laufende Spiele, in denen der Benutzer der Gegner ist

Die Funktion fragt die Tabelle Games mithilfe des Index HostId-StatusDate-index ab. Die Abfrage gibt für den Index Primärschlüsselwert an – die Partitionsschlüssel- (HostId) und die Sortierschlüsselwerte (StatusDate), zusammen mit Vergleichsoperatoren.

hostGamesInProgress = self.cm.getGamesTable ().query(HostId__eq=user,
                                               StatusDate__beginswith=status,
                                               index="HostId-StatusDate-index",
                                               limit=10)

Beachten Sie die Python-Syntax für Vergleichsoperatoren:

Die Funktion fragt die Tabelle Games mithilfe des Index OpponentId-StatusDate-index ab.

oppGamesInProgress = self.cm.getGamesTable().query(Opponent__eq=user,
                                             StatusDate__beginswith=status,
                                             index="OpponentId-StatusDate-index",
                                             limit=10)

Die Funktion kombiniert dann die beiden Listen, sortiert sie und erstellt für die ersten 0 bis 10 Elemente eine Liste der Game-Objekte. Diese Liste gibt sie der aufrufenden Funktion (das bedeutet, dem Index) zurück.

games = self.mergeQueries(hostGamesInProgress,
                        oppGamesInProgress)
return games 

Der Benutzer erstellt ein Spiel, um einen anderen Benutzer zum Spielen einzuladen.

In diesem Fall zeigt die Seite den Benutzer als Host und den Spielstatus als PENDING an, während darauf gewartet wird, dass der Gegner akzeptiert.

Der Benutzer akzeptiert eine der ausstehenden Einladungen auf der Homepage.

In diesem Fall zeigt die Seite den Benutzer als Gegner und den Spielstatus als IN_PROGRESS an.

Sie fügt ein neues Attribut hinzu, das für den Zug spezifisch ist.

Sie aktualisiert den Attributwert Turn für den Benutzer, der an der Reihe ist.

Die Funktion ruft die update_item Funktion von SDK for Python auf, um eine endliche Menge von Aktualisierungen an einem vorhandenen Element vorzunehmen. Die Funktion wird der Operation UpdateItem in DynamoDB zugeordnet. Weitere Informationen finden Sie unter UpdateItem.

Den Primärschlüssel der Tabelle Games (d. h. ItemId).

key = { "GameId" : { "S" : gameId } }

Das neue hinzuzufügende Attribut, das für den aktuellen Benutzerzug spezifisch ist und sein Wert (zum Beispiel TopLeft="X").

attributeUpdates = {
    position : {
        "Action" : "PUT",
        "Value" : { "S" : representation }
    }
}

Bedingungen, die erfüllt sein müssen, damit die Aktualisierung ausgeführt werden kann:

expectations = {"StatusDate" : {"AttributeValueList": [{"S" : "IN_PROGRESS_"}],
    "ComparisonOperator": "BEGINS_WITH"},
    "Turn" : {"Value" : {"S" : current_player}},
    position : {"Exists" : False}}