Cloud Firestoreの発表

Firebaseの開発をしている、Googleは2017年10月にRealtimeDatabaseの次世代版「Cloud Firestore」を発表しました。
2017年12月現在のCloud Firestoreはベータ版ですが移行の方法を簡単ではありますが記しておこうと思います。

Cloud Firestoreそのものの理解を深めたい方は下記の記事を参考にするとよいでしょう。

RealtimeDatabase から Cloud Firestoreへの移行

プロジェクトに入り、Databaseを選択後「RealtimeDatabase」と選択されている箇所をクリックすると画像のように「Cloud Firestore」が選択肢として表示されます。

選択後は、画像のような画面が表示されますロックモード / テストモードというのは、権限のことです。
今回はテストモードを選択します。

もちろんこの時点で、RealtimeDatabaseが使えなくなることはありません。

接続 / イニシャライズ

RealtimeDatabaseのコード：

RealtimeDatabase

var config = {
  apiKey: "apiKey",
  authDomain: "projectId.firebaseapp.com"
};
firebase.initializeApp(config);
var db = firebase.database();

Cloud Firestoreのコード：

CloudFirestore

firebase.initializeApp({
  apiKey: '### FIREBASE API KEY ###',
  authDomain: '### FIREBASE AUTH DOMAIN ###',
  projectId: '### CLOUD FIRESTORE PROJECT ID ###'
});
var db = firebase.firestore();

解説

特に、大きな変更はないようです。
database を firestore に変更するのだけは忘れないようにしたいですね。

データの追加

RealtimeDatabaseのコード：

RealtimeDatabase

db.ref('hoge').set('fuga')

Cloud Firestoreのコード：

CloudFirestore

db.collection('hoge').add({fuga: 'piyo'})

解説

ここは結構な違いです。
RealtimeDatabaseにはcollectionというものがなかったので、画像のようにプロジェクト直下に値を入れることができました。

しかし、Firestoreは画像のようにドキュメントが追加され、IDを付与することが絶対になりました。
addをすれば、IDは自動生成されます。
たぶんこれはインデックスなどの関係でこうなったのだと思います。

1回のみのデータ取得

初回時などに1回だけデータを取る方法です。

RealtimeDatabaseのコード：

RealtimeDatabase

db.ref('hoge').once('value', (snapshot) => {
　　console.log(snapshot.val())
})
// fuga

Cloud Firestoreのコード：

CloudFirestore

this.db.collection('hoge').get().then((querySnapshot) => {
  querySnapshot.forEach((doc) => {
    console.log(`${doc.id} => ${doc.data()['fuga']}`)
  })
})
// QgG6SvUZABnU5Z7FfOrZ => piyo

解説

そもそもデータ構造が違うので、正確な比較はできませんがCloud Firestoreはコレクションに対して、get() メソッドを叩くとデータが取れます。その後Promiseでデータを好きなようにします。
ドキュメントのIDとその中のデータが取得できます。

また、 data.val() ではなく ddoc.data() になりました。

変更がある場合のみ取得 / リアルタイムに取得

RealtimeDatabaseのコード：

RealtimeDatabase

db.ref('hoge').on('child_changed', (data) => {
  console.log(data.val())
})

Cloud Firestoreのコード：

CloudFirestore

// 特定のドキュメントに対して
db.collection('hoge').doc('ID').onSnapshot((doc) => {
  console.log(doc.data())
})
// コレクションに対して
db.collection('hoge').onSnapshot((snapshot) => {
  console.log(snapshot.docChanges)
})

解説

Realtimedatabaseでは、 .on('child_changed'... という感じでしたがCloudStoreからは .onSnapshot((doc)... という形になりました。
また、特定のドキュメントに対しての変更だけを検知することも可能です。
もちろんコレクションに対しての監視も可能です。
dotChanges の中には簡単に書くとこんな感じのデータが入ってます

[
  { 
    "doc": "... //データが入ってます。",
    "newIndex": 0,
    "oldIndex": -1,
    "type": "added"
  }
]

注目してほしいのは、 type の部分です。ここには addedの他にも modified (変更） removed (削除)　があります。ここで変更があったデータはどんな変更だったのかなども検知することが可能です。

データの更新

RealtimeDatabaseのコード：

RealtimeDatabase

db.ref().update({'hoge': 'fugafuga'})

Cloud Firestoreのコード：

CloudFirestore

db.collection('hoge').doc('ID').update({
  fuga: 'piyopiyo'
})

解説

特にないです。普通にわかる感じですよね

データの削除

RealtimeDatabaseのコード：

RealtimeDatabase

db.ref('hoge').remove()

Cloud Firestoreのコード：

CloudFirestore

// 特定のドキュメントに対して
db.collection('hoge').doc('fuga').delete()

// 特定のフィールドに対して
var hogeRef = db.collection('hoge').doc('ID')
var hogeFuga = hogeRef.update({
    fuga: firebase.firestore.FieldValue.delete()
})

解説

特定のドキュメントに対しての削除は問題になりそうな箇所はありません。
特定のフィールドに対しての削除は、update を使って firebase.firestore.FieldValue.delete() メソッドを使用して、削除用の値に更新すると消えるようです。

特定のコレクションに対しては、削除するのには すべてのドキュメントを削除するしかないです。

最後に

今回の記事では、おもに基本的な機能を解説しましたがFirestoreにはクエリなどの機能が追加されています。

また、まだ英語ではありますがFirestoreのドキュメントもとても充実していてわかりやすいです。

ぜひ何か試してみたいと思ったら、ドキュメント見てみるのはいいことです。

あと思ったのは、RealtimeDatabaseのときにちゃんと書いてない人はCloudFirestoreへの移行大変そうですね

Firebase RealtimeDatabaseからCloud Firestoreへの移行

Cloud Firestoreの発表

RealtimeDatabase から Cloud Firestoreへの移行

接続 / イニシャライズ

解説

データの追加

解説

1回のみのデータ取得

解説

変更がある場合のみ取得 / リアルタイムに取得

解説

データの更新

解説

データの削除

解説

最後に