Amazon Web Services ブログ
AWS AppSync と RDS Data API を使って Amazon Aurora MySQL データベース用の GraphQL API を構築する方法
AWS AppSync が、Data API で構成された Amazon Auroraクラスタ上で稼働している既存の MySQL や PostgreSQL データベースのテーブルに基づいて、GraphQL API を簡単に作成できるようになりました。既存のデータベース用の API を構築する場合、開発者は通常、テーブルを正確に表現するインターフェースを構築しなければなりませんが、これには時間がかかり、エラーが発生しやすいプロセスです。AppSync は、データベースを検出し、それに一致する GraphQL 型を生成できる新しいイントロスペクション機能によってこの問題を解決します。AppSync コンソールでは、この新機能を使用して、コードを記述することなく、わずか数ステップでデータベースからすぐに使用できる GraphQL API を生成できます。さらに、Amazon Relational Database Service (RDS) 用の JavaScript リゾルバにも改良が加えられており、新しい SQL タグ付きテンプレートと SQL ヘルパー関数により、リゾルバで SQL ステートメントを簡単に記述できるようになっています。
本記事では、API を即座に構築するために AWS コンソールでこの機能を使い始める方法を紹介し、JavaScript リゾルバで新しい RDS ユーティリティライブラリを使用する方法を紹介します。
注:このブログの機能は、RDS Data API をサポートする Amazon RDSデータベースを使用しています。Data API をサポートしていない MySQLや PostgreSQL データベースに接続するには、「既存の MySQL と PostgreSQL データベース用の GraphQL API の作成」を参照してください。
AppSync コンソールでの設定
AppSync の新しいイントロスペクション機能は、Data API で構成された Amazon Aurora クラスターで実行されている既存のデータベースで使用できます。例えば、以下のテーブルが定義された MySQL データベースがあり、API を提供したいとします。
AWS AppSync コンソールで、Create API をクリックし、GraphQL API で Start with an Amazon Aurora cluster を選択します。Next をクリックし、API に名前を付け、次の画面でデータベース情報を入力してイントロスペクションを開始します。
Aurora クラスタに Data API を設定し、データベースユーザーの認証情報を AWS Secrets Manager に保存しておく必要があります。このユーザーには、データベース、スキーマ、テーブルの設定を読み取る権限が必要です。設定の詳細については、Data API ドキュメントを参照してください。Secrets Manager のシークレットに対して GetSecretValue、クラスタに対して ExecuteStatement を実行する権限が必要です。また、自分のリソースでアクセスするために AppSync の権限を付与する必要があります。コンソールでロールを作成することもできますし、自分で用意することもできます。Import をクリックして、イントロスペクション処理を開始します。完了すると、検出されたテーブルは以下のように表示されます。
デフォルトでは、型名はテーブル名と同じですが、カスタマイズすることもできます。生成されるスキーマからテーブルを除外することもできます。以下のように型名を変更してください。
Conversation_Participants
→Participant
Conversations
→Conversation
Messages
→Message
Next をクリックし、Create queries, mutations, and subscriptions for all models を選択します。Next をクリックし、変更内容を確認して、Create API をクリックします。スキーマの作成を開始し、リゾルバをフィールドにアタッチします。これで、クエリエディタからデータベースとやり取りしたり、GraphQL API に接続するクライアントアプリケーションを構築したりできるようになります。API を使用するには、クエリエディタに向かいます。左側のメニューから Queries を選択します。まずは新しい会話 (Conversation) を作成しましょう。
これでデータベースに会話が追加されます。次にメッセージを追加しましょう。
AppSync のリアルタイム機能はすぐに使用できます。例えば、会話で新しいメッセージを聞くには、新しいタブまたはウィンドウでクエリエディタを開き、フォローサブスクリプションを入力します。
元の Queries タブで、別のメッセージを送信します。
2 つめのクエリエディタにサブスクリプションがトリガーされたことが表示されます。
自動生成されたリゾルバを編集し、必要に応じてカスタマイズすることができます。例えば、新しいメッセージが作成されるたびに API が ID を自動生成するように変更してみます。createMessage
リゾルバを以下のように更新します。
上のコードでは、2 つのリクエストをデータベースに送っています。1 つめは、指定された ULID (Universally Unique Lexicographically Sortable Identifier) で新しいメッセージを作成します。2 つめは挿入された行をフェッチしてデータベースからデータを返します。これは、MySQL を使用して作成されたばかりの行 (自動生成されたカラムと値を含む) を取得するときに便利なパターンです。レスポンスから 2つめのオブジェクト (インデックス1) を取得します。これは、私が送信した 2 つめのステートメント (doSelect
) の結果に対応します。
次に、スキーマの CreateMessageInput
Input を更新して、id
フィールドを削除します。
新しいメッセージを送信します。
生成されたIDでレスポンスが返ってきます。
いくつかのメッセージを追加したところで、会話メッセージをすべて選択してみましょう。例えば、ここでは created_at
タイムスタンプと sub
値でフィルタリングしています。
RDS の新しいユーティリティ関数の使用
RDS の新しいユーティリティを使用して、データベーステーブルを操作することができます。Conversation
型を変更して、participants
フィールドを追加してみましょう。このフィールドは、最近読まれたメッセージ (last_read_at
) に基づいて、最近アクティブになった会話参加者の ID を返します。
次に、@aws-appsync/utils/rds
が提供する select
ユーティリティ関数を使ってカスタム select 文を書くために、getConversation
リゾルバを更新します。
リゾルバでは、最大 2 つのステートメントをデータベースに送信することができるので、1 回の実行で会話 (Conversation) とその参加者を取得することができます。createMySQLStatement
関数は、MySQL ステートメントを適切にエスケープし、引用符で囲むリクエストを作成します。変更してみましょう。クエリエディタでクエリを実行します。
以下の結果が返ってきます。
カスタム SQL 文の作成
新しい SQL タグ付きテンプレートを使って独自の SQL 文を書くことができます。タグ付きテンプレートを使うと、テンプレート式を通して実行時に動的な値を受け入れる静的な SQL 文を書くことができます。会話要約クエリをスキーマに追加し、新しい Summary
型を追加してみましょう。
次に、getConversationSummary
にリゾルバをアタッチします。
ここでは、sql
タグ付きテンプレートを使って SQL 文を書いています。SQL タグ付きテンプレートを使うと、式によって動的な値のみを受け付ける静的なステートメントを書くことができます。式を通して渡された値は、プレースホルダを通して自動的にデータベースエンジンに送られます。また、since
引数がデータベースエンジンによって DATE
型として扱われることを示すために、型ヒントを使用しています。
変更を保存し、クエリを実行します。
以下の結果が返ってきます。
まとめ
Aurora クラスターで稼働している既存の MySQL データベースから AppSync GraphQL API を作成する手順を紹介しました。この記事では MySQL に焦点を当てましたが、PostgreSQL データベースでも同じことができます。ご自身のデータベースで始めるには、AppSync ドキュメントで Data API による RDS イントロスペクションの詳細をご覧ください。RDS 用の JavaScript リゾルバの新しいユーティリティの詳細については、JavaScript リゾルバのリファレンスを参照してください。ガイド付きの導入については、Aurora PostgreSQL with Data API のチュートリアルを参照してください。独自の JavaScript リゾルバを書き始めるには、@aws-appsync/utils パッケージの最新版をダウンロードまたは更新してください。
本記事は「Build a GraphQL API for your Amazon Aurora MySQL database using AWS AppSync and the RDS Data API」を翻訳したものです。