쿼리 인터페이스 개요

이 페이지에서는 기본 모드의 Firestore 데이터베이스에서 데이터에 액세스하는 데 사용할 수 있는 다양한 인터페이스를 설명합니다.

작업 인터페이스

Firestore Native 모드는 데이터 액세스를 위한 두 가지 인터페이스를 지원합니다.

파이프라인 작업

Firestore의 최신 쿼리 인터페이스입니다. 파이프라인 작업은 단계 기반 구성 가능한 구문을 지원합니다. 순서대로 실행되는 일련의 순차적 단계를 정의하여 작업을 구성합니다. 이를 통해 원래 인터페이스 (핵심 작업)에서는 불가능했던 집계 결과를 필터링하는 등의 복잡한 작업을 수행할 수 있습니다.

파이프라인 작업은 Firestore Enterprise 버전에서만 사용할 수 있으며 프리뷰 출시 단계에 있습니다.

핵심 작업

핵심 작업은 Firestore의 원래 인터페이스입니다. 핵심 작업은 문서 또는 컬렉션 참조에서 메서드 체이닝 구문 (.where(), .orderBy(), .get())을 사용하여 문서를 가져옵니다. 쿼리 단계의 순서는 암시되어 있으며 집계 지원은 제한됩니다.

Core 작업은 Enterprise 버전과 Standard 버전 모두에서 사용할 수 있지만 버전 간에 색인 기본값이 매우 다릅니다. 자세한 내용은 다음 섹션을 참고하세요.

버전 간 인터페이스 차이

Enterprise 버전에서 기본 모드의 Firestore 지원이 도입됨에 따라 Firestore Core와 Pipeline 작업을 모두 사용할 수 있습니다. Enterprise 버전에서 Core 작업을 사용하면 새로운 색인 생성 동작과 가격 책정 모델을 통해 Standard 버전의 제한사항이 많이 제거됩니다.

기능 Standard 버전 Enterprise 버전
지원되는 쿼리 작업 Firestore Core 작업으로 제한됩니다. Firestore Core 및 Pipeline 작업과 MongoDB 호환성을 갖춘 Firestore 작업을 지원합니다.
색인 생성 요구사항 모든 쿼리에는 색인이 필요합니다. 쿼리에는 색인이 필요하지 않습니다.
색인 생성 단일 필드에 자동 색인이 생성됩니다. 복합 색인을 수동으로 만들 수 있습니다. 자동 색인이 생성되지 않습니다. 색인을 수동으로 관리해야 합니다.
쿼리 성능 및 비용 색인 요구사항으로 인해 일반적으로 쿼리 성능이 우수합니다. 색인을 만들어 쿼리 성능과 비용을 최적화합니다. Query Explain 및 쿼리 통계를 사용하여 누락된 색인을 식별할 수 있습니다.

색인이 없는 쿼리는 데이터 세트가 커짐에 따라 성능이 저하되고 비용이 많이 들 수 있으므로 모니터링 및 조정이 필요합니다.

색인 생성 오버헤드 비용 색인은 자동으로 생성되므로 색인 쓰기에는 요금이 청구되지 않습니다. 연결된 문서가 작성되면 색인 항목을 작성할 때 쓰기 단위가 사용됩니다 (색인 항목 크기의 1KiB당 쓰기 단위 1개). 모든 필드에 색인 항목을 만들지 않으면 스토리지 비용을 절약할 수 있습니다.
청구 모델 (읽기/쓰기/삭제) 문서 읽기, 쓰기, 삭제당 요금이 청구됩니다. 읽기 및 쓰기당 (단위) 요금이 청구됩니다. 읽기는 읽기 단위 (4KiB 단위)로 요금이 청구됩니다. 쓰기 및 삭제는 쓰기 단위 (1KiB 단위)로 병합됩니다.
기본 가격 (백만 개당)

표시된 가격은 us-central1 리전의 가격입니다.

읽기: 문서 100,000개당$0.03 (또는 백만 개당 $0.30)

쓰기: 문서 100,000개당$0.09 (또는 백만 개당 $0.90)

삭제: 문서 100,000개당$0.01 (또는 백만 개당 $0.10)

읽기 단위: 읽기 단위 100만 개당$0.05

쓰기 단위: 쓰기 단위 100만 개당$0.26 일반적으로 문서가 4KiB 미만인 경우 가격이 Standard 읽기 비용보다 저렴합니다.

실시간 업데이트

표시된 가격은 us-central1 리전의 가격입니다.

실시간 업데이트는 문서 100,000개당 $0.03의 읽기로 청구됩니다. 실시간 업데이트에는 4KiB 단위당 요금이 청구되는 새로운 별도의 SKU (실시간 업데이트 단위)가 있습니다. 실시간 업데이트 비용은 읽기 단위 100만 개당$0.30입니다.

다음 단계