[AWS×GraphQL] GraphQLでAWSLambdaをinvokeする feat.AWSAppSync

[AWS×GraphQL] GraphQLでAWSLambdaをinvokeする feat.AWSAppSync:

※この記事は GraphQL Advent Calendar 2018 21日目の記事です。

※この記事はAWS要素多めでお送り致しますので、ご了承ください。

はじめに

いきなりですが皆さんはAWSLambdaをどのようにinvokeしていますか？

AWSのサービスからinvokeするなら

• APIGateway
• KinesisDataStreams
• SNS
• IoTCore
• DynamoDBStreams

あたりでしょうか？

個人的にAPIGatewayからLambdaをinvokeするパターンが一般的なのかな？と思っています。

APIGatewayを立てればRESTFullにLambdaをinvokeすることができます。

それかAWSSDKから直接Lambdaをinvokeするっていうパターンもあると思います。

今回の主役

今回の主役は AWSAppSync です！

簡単に説明すると、AWSAppSyncとはGraphQLを利用して、他のAWSサービスと連携をすることができるサービスです。

今回の記事のようにLambdaをinvokeしたり、DynamoDBのデータを直接操作したりすることができます。

AWS利用している方で「GraphQL始めたいなー」って方にはおすすめです。

Lambdaの準備

今回の記事の内容から逸れてしまうので、この手順については省略します。

Lambdaのソースは何でもいいです。

AppSyncの設定をする前にデプロイしておいてください。

この記事で出てくるLambdaは、ランタイム Node.js 8.10です。

コードは以下の通り。 event の中身を出力して、 event.input を返すだけです。

exports.handler = async (event) => { 
  console.log(JSON.stringify(event)); 
  return event.input; 
}; 

AppSyncの設定

DataSourcesの追加

LambdaをAppSyncのDataSourcesとして追加する必要があります。

DataSourcesにはLambdaはもちろん、DynamoDBのテーブルなどを設定することができます。

DataSourcesは要するに、GraphQLのSchemaの定義をする際に、その処理の対象となるリソースのことを指します。

この処理はこのLambdaをinvokeする、この処理はこのDynamoDBのテーブルを操作するといった形です。

では追加していきましょう。

DateSourcesコンソール画面左上の「Create data source」から


必要項目を入力・選択して「Create」で追加完了です

Schemaの定義を書く

Schemaコンソール画面から下記を追加する

input InvokeLambdaFunctionInput { 
  id: String! 
  value: String! 
} 
 
type Mutation { 
  // Mutationの一番下の行に追加 
  invokeLambdaFunction(input: InvokeLambdaFunctionInput!): AWSJSON 
} 

Resolversの設定

先程追加したSchemaのDataSourceを選択します。ここでようやくLambdaと紐付ける形になります。

右ペインの「Resolvers」欄から「invokeLambdaFunction」の「Attach」を選択


「Data source name」で先程追加したDataSourceを選択。あとはデフォルトのまま「Save Resolver」を選択

これで準備が整いました

実際に試してみましょう

Queriesのコンソール画面から試すことができます。

左ペインに下記のように入力します。

mutation invoke { 
  invokeLambdaFunction (input: { 
    id: "test invoke" 
    value: "test desuyo !!!" 
  }) 
} 

オレンジの実行ボタンをクリックするとこのように返ってきます。

{ 
  "data": { 
    "invokeLambdaFunction": "{\"id\":\"test invoke\",\"value\":\"test desuyo !!!\"}" 
  } 
} 

"{\"id\":\"test invoke\",\"value\":\"test desuyo !!!\"}"　という型がAWSJSONという型になります。

実際に使う時はJSONに変換する必要があったりするのでご注意を。

さいごに

はい。これでGraphQLからLambdaをinvokeすることができました！やったね！！！

個人的にはAPIGatewayを立てる手間よりもAppSyncでやったほうが楽でした。AuthなどについてもAppSyncがAPIKey認証や、Cognito認証をするように設定することもできるので心配はないです。

WebアプリからAppSyncを使うには AWS Amplify がおすすめです。これを利用すると割と簡単にAppSyncで定義したGraphQLを利用することができます。

これでさらにLambdaが便利なものになりましたね！ではまた！！