GraphQLによるデータの挿入と取得

GraphQLによるデータの操作を行ってみましょう。

コンソールのトップ画面に戻ると、GraphiQL (GraphQLのプレイグラウンド、開発環境) を使ってGraphQL APIを実際に試すことが可能です。

データの挿入

まずGraphQLでデータを挿入してみます。ここでは例として pages テーブルに次のデータを書き込みます。

項目	説明	値
`content`	ページの本文	`{}` - 空のオブジェクト

GraphQL Queryとしては次のコードを書いて、▶ ボタンからリクエストを行います。

mutation MyMutation {
  insert_pages_one(object: {content: {}}) {
    id
    content
  }
}

サーバーにリクエストを発行しレスポンスボディとして得られたデータは、右側のパネルに表示されます。

問題なくデータが得られたでしょうか。別のデータも試してみましょう。

例として pages テーブルに次のデータを書き込みます。

項目	説明	値
`content`	ページの本文	`{hey: "hello!"}`

mutation MyMutation {
  insert_pages_one(object: {content: {hey: "hello!"}}) {
    id
    content
  }
}

レスポンスを見ると問題なく id (ページの識別子) が得られており、正しく割り当てられているようですね。問題なくテーブル内に書き込まれているようです。

実際にデータベースのテーブルに書き込まれていることを確認してみます。[Data Manager] > [View Database] > pages テーブルを選択すると[Browse Rows]パネルでテーブル内のデータを確認することが可能です。

先ほどのGraphQL Queryリクエストが問題なく発行され、正しくデータが書き込まれていますね。

続いて、pages テーブルのデータを取得してみます。

次のGraphQL Queryを書き、リクエストを行います。

query MyQuery {
  pages_by_pk(id: 2) {
    id
    content
  }
}

このとき、引数の id として、データに割り当てられた id を使います。

項目	説明	例
`id`	ページの識別子	`2`
`content`	ページの本文	`{hey: "hello!"}`

レスポンスを見ると、問題なく先ほど書き込まれたのテーブル内データが得られていますね。

このようにして、HasuraではGraphQLを使って簡単にデータベースのデータを操作できます。リクエストヘッダーに秘密鍵を与えれば、実際にGraphQL APIエンドポイントとして利用することもできます。

また、実際にはここで紹介した以外にもさまざまな操作を行うことが可能です。GraphiQLの[Explorer]パネルから実行可能な操作や型を参照してみると、実際の操作の参考になるかと思います。あるいは、右側の[Docs]パネルからGraphQLの型の詳細を参照してみてください。