【新技術】Firestoreにデータを書き込んでみよう　〜超基本〜

※　この漫画はフィクションです。実在の人物や団体などとは関係ありません。

　こんにちは！

　インテック3年目のモモです。

　私は一昨年の8月から、Flutter+Firebaseによるスマホアプリ📱開発を行っています。

　その経験を生かして、現在、Firebase(主にFirestore)の記事を連載しています！
　今回は、Firestoreからデータを取得する際のお作法について書いていきます！

↓こういった方向けです！👀

・Firebaseって流行っているけどなんだろう・・・？
・バックエンドを構築したいけど、楽な方法はないのかな？

とお考えの人。

　主に初心者向けですが、最終的には少し実践的な内容もお話ししていきたいと思うので、お楽しみに✨

　それでは、いきましょう〜〜〜！

前回の復習

Firestoreでは、コレクションとドキュメントという概念があります。
以下の図で現すように、keyとvalueのセットの一単位をドキュメント、ドキュメントの集合体をコレクションと言います。

Firestoreにデータ取得・書き込みをするにあたって、コレクション・ドキュメントの概念を押さえておくことはとても重要なので、押さえておきましょう！

Firestoreデータ取得の基本

Firestoreからデータ取得・書き込みは、基本的に

リファレンス　＋　命令

の基本構成で出来ています。
リファレンスとは、どこのデータを取得（書き込み）するか？　というように、データを取得する対象を指します。
命令とは、リファレンスに対して、どういったデータの操作を行うのかを指します。

命令には、代表的なものを抜粋すると、以下のようなものがあります。（説明は後ほど・・・）

• set：ドキュメントの追加、更新

• add：ドキュメントの追加

• get：ドキュメントの取得

• update：ドキュメントの更新

• delete：ドキュメントの削除

このように、Firestoreのデータ操作は、リファレンス＋命令　が基本構成です！

例えば、こんな社員コレクションがあったとします・・・

ミヤマルさんのドキュメントを取得したい！となった場合は、

リファレンス　→　社員コレクションのミヤマルさんのドキュメントID
命令　　　　　→　get()

を指定することで、ドキュメントを取得することが出来ます。

という声が聞こえてきそうなので、ドキュメントIDについては、前回の図を思い出してみましょう。
こちらは、モモのドキュメントを実際のFirestoreに入れた時のデータです。

下の赤枠の文字列がモモのドキュメントIDです！ドキュメントIDとは、ドキュメントを作成したときに自動的に生成されるランダムな文字列です。

このように、ドキュメントIDとは、ドキュメントに与えられた一意の文字列を指します。

では、社員コレクションの動物のデータ全員欲しい！となった場合は、どうでしょう？
この場合、

リファレンス　→　社員コレクション
命令　　　　　→　get()

となります

ではでは、このコレクションに、後輩のユウカちゃんを入れたい場合は？

この場合は、

リファレンス　→　社員コレクション
命令　　　　　→　add()

または

リファレンス　→　社員コレクションの空白のドキュメント
命令　　　　　→　set()

で追加することが出来ます。

add()とset()はどちらも追加メソッドでありますが、違いは、

add()　→ ドキュメントIDを指定できない（addメソッドが完了した後に、ドキュメントIDを取得できる）
set()　→　ドキュメントIDを指定できる

使い分けとしては、
システムの中で、ドキュメントIDを指定したい場合、または、ドキュメントIDを前もって取得したい場合には、set()
ドキュメントIDを前もって利用する必要がない場合には、add()
がよく使われます。

ということで、新生社員コレクションができました〜！

いかがだったでしょうか？

ここまでのまとめです。

Firestoreのデータ操作の基本
リファレンス　＋　命令
リファレンス：どこのデータを取得（書き込み）するか
命令　　　　：set、add、get、update、delete

次回は、実際の言語を利用して、Firestoreのデータ操作をより詳しく解説していこうと思います！お楽しみに！

※ 記載されている会社名、製品名は、各社の登録商標または商標です。