Cloud Firestore의 색인 관리

Cloud Firestore에서 최상의 성능을 발휘하려면 모든 쿼리의 색인이 필요합니다. 모든 문서 필드는 자동으로 색인화되므로 등식 절만 사용하는 쿼리에는 색인이 추가로 필요하지 않습니다. 기존 색인에 매핑되지 않는 범위 절을 갖는 복합 쿼리를 시도하면 오류가 발생합니다. 오류 메시지는 Firebase 콘솔에서 누락된 색인을 만드는 직접 링크를 포함합니다.

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

Firebase 콘솔 사용

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

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

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

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

Firebase CLI 사용

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

색인 삭제

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

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

다음에 대한 의견 보내기...

도움이 필요하시나요? 지원 페이지를 방문하세요.