개요
이 가이드 에서는 Java 운전자 사용하여 컬렉션 에서 Atlas Search 쿼리를 실행 방법을 학습 수 있습니다. Atlas Search 사용하면 MongoDB Atlas 에서 호스팅되는 컬렉션에서 전체 텍스트 검색을 수행할 수 있습니다. Atlas Search 인덱스는 검색 동작과 인덱스 할 필드를 지정합니다.
샘플 데이터
이 가이드의 예시에서는 Atlas 샘플 데이터 세트의 sample_mflix
데이터베이스에 있는 movies
컬렉션을 사용합니다. 무료 MongoDB Atlas 클러스터를 생성하고 샘플 데이터 세트를 로드하는 방법을 알아보려면 Atlas 시작하기 가이드를 참조하세요. 집계 작업 및 빌더에 대해 자세히 알아보려면 집계 가이드를 참조하세요.
Atlas Search 쿼리 실행
이 섹션은 집계 파이프라인을 생성하여 컬렉션에서 Atlas Search 쿼리를 실행하는 방법을 설명합니다. Aggregates.search()
빌더 메서드를 사용하여 검색 기준을 지정하는 $search
파이프라인 단계를 만들 수 있습니다. 그런 다음 aggregate()
메서드를 호출하고 파이프라인을 매개 변수로 전달합니다.
참고
MongoDB Atlas v4.2 이상에서만 사용 가능
이 집계 파이프라인 연산자4.2 Atlas Search 인덱스 적용되는 v 이상을 실행 MongoDB Atlas 클러스터에 호스팅되는 컬렉션에만 사용할 수 있습니다. 이 연산자의 필수 설정 및 기능에 대한 자세히 보기는 Atlas Search 설명서를 참조하세요.
Atlas Search 쿼리 실행 전에 컬렉션 에 Atlas Search 인덱스 만들어야 합니다. 프로그래밍 방식으로 Atlas Search 인덱스 만드는 방법을 학습하려면 인덱스 가이드의 Atlas Search 및 Vector Search 인덱스 섹션을 참조하세요.
Atlas Search 예시
이 예시 다음 조치를 수행하여 Atlas Search 쿼리 실행합니다.
Aggregates.search()
빌더 메서드를 사용하여$search
스테이지를 구성하고, 드라이버에게title
필드에"Alabama"
단어가 포함된 문서를 쿼리하도록 지시합니다.Aggregates.project()
빌더 메서드를 사용하여$project
단계를 구성하고, 쿼리 결과에title
필드 포함하도록 운전자 에 지시합니다.파이프라인 단계를
aggregate()
메서드에 전달하고 결과를 출력합니다.
팁
Java 드라이버 Atlas Search 예시
Java 드라이버를 사용하여 Atlas Search 쿼리를 수행하는 더 많은 예시를 보려면 Atlas 문서의 Atlas Search 튜토리얼을 참조하세요.
Atlas Search 메타데이터
Use the searchMeta()
method to create a $searchMeta pipeline stage, which returns only the metadata from of the Atlas Search results.
팁
MongoDB Atlas v4.4.11 이상에서만 사용 가능
이 집계 파이프라인 연산자는 v4.4.11 이상을 실행하는 MongoDB Atlas 클러스터에서만 사용할 수 있습니다. 상세한 사용 가능 버전 목록은 $searchMeta에 대한 MongoDB Atlas 문서를 참조하세요.
다음 예에서는 Atlas Search 집계 단계의 near
메타데이터를 보여 줍니다.
Aggregates.searchMeta( SearchOperator.near(2010, 1, SearchPath.fieldPath("year")));
To learn more about this helper method, see the searchMeta() API documentation.
파이프라인 검색 단계 만들기
Java 드라이버는 다음 연산자에 대한 헬퍼 메서드를 제공합니다.
연산자 | 설명 |
---|---|
불완전한 입력 문자열에서 일련의 문자가 포함된 단어나 구를 검색 합니다. | |
두 개 이상의 연산자를 단일 쿼리로 결합합니다. | |
필드 지정한 값과 일치하는지 확인합니다. | |
문서에 인덱싱된 지정 필드 이름에 대한 경로가 있는지 테스트합니다. | |
지정된 경로에서 BSON 번호, 날짜, 부울, ObjectId, uuid 또는 문자열 값의 배열 검색 하고 필드 값이 지정된 배열 의 임의 값과 같은 문서를 반환합니다. | |
입력 문서와 유사한 문서를 반환합니다. | |
숫자, 날짜 및 GeoJSON 포인트 값을 쿼리하고 점수를 매기는 기능을 지원합니다. | |
인덱스 구성에 지정된 분석기 사용하여 정렬된 용어 시퀀스가 포함된 문서를 검색 합니다. | |
인덱싱된 필드와 값의 조합을 쿼리할 수 있습니다. | |
숫자, 날짜 및 문자열 값을 쿼리하고 점수를 매길 수 있도록 지원합니다. | |
쿼리 필드 정규 표현식 으로 해석합니다. | |
인덱스 구성에서 지정한 분석기 사용하여 전체 텍스트 검색 수행합니다. | |
검색 문자열에 모든 문자와 일치할 수 있는 특수 문자를 사용하는 쿼리를 활성화합니다. |
파이프라인 검색 단계 예시
참고
Atlas 샘플 데이터 세트
이 예시 Atlas 샘플 데이터 세트의 sample_mflix.movies
컬렉션 사용합니다. 무료 계층 Atlas cluster 설정하다 하고 샘플 데이터 세트를 로드하는 방법을 학습 Atlas 설명서에서 Atlas 시작하기 튜토리얼을 참조하세요.
이 예시 실행 하려면 먼저 movies
컬렉션 에 다음 정의가 있는 Atlas Search 인덱스 만들어야 합니다.
{ "mappings": { "dynamic": true, "fields": { "title": { "analyzer": "lucene.keyword", "type": "string" }, "genres": { "normalizer": "lowercase", "type": "token" } } } }
Atlas Search 인덱스 생성에 대해 자세히 학습하려면 인덱스 가이드의 Atlas Search 및 Vector Search 인덱스 섹션을 참조하세요.
다음 코드는 다음 사양의 $search
단계를 생성합니다.
genres
배열"Comedy"
가 포함되어 있는지 확인합니다.fullplot
필드 에서"new york"
구문을 검색합니다.1950
~2000
사이의year
값과 일치합니다.텀
"Love"
로 시작하는title
값을 검색합니다.
package fundamentals.builders; import java.util.Arrays; import java.util.List; import org.bson.Document; import org.bson.conversions.Bson; import com.mongodb.client.MongoClient; import com.mongodb.client.MongoClients; import com.mongodb.client.MongoCollection; import com.mongodb.client.MongoDatabase; import com.mongodb.client.model.Aggregates; import com.mongodb.client.model.Filters; import com.mongodb.client.model.Projections; import com.mongodb.client.model.search.SearchOperator; import com.mongodb.client.model.search.SearchPath; public class AggregateSearchBuilderExample { private static final String CONNECTION_URI = "<connection URI>"; // Match aggregation private static void runMatch(MongoCollection<Document> collection) { Bson matchStage = Aggregates.match(Filters.eq("title", "Future")); Bson projection = Aggregates.project(Projections.fields(Projections.include("title", "released"))); List<Bson> aggregateStages = Arrays.asList(matchStage, projection); System.out.println("aggregateStages: " + aggregateStages); collection.aggregate( aggregateStages ).forEach(result -> System.out.println(result)); } /* * Atlas text search aggregation * Requires Atlas cluster and full text search index * See https://www.mongodb.com/ko-kr/docs/atlas/atlas-search/tutorial/ for more info on requirements */ private static void runAtlasTextSearch(MongoCollection<Document> collection) { // begin atlasTextSearch Bson textSearch = Aggregates.search( SearchOperator.text( SearchPath.fieldPath("title"), "Future")); // end atlasTextSearch // To condense result data, add this projection into the pipeline // Bson projection = Aggregates.project(Projections.fields(Projections.include("title", "released"))); List<Bson> aggregateStages = Arrays.asList(textSearch); System.out.println("aggregateStages: " + aggregateStages); System.out.println("explain:\n" + collection.aggregate(aggregateStages).explain()); collection.aggregate(aggregateStages).forEach(result -> System.out.println(result)); } private static void runAtlasTextSearchMeta(MongoCollection<Document> collection) { Bson textSearchMeta = // begin atlasSearchMeta Aggregates.searchMeta( SearchOperator.near(2010, 1, SearchPath.fieldPath("year"))); // end atlasSearchMeta List<Bson> aggregateStages = Arrays.asList(textSearchMeta); System.out.println("aggregateStages: " + aggregateStages); collection.aggregate(aggregateStages).forEach(result -> System.out.println(result)); } public static void main(String[] args) { String uri = CONNECTION_URI; try (MongoClient mongoClient = MongoClients.create(uri)) { MongoDatabase database = mongoClient.getDatabase("sample_mflix"); MongoCollection<Document> collection = database.getCollection("movies"); // Uncomment the methods that correspond to what you're testing // runMatch(collection); // runAtlasTextSearch(collection); runAtlasTextSearchMeta(collection); } } }
{"_id": ..., "genres": ["Comedy", "Romance"], "title": "Love at First Bite", "year": 1979} {"_id": ..., "genres": ["Comedy", "Drama"], "title": "Love Affair", "year": 1994}
To learn more about the Atlas Search helper methods, see the SearchOperator interface reference in the Driver Core API documentation.
추가 정보
Atlas Search 에 대해 자세히 학습 Atlas 설명서에서 Atlas Search 참조하세요.
API 문서
이 가이드 에 언급된 메서드에 학습 보려면 다음 API 설명서를 참조하세요.