여러 속성에 범위 및 불일치 필터가 있는 쿼리 개요

Datastore 모드의 Firestore는 단일 쿼리의 여러 속성에 범위 및 불일치 필터 사용을 지원합니다. 이 기능을 사용하면 여러 속성에 범위 및 불일치 조건을 적용할 수 있고, 사후 필터링 로직 구현을 Datastore 모드의 Firestore에 위임하여 애플리케이션 개발을 간소화할 수 있습니다.

여러 속성의 범위 및 불일치 필터

다음 쿼리는 우선순위 및 일수에 범위 필터를 사용하여 우선순위가 4보다 크고 3일 내에 완료되는 모든 태스크를 반환합니다.

Go

query := datastore.NewQuery("Task").
   FilterField("priority", ">", 4).
   FilterField("days", "<", 3).

GQL

SELECT * FROM /tasks WHERE priority > 4 AND days < 3;

자바

Query<Entity> query =
    Query.newEntityQueryBuilder()
      .setKind("Task")
      .setFilter(
        CompositeFilter.and(
            PropertyFilter.gt("priority", 4), PropertyFilter.lt("days", 3)))
    .build();

Node.js

const query = datastore
  .createQuery('Task')
  .filter(
    and([
      new PropertyFilter('priority', '>', 4),
      new PropertyFilter('days', '<', 3),
    ])
  );

Python

from google.cloud import datastore
client = datastore.Client()
query = client.query(kind="Task")
query.add_filter(filter=PropertyFilter("priority", ">", 4))
query.add_filter(filter=PropertyFilter("days", "<", 3))

PHP

$query = $datastore->query()
    ->kind('Task')
    ->filter('priority', '>', 4)
    ->filter('days', '<', 3)

C#

Query query = new Query("Task")
{
  Filter = Filter.And(Filter.GreaterThan("priority", 4),
    Filter.LessThan("days", 3))
};

Ruby

query = datastore.query("Task")
                 .where("priority", ">", 4)
                 .where("days", "<", 3)

색인 생성 고려사항

쿼리 실행을 시작하기 전에 쿼리에 대해 읽어보시기 바랍니다.

ORDER BY 절이 지정되지 않은 경우 Datastore 모드의 Firestore는 쿼리의 필터 조건을 충족할 수 있는 색인을 사용하여 쿼리를 처리합니다. 이 방식은 색인 정의에 따라 정렬된 결과 집합을 생성합니다.

Datastore 모드의 Firestore 쿼리의 성능과 비용을 최적화하려면 색인의 속성 순서를 최적화합니다. 이렇게 하려면 쿼리가 불필요한 색인 항목의 스캔을 방지하는 데이터 세트로 정리되도록 색인을 왼쪽에서 오른쪽으로 정렬합니다.

예를 들어 직원 컬렉션을 검색하여 급여가 100,000달러를 초과하고 경력 연수가 0년을 넘는 미국 직원을 찾는다고 가정해 보겠습니다. 데이터 세트에 대한 이해를 바탕으로 급여 제약조건이 경력 제약조건보다 더 선택적이라는 것을 알 수 있습니다. 색인 스캔 횟수를 줄이는 색인은 (salary [...], experience [...]) 색인입니다. 따라서 다음 예시와 같이 빠르고 비용 효율적인 쿼리가 experience보다 salary를 먼저 정렬합니다.

GQL

SELECT *
FROM /employees
WHERE salary > 100000 AND experience > 0
ORDER BY salary, experience

자바

Query<Entity> query =
  Query.newEntityQueryBuilder()
    .setKind("employees")
    .setFilter(
        CompositeFilter.and(
            PropertyFilter.gt("salary", 100000), PropertyFilter.gt("experience", 0)))
    .setOrderBy(OrderBy("salary"), OrderBy("experience"))
    .build();

Node.js

const query = datastore
  .createQuery("employees")
  .filter(
    and([
      new PropertyFilter("salary", ">", 100000),
      new PropertyFilter("experience", ">", 0),
       ])
    )
  .order("salary")
  .order("experience");

Python

query = client.query(kind="employees")
query.add_filter("salary", ">", 100000)
query.add_filter("experience", ">", 0)
query.order = ["-salary", "-experience"]

색인 최적화를 위한 권장사항

색인을 최적화하는 경우 다음 권장사항을 따르세요.

가장 선택적인 범위 또는 불일치 필드가 이어서 오는 일치 필드를 기준으로 쿼리 순서 지정

Datastore 모드의 Firestore는 복합 색인의 가장 왼쪽 속성을 사용하여 orderBy() 쿼리의 첫 번째 필드에서 일치 제약조건과 범위 및 불일치 제약조건(있는 경우)을 충족합니다. 이러한 제약조건을 통해 Datastore 모드의 Firestore가 스캔하는 색인 항목 수를 줄일 수 있습니다. Datastore 모드의 Firestore는 색인의 나머지 속성을 사용하여 쿼리의 다른 범위 및 불일치 제약조건을 충족합니다. 이러한 제약조건은 Datastore 모드의 Firestore가 스캔하는 색인 항목 수를 줄이지는 않지만 일치하지 않는 항목을 필터링하여 클라이언트에 반환되는 항목 수를 줄입니다.

효율적인 색인 만들기에 대한 자세한 내용은 색인 구조 및 정의와 색인 최적화를 참조하세요.

쿼리 제약조건 선택성의 내림차순으로 속성 순서 지정

Datastore 모드의 Firestore가 쿼리에 가장 적합한 색인을 선택하도록 하려면 쿼리의 제약조건 선택성에 따라 범위 및 불일치 속성 순서를 선택성이 높은 순으로 지정하는 orderBy() 절을 지정합니다. 선택성이 높을수록 더 적은 항목과 일치하고 선택성이 낮을수록 더 많은 항목과 일치합니다. 색인 순서에서 선택성이 높은 범위 및 불일치 속성을 선택성이 낮은 속성 앞에 배치합니다.

Datastore 모드의 Firestore가 네트워크를 통해 스캔하여 반환하는 항목 수를 최소화하려면 항상 쿼리 제약조건 선택성의 내림차순으로 속성 순서를 지정해야 합니다. 결과 집합이 필요한 순서가 아니며 결과 집합이 작을 것으로 예상되는 경우 클라이언트 측 로직을 구현하여 예상되는 순서에 따라 순서를 다시 지정할 수 있습니다.

예를 들어 직원 컬렉션을 검색하여 급여가 100,000달러를 초과하는 미국 직원을 찾아 이러한 직원의 경력 연수를 기준으로 결과를 정렬한다고 가정해 보겠습니다. 급여가 100,000달러를 초과할 것으로 예상되는 직원 수가 많지 않을 경우 쿼리를 작성하는 효율적인 방법은 다음과 같습니다.

자바

Query<Entity> query =
  Query.newEntityQueryBuilder()
    .setKind("employees")
    .setFilter(PropertyFilter.gt("salary", 100000))
    .setOrderBy(OrderBy("salary"))
    .build();
QueryResults<Entity> results = datastore.run(query);
// Order results by `experience`

Node.js

const query = datastore
  .createQuery("employees")
  .filter(new PropertyFilter("salary", ">", 100000))
  .order("salary");
const [entities] = await datastore.runQuery(query);
// Order results by `experience`

Python

query = client.query(kind="employees")
query.add_filter("salary", ">", 100000)
query.order = ["salary"]
results = query.fetch()
// Order results by `experience`

쿼리에 experience의 순서를 추가하면 동일한 항목 집합이 생성되고 클라이언트에서 결과가 다시 정렬되지 않지만 쿼리가 관련 없는 색인 항목을 이전 쿼리보다 더 많이 읽을 수 있습니다. 이는 Datastore 모드의 Firestore가 항상 색인 속성 프리픽스가 쿼리의 ORDER BY 절과 일치하는 색인을 선호하기 때문입니다. experience가 ORDER BY 절에 추가된 경우 Datastore 모드의 Firestore는 쿼리 결과 계산을 위해 (experience [...], salary [...]) 색인을 선택합니다. experience에는 다른 제약조건이 없으므로 Datastore 모드의 Firestore는 salary 필터를 적용하여 최종 결과 집합을 찾기 전에 employees 컬렉션의 모든 색인 항목을 읽습니다. 즉, salary 필터를 충족하지 않는 색인 항목이 계속 읽히므로 쿼리 지연 시간과 비용이 증가합니다.

가격 책정

여러 속성에 범위 및 불일치 필터가 있는 쿼리에는 항목 읽기 및 색인 항목 읽기를 기준으로 요금이 청구됩니다.

자세한 내용은 가격 책정 페이지를 참조하세요.

제한사항

쿼리 제한사항 외에도 여러 속성에 범위 및 불일치 필터가 있는 쿼리를 사용하기 전에 다음 제한사항에 유의하세요.

  • 쿼리 실행 비용이 너무 많이 들지 않도록 Datastore 모드의 Firestore는 범위 또는 불일치 연산자 수를 10개로 제한합니다.

다음 단계