※この記事は 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が便利なものになりましたね！ではまた！！

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