ステップ 2: データモデルと実装の詳細を調べます

テーブル – DynamoDB では、テーブルは項目 (つまりレコード) の集合であり、各項目には、属性と呼ばれる名前と値のペアが集約されています。

この Tic-Tac-Toe の例では、アプリケーションは、Games テーブル内のすべてのゲームデータを保存します。アプリケーションはゲームごとにテーブルで 1 つの項目を作成し、すべてのゲームデータを属性として格納します。Tic-Tac-Toe ゲームでは最大 9 回の移動が可能です。DynamoDB テーブルは、プライマリキーのみが必須の属性である場合はスキーマを持たないので、アプリケーションは、ゲーム項目 ごとに異なる数の属性を格納できます。

Games テーブルには、文字列型の 1 つの属性 GameIdで構成されるシンプルなプライマリキーがあります。アプリケーションは各ゲームに一意の ID を割り当てます。DynamoDB でのプライマリキーの詳細については、「プライマリキー」を参照してください。

ユーザーが他のユーザーを招待して Tic-Tac-Toe ゲームを開始すると、アプリケーションは、次のようなゲームメタデータを保存する属性で、Games テーブルに新しい項目を作成します。

さらに、アプリケーションは StatusDate 連結属性を作成し、ゲームの初期状態を PENDING としてマークします。次のスクリーンショットに、DynamoDB コンソールに表示される項目の例を示します。

アプリケーションは、ゲームの進行に合わせて、ゲームで動きがあるたびに 1 つの属性をテーブルに追加します。属性名はボードの位置（TopLeft、BottomRight など）です。たとえば、動きには値 TopLeftの O 属性、値 TopRight の O 属性、および値 BottomRightの X 属性があるなどです。属性値は、動いたユーザーに応じて、O または X になります。たとえば、次のボードを考えてみます。

連結属性値 – StatusDate 属性が、連結値属性を示します。この手法では、ゲームのステータス（PENDING、IN_PROGRESS、FINISHED）および日付（最後の動き）を格納する個別の属性を作成する代わりに、IN_PROGRESS_2014-04-30 10:20:32 などの単一の属性としてそれらを組み合わせます。

次に、アプリケーションは、インデックスのソートキーとして StatusDate を指定して、セカンダリインデックスの作成で StatusDate 属性を使用します。StatusDate 連結値属性を使用する利点について、さらに次のインデックスの説明で示します。

グローバルセカンダリインデックス – テーブルのプライマリキー、GameId を使用すると、テーブルを効率的に照会してゲーム項目を検索できます。プライマリキー属性以外の属性でテーブルをクエリするため、DynamoDB ではセカンダリインデックスの作成をサポートしています。このサンプルアプリケーションでは、次の 2 つのセカンダリインデックスを構築します。

これらのインデックスは、グローバルセカンダリインデックスと呼ばれます。これは、インデックスのパーティションキーが、テーブルのプライマリキーで使用されるパーティションキー (GameId) とは同じでないためです。

両方のインデックスがソートキーとして StatusDate を指定することに注意してください。これを行うと、次のことが可能になります。

ホームページ – このページには、簡単なログイン、新しい tic-tac-toe ゲームを作成する [CREATE] (作成) ボタン、進行中のゲームのリスト、ゲームの履歴、およびアクティブな保留中のゲームの招待が表示されます。

ホームページは自動的に更新されません。リストを更新するには、ユーザーがページを更新する必要があります。

ゲームページ – このページには、ユーザーがプレイするための、tic-tac-toe グリッドが表示されます。

アプリケーションは、毎秒ゲームページを自動的に更新します。ブラウザの JavaScript が毎秒 Python ウェブサーバーを呼び出して、テーブルのゲーム項目が変更されたかどうかを Games テーブルに照会します。変更された場合、JavaScript はページ更新をトリガーし、更新されたボードがユーザーに表示されるようにします。

招待 – このリストには、ログインしているユーザーが受け入れを保留中の、他のユーザーからの最新の招待が最大 10 個表示されます。前のスクリーンショットで、user1 は user5 および user2 からの招待を保留中です。

進行中のゲーム – このリストには、進行中の最新のゲームが最大 10 個表示されます。これらは、ユーザーがアクティブに実行中のゲームで、そのステータスは IN_PROGRESS です。スクリーンショットでは、user1 は user3 および user4 と Tic-Tac-Toe ゲームをアクティブにプレイ中です。

最近の履歴 – このリストには、ユーザーが終了した最近のゲームが最大 10 個表示されます。そのステータスは FINISHED です。スクリーンショットに示したゲームで、user1 は以前に user2 とプレイしています。完了した各ゲームについて、ゲームの結果がリストに表示されます。

関数は、以下のキー値および比較演算子とともに使用する OpponentId-StatusDate-index インデックスを指定します。

OpponentId-StatusDate-index インデックスを使用して、ログインしているユーザーが招待されているゲーム、つまりログインしているユーザーが対戦相手であるゲームを取得します。

クエリは結果を 10 項目に制限します。

ユーザーによってホストされた進行中のゲーム

ユーザーが対戦相手となっている進行中のゲーム

この関数は Games インデックスを使用して HostId-StatusDate-index テーブルをクエリします。このインデックスのためにクエリは、プライマリキー値つまりパーティションキー (HostId) およびソートキー (StatusDate) の値と、比較演算子を指定します。

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

比較演算子の Python の構文に注意してください。

この関数は Games インデックスを使用して OpponentId-StatusDate-index テーブルをクエリします。

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

次に、この関数は 2 つのリストを組み合わせ、ソートし、最初の 0～10 項目について Game オブジェクトのリストを作成して、呼び出し元関数（インデックス）にリストを返します。

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

ユーザーは他のユーザーを招待してゲームを作成します。

この場合、ページはホストやゲームのステータスを PENDING としてユーザーに表示し、対戦相手が受け入れるのを待ちます。

ユーザーは、ホームページで保留中の招待の 1 つを受け入れます。

この場合、ページではユーザーは対戦相手として、ゲームのステータスは IN_PROGRESS として表示されます。

これにより、動きに固有の新しい属性が追加されます。

Turn 属性が、次の番のユーザーに更新されます。

この関数は、既存の項目に対する一定範囲の更新を実行するため、SDK for Python の update_item 関数を呼び出します。この関数は、DynamoDB の UpdateItem オペレーションにマッピングされます。詳細については、「UpdateItem」を参照してください。

Games テーブルのプライマリキー (ItemId)。

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

現在のユーザーの動きに固有の、追加する新しい属性とその値（例: TopLeft="X"）。

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

更新が実行されるために満たされる必要がある条件

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