[Firebase] 컬렉션그룹 사용해보기(Firestore CollectionGroup)

안녕하세요 Foma👟 입니다!

 

오늘은 Firestore에서 여러 하위 컬렉션의 데이터를 받아올때 유용한 컬렉션 그룹에 대해서 알아보겠습니다.

 

바로 시작할게요~

---

컬렉션 그룹이란?

 

아이디가 같은 컬렉션을 모아놓은 컬렉션입니다.

 

예를 들면 User 컬렉션이 있고 하위 컬렉션으로 유저들의 리뷰를 관리하는 Review컬렉션이 있다고 가정할게요

 

User - user1 - Review

 

User - user2 - Review

 

...

 

등으로 유저마다 리뷰 하위 컬렉션 가지게 될 것입니다.

 

만약에 모든 유저들의 리뷰 정보를 가지고 오려면 어떻게 해야할까요?

 

보통 Firestore에서 데이터를 가져올땐 아래와 같이 정확한 데이터 경로를 입력해주어야 합니다.

 

이렇게 되면 유저들 수만큼 getDocuments 쿼리를 실행해야합니다.

 

Firestore.firestore().collection("User").document("user1").collection("Review").getDocuments...
Firestore.firestore().collection("User").document("user2").collection("Review").getDocuments...
Firestore.firestore().collection("User").document("user3").collection("Review").getDocuments...

 

이 때 필요한게 바로 컬렉션그룹입니다.

 

아래와 같이 데이터가 필요한 컬렉션들의 동일한 아이디를 적어주시고 쿼리를 실행하면

 

모든 유저들의 Review 정보를 가져올 수 있습니다.

 

Firestore.firestore().collectionGroup("Review").getDocuments ...

 

여기서 주의하실 점은 컬렉션 아이디가 중복되지 않게 사용해야 한다는 것입니다.

 

만약 사용자가 아닌 관리자도 리뷰가 있다고 가정하면 

 

Admin - admin1 - Review

 

Admin - admin2 - Review

 

...

가 있겠죠? 

 

여기서 컬렉션 그룹은 아이디가 동일한 모든 컬렉션의 정보를 가져와 버리기 때문에 사용자의 리뷰뿐만 아니라 관리자의 

 

리뷰까지도 모두 가져오게 되는 상황이 발생합니다.

 

고로 반드시 하위 컬렉션은 UserReview, AdminReview 등으로 중복되지 않게 생성해주어야 합니다.

---

색인생성

 

만약 리뷰 데이터를 시간순으로 혹은 특정 id를 가진 유저의 정보만 가져오도록 하고싶다면

 

아래와 같이 쿼리를 작성해야 하는데요.

 

   Firestore.firestore().collectionGroup("Review").order(by: "timeStamp",descending: true).whereField("uid", isEqualTo: "Foma").getDocuments {

 

이렇게 작성하기 위해 Firebase에서 미리 색인이라는 것을 생성해주어야 합니다.

 

Cloud Firestore의 3번째 탭에 있는 색인을 눌러서 이동하시면

 

아래와 같이 파란색 색인 추가 버튼이 있을거에요!

여기서 쿼리에 필요한 필드를 작성해주시고 아래에 쿼리 범위를 컬렉션 그룹으로 선택해주시고 색인을 만들어주세요!

 

(색인을 생성하는데 한 2~3분정도 소요되는 것 같아요)

 

 

여기서 주의하실 점은 uid가 동일한 유저를 찾는데 내림차순,오름차순으로 설정해야하나? 라고 생각하실 수 있습니다.

 

Firebase에서는 쿼리에 사용되는 필드라면 정렬이 필요하지 않더라도 설정을 해주어야 합니다.

 

또한 정렬이 아닌 필드를 반드시 먼저 작성해주어야 합니다.

 

(1번에 timeStamp,2번에 uid로 작성하시면 쿼리에서 에러를 발생합니다. 그 이유는 아직 찾지 못했습니다..ㅜ

 

혹시라도 아시는 분은 댓글로 알려주세요..)

 

이렇게 색인을 만들고 쿼리를 작성하면 하위 컬렉션을 Review로 가지고 있는 모든 데이터들을 

 

조건대로 가져올 수 있습니다.

---

오늘은 이렇게 Firestore의 컬렉션그룹을 사용하는 방법에 대해 간단하게 알아보았습니다.

 

혹시라도 궁금하신 점이나 틀린 점이 있다면 댓글로 알려주세요!