MongoDB Atlasの機能でGraphQLを設定

はじめに

MongoDB Atlasは、クラウドベースのフルマネージド型のデータベースサービスで様々な機能を持っている。そのなかに、GraphQL APIの機能があり、最小限の設定をしてみた。ここでは、GraphQL簡単な設定のみを行い、外部からのアクセスについては別に記載する。

GraphQLサービスの構築

まず、MongoDB Atlas上にアプリケーションを作成し、その後作成済みのDBとCollection(以下、WebCam)にたいしてGrpahQLの設定を行う。

アプリケーションの作成

MongoDB Atlas上にGraphQL用のアプリケーションを作成する。

1. 上部のメニューから「App Services」を選択。
   

2. 初めてアプリケーションを作成する場合、テンプレートを選択するポップアップ画面が表示されるので「Build your own App」を選択し、「next」を押下。(すでにアプリケーションを作成したことがある場合、ポップアップ画面は表示されない。)
   

3. 切り替わった画面において、以下の3項目を指定して「Create App Service」を押下

• 使用するデータソースをドロップダウンリストから選択
• アプリケーション名の記入
• デプロイモデルを選択
  ※アプリケーション名は、後から変更することができない。

1. 再度「App Services」を上部のメニューから選択すると、作成したアプリケーションが表示されているので、アプリ右上のボタンから「Change Environment」を選択してGraphQLの設定を行う。
   

GraphQLの設定

作成したアプリケーションにGraphQLの設定を行う。
作成済みのコレクションのデータのスキーマを作成したのちにデプロイを実施する。

スキーマの作成

MongoDB Atlasの機能で、Collectionに登録されているデータからスキーマを作成することができる。

1. 左側ペインのメニューからGraphQLのリンクを選択し、選択後、右側のペインに表示された「Generate JSON Schema」ボタンを押下
   

2. 切り替わった画面の真ん中のペインで、スキーマを作成するコレクションのリンクを選択(以下では、WebCam)。
   選択後、右側のペインに「Define a Schema」ボタンが表示されるのでボタンを押下する。
   

3. 切り替わった画面から、「Generate schema from sampling」を押下すると、登録されているデータをもとに、MongoDB Atlasの機能によりスキーマが生成される。
   

4. スキーマが作成されたのを確認して、「Save Draft」を押下。Draftの保存だけではアプリケーションに反映はされないので、以後のDeployが必要。
   

5. 画面上部の 「Review Draft & Deploy」ボタンを押下する
   

6. 表示されたポップアップ画面下部の「Deploy」ボタンを押下する。
   

デプロイに成功した場合、画面上部にメッセージが出力される。

設定の確認

左側ペインのメニューから再度GraphQLを選択する。

上部には、GraphQLのエンドポイントのURLが表示される。

また、queryのテスト画面が作成され、実際にGraphQL用のqueryを作成して実行することで結果を確認することができる。

おわりに

エンドポイントは作成されているものの、外部からのアクセスのためには、データアクセスのルールと認証の設定が必要。MongoDB Atlas自体は高機能だと思うがいろいろ機能がありすぎて使いこなせる気がしない。