콘솔로 이동

Cloud Firestore의 색인 관리

Cloud Firestore를 사용하면 모든 쿼리에 색인을 요청하므로 쿼리 성능이 보장됩니다. 대부분의 기본 쿼리에 필요한 색인이 자동으로 생성됩니다. 앱을 사용하고 테스트할 때 Cloud Firestore는 오류 메세지를 생성합니다. 이는 앱에 필요한 추가 색인을 만드는 데 유용합니다. 이 페이지에서는 단일 필드복합 색인을 관리하는 방법을 설명합니다.

오류 메시지를 통해 누락된 색인 생성

기존 색인에 매핑되지 않는 범위 절이 포함된 복합 쿼리를 시도하면 오류가 발생합니다. 오류 메시지에는 Firebase Console에서 누락된 색인을 만드는 직접 링크가 포함됩니다.

생성된 링크를 따라 Firebase Console로 이동하고 자동으로 입력된 정보를 검토한 후 만들기를 클릭하세요.

Firebase Console 사용

Firebase 콘솔에서 수동으로 새 색인을 생성하는 방법:

Firebase Console의 Firestore 색인 생성 인터페이스 이미지

  1. Firebase Console데이터베이스 섹션으로 이동합니다.
  2. 색인 탭으로 이동하고 색인 추가를 클릭합니다.
  3. 컬렉션 이름을 입력하고 색인의 정렬 기준으로 사용할 필드를 설정합니다.
  4. 만들기를 클릭합니다.

쿼리의 크기에 따라 색인을 만드는 데 몇 분 정도 걸릴 수 있습니다. 색인이 생성되면 복합 색인 섹션에서 색인과 색인의 상태를 확인할 수 있습니다. 여전히 생성 중이면 Firebase 콘솔에 생성 상태 표시줄이 포함됩니다.

색인 삭제

색인을 삭제하는 방법은 다음과 같습니다.

  1. Firebase Console데이터베이스 섹션으로 이동합니다.
  2. 색인 탭을 클릭합니다.
  3. 삭제할 색인에 마우스를 가져가고 컨텍스트 메뉴에서 삭제를 선택합니다.
  4. 경고에서 삭제를 클릭하여 삭제 의사를 확인합니다.

Firebase CLI 사용

Firebase CLI를 사용하여 색인을 배포할 수도 있습니다. 시작하려면 프로젝트 디렉터리에서 firebase init firestore를 실행하면 됩니다. 설정하는 동안 Firebase CLI에서 기본 색인을 사용한 올바른 형식의 JSON 파일을 생성합니다. 파일을 수정해 색인을 추가하고 firebase deploy 명령을 사용해 배포합니다. 색인만 배포하려면 --only firestore:indexes 플래그를 추가합니다. Firebase Console에서 색인을 수정할 경우 로컬 색인 파일도 업데이트해야 합니다.

색인 빌드 시간

업데이트해야 할 데이터의 양에 따라 색인 생성에는 몇 분 정도 소요될 수 있습니다. 색인을 생성할 필드와 매치되는 문서가 많으면 생성에 소요되는 시간이 더 길어집니다. 또한 고유한 컬렉션 ID별로 진행 중인 색인 빌드는 하나만 있을 수 있습니다. 컬렉션 ID가 동일한 여러 색인 빌드는 순차적으로 완료됩니다.

색인 빌드 오류

복합 색인 및 단일 필드 색인 예외를 관리할 때 색인 빌드 오류가 발생할 수 있습니다. Cloud Firestore가 색인을 생성하는 데이터에 문제가 발생하면 색인 생성 작업이 실패할 수 있습니다. 대부분의 경우 이는 색인 한도에 도달했음을 의미합니다. 예를 들어 작업이 문서당 최대 색인 항목 수에 도달했을 수 있습니다.

색인 생성이 실패하면 Console에 오류 메시지가 표시됩니다. 색인 한도에 도달했는지 확인한 후 색인 작업을 다시 시도하세요.