쿼리 결과 검색

쿼리를 만든 후, 검색 옵션의 개수를 지정하여 쿼리가 반환하는 결과를 추가로 제어할 수 있습니다. 앱의 쿼리 구조화에 대한 자세한 내용은 데이터 저장소 쿼리를 참조하세요.

단일 항목 검색

쿼리와 일치하는 단일 항목만 검색하려면 PreparedQuery.asSingleEntity() 메서드를 사용합니다.

Query q =
    new Query("Person")
        .setFilter(new FilterPredicate("lastName", FilterOperator.EQUAL, targetLastName));

PreparedQuery pq = datastore.prepare(q);
Entity result = pq.asSingleEntity();

이 메서드는 색인에서 쿼리와 일치하는 첫 번째 결과를 반환합니다. 일치하는 결과가 두 개 이상이면 TooManyResultsException이 발생합니다.

쿼리 결과 반복

PreparedQuery.asIterable() 및 PreparedQuery.asIterator() 메서드를 사용하여 쿼리 결과를 반복하면 Cloud Datastore는 결과를 일괄 검색합니다. 기본적으로 각 배치에는 20개의 결과가 포함되지만 FetchOptions.chunkSize()를 사용하여 이 값을 변경할 수 있습니다. 모두 반환되거나 요청이 타임아웃될 때까지 쿼리 결과를 계속해서 반복할 수 있습니다.

한 항목에서 선택한 속성 검색하기

전체 항목이 아닌 한 항목에서 선택한 속성만 검색하려면 프로젝션 쿼리를 사용합니다. 이러한 유형의 쿼리는 전체 항목을 반환하는 쿼리보다 더 빨리 실행되고 비용도 더 적게 듭니다.

마찬가지로 키 전용 쿼리는 전체 항목이 아닌 쿼리와 일치하는 항목의 키만 반환하므로 시간과 리소스가 절약됩니다. 이 유형의 쿼리를 만들려면 Query.setKeysOnly() 메서드를 사용합니다.

Query q = new Query("Person").setKeysOnly();

쿼리에 제한 설정

한 배치에 반환되는 결과의 최대 수를 제어하도록 쿼리에 제한을 지정할 수 있습니다. 다음 예시에서는 Cloud Datastore에서 키가 가장 큰 사람 5명을 검색합니다.

private List<Entity> getTallestPeople() {
  DatastoreService datastore = DatastoreServiceFactory.getDatastoreService();

  Query q = new Query("Person").addSort("height", SortDirection.DESCENDING);

  PreparedQuery pq = datastore.prepare(q);
  return pq.asList(FetchOptions.Builder.withLimit(5));
}

다음 단계