Firebase Console에서 Cloud Firestore 관리

Firebase Console을 사용하면 Cloud Firestore에서 다음 작업을 수행할 수 있습니다.

  • 데이터 보기, 추가, 편집, 삭제
  • Cloud Firestore 보안 규칙 만들기 및 업데이트
  • 색인 관리
  • 사용량 모니터링

데이터 보기

Firebase Console에서 모든 Cloud Firestore 데이터를 볼 수 있습니다. Cloud Firestore 데이터에서 문서나 컬렉션을 클릭하여 해당 항목에서 중첩된 데이터를 엽니다.

특정 경로 열기

특정 경로의 문서나 컬렉션을 열려면 경로 수정 버튼 를 사용하세요.

경로 편집 버튼을 클릭하여 특정 문서 또는 컬렉션 열기

컬렉션의 문서 필터링

컬렉션에 나열된 문서를 필터링하려면 필터 목록 버튼 를 사용하세요.

필터 목록 버튼을 클릭하여 나열된 문서 필터링

존재하지 않는 상위 문서

하나 이상의 상위 문서가 없는 경우에도 문서는 존재할 수 있습니다. 예를 들어 /mycoll/mydoc/mysubcoll/mysubdoc 경로에 있는 문서는 상위 문서 /mycoll/mydoc가 없는 경우에도 존재할 수 있습니다. Cloud Firestore 데이터 뷰어에는 다음과 같이 존재하지 않는 상위 문서가 표시됩니다.

  • 컬렉션의 문서 목록에서 존재하지 않는 상위 문서의 문서 ID는 기울임꼴로 표시됩니다.
  • 존재하지 않는 상위 문서 정보 패널의 데이터 뷰어에 문서가 존재하지 않는다고 표시됩니다.

Console에 존재하지 않는 상위 문서

데이터 쿼리

Cloud Firestore 데이터 페이지의 쿼리 빌더 탭에서 문서를 쿼리할 수 있습니다.

  1. Cloud Firestore 데이터 페이지로 이동

  2. 쿼리 빌더 탭을 클릭합니다.

  3. 쿼리 범위를 선택합니다.

    단일 컬렉션을 쿼리하려면 컬렉션을 선택합니다. 텍스트 필드에 컬렉션 경로를 입력합니다.

    ID가 동일한 모든 컬렉션을 쿼리하려면 컬렉션 그룹을 선택합니다. 컬렉션 그룹 필드에 컬렉션 그룹 ID를 입력합니다.

    지정한 컬렉션이나 컬렉션 그룹의 문서가 자동으로 테이블에 표시됩니다.

  4. 쿼리에 추가를 클릭하여 반환된 문서 모음을 필터링합니다. 기본적으로 쿼리 빌더는 WHERE 절을 추가합니다. 드롭다운과 텍스트 필드를 사용하여 이 절을 수정하거나 사용 가능한 다른 절 중 하나로 변경할 수 있습니다. 더 복잡한 쿼리를 계속 빌드하려면 쿼리에 추가를 클릭합니다.

    쿼리 절을 삭제하려면 삭제 버튼 을 클릭합니다. 모든 쿼리 절을 삭제하려면 지우기를 클릭합니다.

  5. 실행을 클릭하여 데이터베이스에서 결과를 검색합니다.

쿼리 요구사항 및 제한사항

쿼리 빌더를 사용할 때는 쿼리에 대한 다음 요구사항과 제한사항에 유의하세요.

  • 모든 쿼리는 1개 이상의 색인에서 지원해야 합니다. 데이터베이스가 쿼리를 지원할 색인을 찾을 수 없는 경우 필요한 색인을 빌드할 수 있는 링크가 포함된 오류가 반환됩니다.

  • ORDER BY 절은 WHERE 절의 필드와 일치해야 하며 순서도 동일해야 합니다. 기본적으로 결과는 문서 ID를 기준으로 정렬됩니다. 같음(==) 이외의 필드로 필터링하면 해당 필드에 ORDER BY 절을 추가합니다.

  • 범위(<, <=, >, >=)와 같지 않음(!=, not-in) 쿼리 절은 모두 동일한 필드에서 필터링되어야 합니다.

추가 제한사항은 쿼리 제한사항을 참조하세요.

데이터 관리

Cloud Firestore에서는 문서에 데이터를 저장하고 문서를 컬렉션으로 구성합니다. 데이터 추가를 시작하기 전에 Cloud Firestore 데이터 모델을 자세히 알아보세요.

Firebase Console에서 문서와 컬렉션을 추가, 수정, 삭제할 수 있습니다. 데이터를 관리하려면 Cloud Firestore 섹션에서 데이터을 여세요.

데이터 추가

  1. 컬렉션 추가를 클릭한 다음 컬렉션 이름을 입력하고 다음을 클릭합니다.
  2. 특정 문서 ID를 입력하거나 자동 ID를 클릭한 다음 문서에 데이터 필드를 추가합니다.
  3. 저장을 클릭합니다. 새로운 컬렉션 및 문서가 데이터 뷰어에 나타납니다.
  4. 컬렉션에 문서를 추가하려면 문서 추가를 클릭합니다.

데이터 수정

  1. 컬렉션을 클릭하여 문서를 표시한 다음 문서를 클릭하여 필드 및 하위 컬렉션을 봅니다.
  2. 값을 편집할 필드를 클릭합니다. 선택한 문서에 필드 또는 하위 컬렉션을 추가하려면 필드 추가 또는 컬렉션 추가를 클릭합니다.

데이터 삭제

컬렉션을 삭제하는 방법은 다음과 같습니다.

  1. 삭제하려는 컬렉션을 선택합니다.
  2. 문서 열의 맨 위에 있는 메뉴 아이콘을 클릭한 다음 컬렉션 삭제를 클릭합니다.

문서 열의 메뉴에서 컬렉션 삭제 클릭

문서 또는 모든 필드를 삭제하는 방법은 다음과 같습니다.

  1. 삭제하려는 문서를 선택합니다.
  2. 문서 세부정보 열의 맨 위에 있는 메뉴 아이콘을 클릭합니다. 문서 삭제 또는 문서 필드 삭제를 선택합니다.

문서를 삭제하면 하위 컬렉션을 포함하여 해당 문서의 모든 중첩 데이터가 삭제됩니다. 그러나 문서의 필드를 삭제해도 그 하위 컬렉션은 삭제되지 않습니다.

문서 세부정보 열의 컨텍스트 메뉴에서 문서 삭제 또는 문서 필드 삭제 클릭

문서의 특정 필드를 삭제하는 방법은 다음과 같습니다.

  1. 필드를 보려는 문서를 선택합니다.
  2. 삭제하려는 필드 옆의 삭제 아이콘을 클릭합니다.

문서에서 필드를 제거하려면 삭제 아이콘 클릭

Cloud Firestore 보안 규칙 관리

Firebase Console에서 Cloud Firestore 보안 규칙을 추가, 수정, 삭제하려면 Cloud Firestore 섹션에서 규칙으로 이동합니다. 규칙 설정 및 맞춤설정에 대해 자세히 알아보세요.

색인 관리

Firebase Console에서 쿼리에 대해 새로운 색인을 만들고 기존 색인을 관리하려면 Cloud Firestore 섹션에서 색인으로 이동합니다. 색인 관리에 대해 자세히 알아보세요.

사용량 모니터링

Cloud Firestore 사용량을 모니터링하려면 Firebase Console에서 Cloud Firestore 사용량을 여세요. 대시보드를 사용하여 여러 기간에 걸친 사용량을 측정할 수 있습니다.