Firestore

Introduction

Firestore은

• 백앤드, 프론트앤드에 모두 사용되는 유연한 NoSQL 클라우드 데이터베이스이다.
• Firebase와 Google Cloud을 기반으로 한다.
• Firebase Realtime Database와 같이 클라이언트 앱과 실시간 리스너를 동기화 해서 데이터를 제공한다

Firestore의 특징

유연성

Cloud Firestore은 유연하고 계층적인 데이터 구조를 제공한다. 데이터를 document에 저장하고, collection을 통해 조직화한다. 또한 nested한 형태 역시 저장 가능하다.

쿼리 표현

Cloud Firestore에서는 개별 혹은 모든 데이터를 쿼리를 통해 불러올 수 있다. 쿼리는 멀티플, 체인드 필터, 혼합 필터 그리고 정렬 기능을 사용할 수 있다. 

실시간 업데이트

Cloud Firestore은 Realtime Database와 같이 데이터를 업데이트 시키기 위해 데이터 동기화를 사용한다.

Firestore 동작방식

앞서 설명했듯이, Cloud Firestore은 클라우드 기반의 NoSQL 데이터베이스이다. firestore는 네이티브 SDKs를 통해 웹앱에 직접적으로 접근하며 여러 언어, 환경을 지원한다. SDKs를 통해 REST API를 사용할 수 있다.

 

Cloud Firestore의 데이터 모델에 따라, 사용자는 데이터의 값을 field에 매핑한 뒤 document에 저장한다. field는 document의 아래에 있다. document는 문자열, 숫자 그리고 여러 복잡한 nested 객체를 지원한다. 사용자는 또한 document 아래에 다른 subcollection을 두어 데이터를 계층적으로 관리할 수 있다. 이러한 특징은 나중에 커질 데이터베이스에 유동적으로 대처할 수 있도록 한다. 

Get Started

환경설정하기

Cloud Firestore을 사용하기 전에 먼저 Firebase를 통해 프로젝트를 생성한다. 웹앱에서는 npm을 통해 패키지로 SDKs를 관리할 수 있다. 그리고 아래 코드를 통해 firebase와 firestore를 import 하면 된다.

import { initializeApp } from "firebase/app";
import { getFirestore } from "firebase/firestore";

다음으로 Cloud Firestore의 인스턴스를 아래와 같이 초기화 한다.

// Initialize Cloud Firestore through Firebase
import { initializeApp } from "firebase/app"
import { getFirestore } from "firebase/firestore"
const firebaseApp = initializeApp({
  apiKey: '### FIREBASE API KEY ###',
  authDomain: '### FIREBASE AUTH DOMAIN ###',
  projectId: '### CLOUD FIRESTORE PROJECT ID ###'
});

const db = getFirestore();

데이터  추가하기

Cloud Firestore은 Collection 안에 있는 Documents에 데이터를 저장한다. 처음 Document를 생성하면 암시적으로 Collection이 생성된다. 아래 코드를 통해 직접 확인해 보자.

import { collection, addDoc } from "firebase/firestore"; 

try {
  const docRef = await addDoc(collection(db, "users"), {
    first: "Ada",
    last: "Lovelace",
    born: 1815
  });
  console.log("Document written with ID: ", docRef.id);
} catch (e) {
  console.error("Error adding document: ", e);
}

같은 Collection 아래에도 다른 데이터 형식을 갖는 document를 둘 수 있다.

데이터 삭제

"delete()"메서드를 사용해서 도큐먼트를 삭제할 수 있다.

import { doc, deleteDoc } from "firebase/firestore";

await deleteDoc(doc(db, "cities", "DC"));

사용자가 Cloud Firestore에서 document를 삭제할때 그 아래에 있는 subcollection은 자동으로 삭제되지 않는다. 레퍼런스로 지정해두었다면 해당 레퍼런스는 도큐먼트 삭제 이후에도 유효하다.

데이터 읽기

Cloud Firestore에서 데이터를 읽는 방법으로는 두 가지가 있다.

• 데이터를 get하는 매서드 호출하기
• 데이터 변경 이벤트를 수신하기 위한 리스너 설정하기

get매서드 사용하기

import { collection, getDocs } from "firebase/firestore"; 

const querySnapshot = await getDocs(collection(db, "users"));
querySnapshot.forEach((doc) => {
  console.log(`${doc.id} => ${doc.data()}`);
});

리스너 설정하기

import { onSnapshot, collection } from 'firebase/firestore';

  useEffect(() =>
    onSnapshot(collection(db, 'Debate'), (snapshot) => (
      setDebates(snapshot.docs.map(doc => {
        const res = Object.create(null);
        Object.assign(res, doc.data());
        res["id"] = doc.id;
        return res;
      }))
    ))
    , []);

onSnaphot()메서드를 사용해서 collection의 모든 document를 호출했다. 매서드의 첫 번째 인자로는 collection객체를 주고, 두 번째 인자에 return값 snapshot을 인자로 한 콜백함수를 전달한다.