Atlas Search에서 동의어를 사용하는 방법

쿼리는 title 필드에서 automobile 단어를 검색하고 transportSynonyms 동의어 매핑 정의를 사용하여 transport_synonyms 동의어 소스 컬렉션에서 쿼리 단어 automobile의 동의어로 구성된 단어를 검색합니다. 쿼리에는 다음과 같은 단계가 포함됩니다.

• $limit 단계를 사용하여 출력 결과를 10개로 제한합니다.

• $project 단계에서 title 외에 모든 필드를 제외하고 score라는 필드를 추가합니다.

MongoDB Compass에서 이 쿼리를 실행하려면 다음 안내를 따르세요.

1. Aggregations 탭을 클릭합니다.

2. Select...를 클릭한 다음 드롭다운에서 단계를 선택하고 해당 단계에 대한 쿼리를 추가하여 다음 파이프라인 단계를 각각 구성합니다. 단계를 추가하려면 Add Stage을 클릭합니다.

   파이프라인 단계	쿼리
   $search	{ "index": "synonyms-tutorial", "text": { "path": "title", "query": "automobile", "synonyms": "transportSynonyms" } }
   $limit	10
   $project	{ "_id": 0, "title": 1, "score": { "$meta": "searchScore" } }

   Auto Preview를 활성화한 경우 MongoDB Compass는 $project 파이프라인 단계 옆에 다음 문서를 표시합니다.

   {title Cars} {score 4.197734832763672}
   {title Planes, Trains & Automobiles} {score 3.8511905670166016}
   {title Car Wash} {score 3.39473032951355}
   {title Used Cars} {score 3.39473032951355}
   {title Blue Car} {score 3.39473032951355}
   {title Cars 2} {score 3.39473032951355}
   {title Stealing Cars} {score 3.39473032951355}
   {title Cop Car} {score 3.39473032951355}
   {title The Cars That Eat People} {score 2.8496146202087402}
   {title Khrustalyov, My Car!} {score 2.8496146202087402}

   쿼리 용어가 automobile인 경우에도 automobile을(를) 이름이 컬렉션에 대한 인덱스에 지정된 sample_synonyms인 동의어 소스 컬렉션에서 car, vehicle, automobile의 동의어로 구성했기 때문에 title 필드에 car 및 automobile이(가) 포함된 영화가 Atlas Search 결과에 포함됩니다. Atlas Search는 car 및 vehicle 단어를 검색할 때 동일한 결과를 반환합니다. 이를 테스트하려면 위 쿼리의 query 필드 값을 car 또는 vehicle 중 하나로 바꾸고 쿼리를 실행합니다.

쿼리는 title 필드에서 boat 단어를 검색하고 transportSynonyms라는 동의어 매핑 정의를 사용하여 transport_synonyms 동의어 소스 컬렉션에서 쿼리 단어 boat의 동의어로 구성된 단어를 검색합니다. 다음 단계가 포함됩니다.

• $limit 단계를 사용하여 출력 결과를 10개로 제한합니다.

• $project 단계에서 title 외에 모든 필드를 제외하고 score라는 필드를 추가합니다.

MongoDB Compass에서 이 쿼리를 실행하려면 다음 안내를 따르세요.

1. Aggregations 탭을 클릭합니다.

2. Select...를 클릭한 다음 드롭다운에서 단계를 선택하고 해당 단계에 대한 쿼리를 추가하여 다음 파이프라인 단계를 각각 구성합니다. 단계를 추가하려면 Add Stage을 클릭합니다.

   파이프라인 단계	쿼리
   $search	{ "index": "synonyms-tutorial", "text": { "path": "title", "query": "boat", "synonyms": "transportSynonyms" } }
   $limit	10
   $project	{ "_id": 0, "title": 1, "score": { "$meta": "searchScore" } }

   Auto Preview를 활성화한 경우 MongoDB Compass는 $project 파이프라인 단계 옆에 다음 문서를 표시합니다.

   {title Vessel} {score 5.373150825500488}
   {title Boats} {score 4.589139938354492}
   {title And the Ship Sails On} {score 4.3452959060668945}
   {title Broken Vessels} {score 4.3452959060668945}
   {title Sailing to Paradise} {score 4.3452959060668945}
   {title Boat People} {score 3.711261749267578}
   {title Boat Trip} {score 3.711261749267578}
   {title Three Men in a Boat} {score 3.1153182983398438}
   {title The Glass Bottom Boat} {score 3.1153182983398438}
   {title Jack Goes Boating} {score 3.1153182983398438}

   title 필드에 boat, vessel, sail이 있는 영화가 Atlas Search 결과에 포함됩니다. 이는 컬렉션의 인덱스에 지정된 sample_synonyms라는 동의어 소스 컬렉션에서 boat, vessel, sail을 boat 동의어로 구성했기 때문입니다.

   Atlas Search는 결과에서 vessel 단어를 검색한 경우에만 다음 문서를 반환합니다.

   { "title" : "Vessel", "score" : 5.373150825500488 }
   { "title" : "Broken Vessels", "score" : 4.3452959060668945 }

   Atlas Search는 title 필드에 boat 또는 sail이 포함된 문서를 결과에 포함하지 않습니다. 이는 동의어 소스 컬렉션에서 vessel을 boat 또는 sail의 동의어로 구성하지 않았기 때문입니다. 이를 테스트하려면 위 쿼리의 query 필드 값을 vessel로 바꾸고 쿼리를 다시 실행합니다.

   마찬가지로, Atlas Search는 sail 검색어에 대한 검색 결과에서만 다음 문서를 반환합니다.

   { "title" : "And the Ship Sails On", "score" : 4.3452959060668945 }
   { "title" : "Sailing to Paradise", "score" : 4.3452959060668945 }

   Atlas Search는 결과에서 title 필드에 boat 또는 vessel이 포함된 문서를 제외합니다. 이는 우리가 synonyms 소스 컬렉션에서 sail을 boat 또는 vessel의 동의어로 설정하지 않았기 때문입니다. 이 예시를 테스트하려면 위의 쿼리에서 query 필드의 값을 sail로 바꾼 후 쿼리를 다시 실행해 보세요.

쿼리는 title 필드에서 automobile 단어를 검색하고 transportSynonyms 동의어 매핑 정의를 사용하여 transport_synonyms라는 동의어 소스 컬렉션에서 쿼리 단어 automobile의 동의어로 구성된 단어를 검색합니다. 이 쿼리는 title 필드에서도 단어 attire를 검색하며 attireSynonyms라는 이름의 동의어 매핑 정의를 사용하여 attire_synonyms라는 이름의 동의어 소스 컬렉션에서 쿼리 단어 attire의 동의어로 설정된 단어들을 검색합니다

쿼리에는 다음과 같은 파이프라인 단계가 포함됩니다.

• $limit 단계를 사용하여 출력 결과를 10개로 제한합니다.

• $project 단계에서 title 외에 모든 필드를 제외하고 score라는 필드를 추가합니다.

MongoDB Compass에서 이 쿼리를 실행하려면 다음 안내를 따르세요.

1. Aggregations 탭을 클릭합니다.

2. Select...를 클릭한 다음 드롭다운에서 단계를 선택하고 해당 단계에 대한 쿼리를 추가하여 다음 파이프라인 단계를 각각 구성합니다. 단계를 추가하려면 Add Stage을 클릭합니다.

   파이프라인 단계	쿼리
   $search	{ "index": "synonyms-tutorial", "compound": { "should": [{ "text": { "path": "title", "query": "automobile", "synonyms": "transportSynonyms" } }, { "text": { "path": "title", "query": "attire", "synonyms": "attireSynonyms" } }] } }
   $limit	10
   $project	{ "_id": 0, "title": 1, "score": { "$meta": "searchScore" } }

   Auto Preview를 활성화한 경우 MongoDB Compass는 $project 파이프라인 단계 옆에 다음 문서를 표시합니다.

   { title: 'The Dress', score: 4.812004089355469 },
   { title: 'Cars', score: 4.197734832763672 },
   { title: 'Dressed to Kill', score: 3.891493320465088 },
   { title: '27 Dresses', score: 3.891493320465088 },
   { title: 'Planes, Trains & Automobiles', score: 3.8511905670166016 },
   { title: 'Car Wash', score: 3.39473032951355 },
   { title: 'Used Cars', score: 3.39473032951355 },
   { title: 'Blue Car', score: 3.39473032951355 },
   { title: 'Cars 2', score: 3.39473032951355 },
   { title: 'Stealing Cars', score: 3.39473032951355 }

   Atlas Search 결과에는 두 검색어에 대한 문서가 모두 포함되어 있습니다. 결과에는 쿼리 용어 automobile에 대하여 title 필드에 car이(가) 포함된 영화가 포함됩니다. 이는 transport_synonyms 동의어 소스 컬렉션에서 automobile을(를) car, vehicle 및 automobile의 동의어로 구성했기 때문입니다. 결과에는 쿼리 용어 attire에 대하여 제목 필드에 dress이(가) 포함된 영화도 포함됩니다. 이는 attire_synonyms 동의어 소스 컬렉션에서 attire을(를) dress, apparel 및 attire의 동의어로 구성했기 때문입니다.

   Atlas Search는 transport_synonyms 소스 컬렉션에서 car 또는 vehicle을(를) 검색하고 attire_synonyms 소스 컬렉션에서 dress 또는 apparel을(를) 검색할 때 동일한 결과를 반환합니다. 이 예시를 테스트하려면 위 쿼리의 query 필드 값을 car 또는 vehicle(으)로 바꾸고 위 쿼리의 query 필드 값을 dress 또는 apparel(으)로 바꾼 다음 쿼리를 다시 실행합니다.

쿼리는 title 필드에서 boat 단어를 검색하고 transportSynonyms 동의어 매핑 정의를 사용하여 transport_synonyms라는 동의어 소스 컬렉션에서 쿼리 단어 boat의 동의어로 구성된 단어를 검색합니다. 이 쿼리는 title 필드에서도 단어 hat를 검색하며 attireSynonyms라는 이름의 동의어 매핑 정의를 사용하여 attire_synonyms라는 이름의 동의어 소스 컬렉션에서 쿼리 단어 hat의 동의어로 설정된 단어들을 검색합니다

쿼리에는 다음과 같은 파이프라인 단계가 포함됩니다.

• $limit 단계를 사용하여 출력 결과를 10개로 제한합니다.

• $project 단계에서 title 외에 모든 필드를 제외하고 score라는 필드를 추가합니다.

MongoDB Compass에서 이 쿼리를 실행하려면 다음 안내를 따르세요.

1. Aggregations 탭을 클릭합니다.

2. Select...를 클릭한 다음 드롭다운에서 단계를 선택하고 해당 단계에 대한 쿼리를 추가하여 다음 파이프라인 단계를 각각 구성합니다. 단계를 추가하려면 Add Stage을 클릭합니다.

   파이프라인 단계	쿼리
   $search	{ "index": "synonyms-tutorial", "compound": { "should": [{ "text": { "path": "title", "query": "boat", "synonyms": "transportSynonyms" } }, { "text": { "path": "title", "query": "hat", "synonyms": "attireSynonyms" } }] } }
   $limit	10
   $project	{ "_id": 0, "title": 1, "score": { "$meta": "searchScore" } }

   Auto Preview를 활성화한 경우 MongoDB Compass는 $project 파이프라인 단계 옆에 다음 문서를 표시합니다.

   { title: 'Fedora', score: 5.673145294189453 },
   { title: 'Vessel', score: 5.373150825500488 },
   { title: 'Boats', score: 4.589139938354492 },
   { title: 'And the Ship Sails On', score: 4. 3452959060668945 },
   { title: 'Broken Vessels', score: 4.3452959060668945 },
   { title: 'Sailing to Paradise', score: 4.3452959060668945 },
   { title: 'Top Hat', score: 4.066137313842773 },
   { title: 'A Hatful of Rain', score: 4.066137313842773 },
   { title: 'Boat People', score: 3.711261749267578 },
   { title: 'Boat Trip', score: 3.711261749267578 }

   Atlas Search 결과에 두 검색어에 대한 문서가 모두 포함됩니다. 검색어 boat에 대해 title 필드에 vessel, boat, sail이 있는 영화가 결과에 포함됩니다. 이는 transport_synonyms라는 동의어 소스 컬렉션에서 boat를 boat, vessel, sail의 동의어로 구성했기 때문입니다.

   Atlas Search는 vessel 용어 검색 결과에서 title 필드에 boat 또는 sail이 포함된 문서를 제외합니다. 동의어 소스 컬렉션에서 vessel을 boat 또는 sail의 동의어로 구성하지 않았기 때문입니다. 마찬가지로, Atlas Search는 sail 용어 검색 결과의 title 필드에 boat 또는 vessel이 포함된 문서를 제외합니다. 동의어 소스 컬렉션에서 sail을 boat 또는 vessel의 동의어로 구성하지 않았기 때문입니다. 이러한 예를 테스트하려면 위 쿼리의 query 필드 값을 vessel 또는 sail로 바꾸고 쿼리를 다시 실행하세요.

   검색어 hat에 대하여 제목 필드에 fedora 및 hat이 있는 동영상도 결과에 포함됩니다. attire_synonyms라는 동의어 소스 컬렉션에서 hat을 hat, fedora, headgear 동의어로 구성했기 때문입니다.

   Atlas Search는 headgear 용어 검색 결과에서 title 필드에 hat 또는 fedora이 포함된 문서를 제외합니다. 동의어 소스 컬렉션에서 headgear을 hat 또는 fedora의 동의어로 구성하지 않았기 때문입니다. 마찬가지로, Atlas Search는 fedora 용어 검색 결과의 title 필드에 hat 또는 headgear이 포함된 문서를 제외합니다. 동의어 소스 컬렉션에서 fedora을 hat 또는 headgear의 동의어로 구성하지 않았기 때문입니다. 이러한 예를 테스트하려면 위 쿼리의 query 필드 값을 fedora 또는 headgear로 바꾸고 쿼리를 다시 실행하세요.

1. synonyms-equivalent-query.go이라는 파일을 만듭니다.

2. 코드 예시를 복사하여 synonyms-equivalent-query.go 파일에 붙여넣습니다.

   코드 예시에는 다음 단계가 포함되어 있습니다.

   • $search 단계는 title 필드에서 automobile 단어를 검색하고 transportSynonyms 동의어 매핑 정의를 사용하여 transport_synonyms 동의어 소스 컬렉션에서 쿼리 단어 automobile의 동의어로 구성된 단어를 검색하는 단계입니다.

   • $limit 출력을 결과 10개로 제한하는 [$limit] 단계

   • title을 제외한 모든 필드를 제외하고 score라는 필드를 추가하려면 $project 단계를 수행합니다.

   1
   package main
   2
   3
   import (
   4
   	"context"
   5
   	"fmt"
   6
   	"time"
   7
   8
   	"go.mongodb.org/mongo-driver/v2/bson"
   9
   	"go.mongodb.org/mongo-driver/v2/mongo"
   10
   	"go.mongodb.org/mongo-driver/v2/mongo/options"
   11
   )
   12
   13
   // define structure of movies collection
   14
   type MovieCollection struct {
   15
   	title string `bson:"Title,omitempty"`
   16
   }
   17
   18
   func main() {
   19
   	var err error
   20
   	// connect to the Atlas cluster
   21
   	ctx := context.Background()
   22
   	client, err := mongo.Connect(options.Client().ApplyURI("<connection-string>"))
   23
   	if err != nil {
   24
   		panic(err)
   25
   	}
   26
   	defer client.Disconnect(ctx)
   27
   	// set namespace
   28
   	collection := client.Database("sample_mflix").Collection("movies")
   29
   	// define pipeline
   30
   	searchStage := bson.D{{"$search", bson.D{{"index", "synonyms-tutorial"}, {"text", bson.D{{"path", "title"}, {"query", "automobile"}, {"synonyms", "transportSynonyms"}}}}}}
   31
   	limitStage := bson.D{{"$limit", 10}}
   32
   	projectStage := bson.D{{"$project", bson.D{{"title", 1}, {"_id", 0}, {"score", bson.D{{"$meta", "searchScore"}}}}}}
   33
   	// specify the amount of time the operation can run on the server
   34
   	opts := options.Aggregate().SetMaxTime(5 * time.Second)
   35
   	// run pipeline
   36
   	cursor, err := collection.Aggregate(ctx, mongo.Pipeline{searchStage, limitStage, projectStage}, opts)
   37
   	if err != nil {
   38
   		panic(err)
   39
   	}
   40
   	// print results
   41
   	var results []bson.D
   42
   	if err = cursor.All(context.TODO(), &results); err != nil {
   43
   		panic(err)
   44
   	}
   45
   	for _, result := range results {
   46
   		fmt.Println(result)
   47
   	}
   48
   }

3. 샘플을 실행하기 전에 <connection-string>을 Atlas 연결 문자열로 바꿉니다. 연결 문자열에는 데이터베이스 사용자의 자격 증명이 포함되어 있어야 합니다. 자세한 내용은 드라이버를 통한 연결을 참조하세요.

4. 다음 명령을 실행하여 컬렉션을 쿼리합니다.

   go run synonyms-equivalent-query.go

   synonyms-equivalent-query.go를 실행하면 프로그램은 다음 문서를 터미널에 출력합니다.

   [{title Cars} {score 4.197734832763672}]
   [{title Planes, Trains & Automobiles} {score 3.8511905670166016}]
   [{title Car Wash} {score 3.39473032951355}]
   [{title Used Cars} {score 3.39473032951355}]
   [{title Blue Car} {score 3.39473032951355}]
   [{title Cars 2} {score 3.39473032951355}]
   [{title Stealing Cars} {score 3.39473032951355}]
   [{title Cop Car} {score 3.39473032951355}]
   [{title The Cars That Eat People} {score 2.8496146202087402}]
   [{title Khrustalyov, My Car!} {score 2.8496146202087402}]

   쿼리 용어가 automobile인 경우에도 automobile을(를) 이름이 컬렉션에 대한 인덱스에 지정된 sample_synonyms인 동의어 소스 컬렉션에서 car, vehicle, automobile의 동의어로 구성했기 때문에 title 필드에 car 및 automobile이(가) 포함된 영화가 Atlas Search 결과에 포함됩니다. Atlas Search는 car 및 vehicle 단어를 검색할 때 동일한 결과를 반환합니다. 이를 테스트하려면 위 쿼리의 query 필드 값을 car 또는 vehicle 중 하나로 바꾸고 쿼리를 실행합니다.

1. synonyms-explicit-query.go이라는 파일을 만듭니다.

2. 코드 예시를 복사하여 synonyms-explicit-query.go 파일에 붙여넣습니다.

   코드 예시에는 다음 단계가 포함되어 있습니다.

   • $search 단계는 title 필드에서 boat 단어를 검색하고 transportSynonyms 동의어 매핑 정의를 사용하여 transport_synonyms 동의어 소스 컬렉션에서 쿼리 단어 boat의 동의어로 구성된 단어를 검색하는 단계입니다.

   • $limit 출력을 결과 10개로 제한하는 [$limit] 단계

   • title을 제외한 모든 필드를 제외하고 score라는 필드를 추가하려면 $project 단계를 수행합니다.

   1
   package main
   2
   3
   import (
   4
   	"context"
   5
   	"fmt"
   6
   	"time"
   7
   8
   	"go.mongodb.org/mongo-driver/v2/bson"
   9
   	"go.mongodb.org/mongo-driver/v2/mongo"
   10
   	"go.mongodb.org/mongo-driver/v2/mongo/options"
   11
   )
   12
   13
   // define structure of movies collection
   14
   type MovieCollection struct {
   15
   	title string `bson:"Title,omitempty"`
   16
   }
   17
   18
   func main() {
   19
   	var err error
   20
   	// connect to the Atlas cluster
   21
   	ctx := context.Background()
   22
   	client, err := mongo.Connect(options.Client().ApplyURI("<connection-string>"))
   23
   	if err != nil {
   24
   		panic(err)
   25
   	}
   26
   	defer client.Disconnect(ctx)
   27
   	// set namespace
   28
   	collection := client.Database("sample_mflix").Collection("movies")
   29
   	// define pipeline
   30
   	searchStage := bson.D{{"$search", bson.D{{"text", bson.D{{"index", "synonyms-tutorial"}, {"path", "title"}, {"query", "boat"}, {"synonyms", "transportSynonyms"}}}}}}
   31
   	limitStage := bson.D{{"$limit", 10}}
   32
   	projectStage := bson.D{{"$project", bson.D{{"title", 1}, {"_id", 0}, {"score", bson.D{{"$meta", "searchScore"}}}}}}
   33
   	// specify the amount of time the operation can run on the server
   34
   	opts := options.Aggregate().SetMaxTime(5 * time.Second)
   35
   	// run pipeline
   36
   	cursor, err := collection.Aggregate(ctx, mongo.Pipeline{searchStage, limitStage, projectStage}, opts)
   37
   	if err != nil {
   38
   		panic(err)
   39
   	}
   40
   	// print results
   41
   	var results []bson.D
   42
   	if err = cursor.All(context.TODO(), &results); err != nil {
   43
   		panic(err)
   44
   	}
   45
   	for _, result := range results {
   46
   		fmt.Println(result)
   47
   	}
   48
   }

3. 샘플을 실행하기 전에 <connection-string>을 Atlas 연결 문자열로 바꿉니다. 연결 문자열에는 데이터베이스 사용자의 자격 증명이 포함되어 있어야 합니다. 자세한 내용은 드라이버를 통한 연결을 참조하세요.

4. 다음 명령을 실행하여 컬렉션을 쿼리합니다.

   go run synonyms-explicit-query.go

   출력 숨기기

   [{title Vessel} {score 5.373150825500488}]
   [{title Boats} {score 4.589139938354492}]
   [{title And the Ship Sails On} {score 4.3452959060668945}]
   [{title Broken Vessels} {score 4.3452959060668945}]
   [{title Sailing to Paradise} {score 4.3452959060668945}]
   [{title Boat People} {score 3.711261749267578}]
   [{title Boat Trip} {score 3.711261749267578}]
   [{title Three Men in a Boat} {score 3.1153182983398438}]
   [{title The Glass Bottom Boat} {score 3.1153182983398438}]
   [{title Jack Goes Boating} {score 3.1153182983398438}]

   title 필드에 boat, vessel, sail이 있는 영화가 Atlas Search 결과에 포함됩니다. 이는 컬렉션의 인덱스에 지정된 sample_synonyms라는 동의어 소스 컬렉션에서 boat, vessel, sail을 boat 동의어로 구성했기 때문입니다.

   Atlas Search는 결과에서 vessel 단어를 검색한 경우에만 다음 문서를 반환합니다.

   { "title" : "Vessel", "score" : 5.373150825500488 }
   { "title" : "Broken Vessels", "score" : 4.3452959060668945 }

   Atlas Search는 title 필드에 boat 또는 sail이 포함된 문서를 결과에 포함하지 않습니다. 이는 동의어 소스 컬렉션에서 vessel을 boat 또는 sail의 동의어로 구성하지 않았기 때문입니다. 이를 테스트하려면 위 쿼리의 query 필드 값을 vessel로 바꾸고 쿼리를 다시 실행합니다.

   마찬가지로, Atlas Search는 sail 검색어에 대한 검색 결과에서만 다음 문서를 반환합니다.

   { "title" : "And the Ship Sails On", "score" : 4.3452959060668945 }
   { "title" : "Sailing to Paradise", "score" : 4.3452959060668945 }

   Atlas Search는 결과에서 title 필드에 boat 또는 vessel이 포함된 문서를 제외합니다. 이는 우리가 synonyms 소스 컬렉션에서 sail을 boat 또는 vessel의 동의어로 설정하지 않았기 때문입니다. 이 예시를 테스트하려면 위의 쿼리에서 query 필드의 값을 sail로 바꾼 후 쿼리를 다시 실행해 보세요.

1. synonyms-equivalent-query.go이라는 파일을 만듭니다.

2. 코드 예시를 복사하여 synonyms-equivalent-query.go 파일에 붙여넣습니다.

   코드 예시에는 다음 단계가 포함되어 있습니다.

   • $search 단계는 title 필드에서 automobile 단어를 검색하고 transportSynonyms 동의어 매핑 정의를 사용하여 transport_synonyms 동의어 소스 컬렉션에서 쿼리 단어 automobile의 동의어로 구성된 단어를 검색하는 단계입니다. 쿼리는 attire 단어에 대한 title 필드도 검색하고 attireSynonyms 동의어 매핑 정의를 사용하여 attire_synonyms 동의어 소스 컬렉션에서 쿼리 단어 attire의 동의어로 구성된 단어를 검색합니다.

   • $limit 출력을 결과 10개로 제한하는 [$limit] 단계

   • title을 제외한 모든 필드를 제외하고 score라는 필드를 추가하려면 $project 단계를 수행합니다.

   1
   package main
   2
   3
   import (
   4
   	"context"
   5
   	"fmt"
   6
   	"time"
   7
   8
   	"go.mongodb.org/mongo-driver/v2/bson"
   9
   	"go.mongodb.org/mongo-driver/v2/mongo"
   10
   	"go.mongodb.org/mongo-driver/v2/mongo/options"
   11
   )
   12
   13
   // define structure of movies collection
   14
   type MovieCollection struct {
   15
   	title string `bson:"Title,omitempty"`
   16
   }
   17
   18
   func main() {
   19
   	var err error
   20
   	// connect to the Atlas cluster
   21
   	ctx := context.Background()
   22
   	client, err := mongo.Connect(options.Client().ApplyURI("<connection-string>"))
   23
   	if err != nil {
   24
   		panic(err)
   25
   	}
   26
   	defer client.Disconnect(ctx)
   27
   	// set namespace
   28
   	collection := client.Database("sample_mflix").Collection("movies")
   29
   	// define pipeline
   30
   	searchStage := bson.D{{"$search", bson.M{
   31
   		"index": "synonyms-tutorial",
   32
   		"compound": bson.M{
   33
   			"should": bson.A{
   34
   				bson.M{
   35
   					"text": bson.D{
   36
   						{"path", "title"}, {"query", "automobile"}, {"synonyms", "transportSynonyms"},
   37
   					},
   38
   				},
   39
   				bson.M{
   40
   					"text": bson.D{
   41
   						{"path", "title"}, {"query", "attire"}, {"synonyms", "attireSynonyms"},
   42
   					},
   43
   				},
   44
   			},
   45
   		},
   46
   	}}}
   47
   	limitStage := bson.D{{"$limit", 10}}
   48
   	projectStage := bson.D{{"$project", bson.D{{"title", 1}, {"_id", 0}, {"score", bson.D{{"$meta", "searchScore"}}}}}}
   49
   	// specify the amount of time the operation can run on the server
   50
   	opts := options.Aggregate().SetMaxTime(5 * time.Second)
   51
   	// run pipeline
   52
   	cursor, err := collection.Aggregate(ctx, mongo.Pipeline{searchStage, limitStage, projectStage}, opts)
   53
   	if err != nil {
   54
   		panic(err)
   55
   	}
   56
   	// print results
   57
   	var results []bson.D
   58
   	if err = cursor.All(context.TODO(), &results); err != nil {
   59
   		panic(err)
   60
   	}
   61
   	for _, result := range results {
   62
   		fmt.Println(result)
   63
   	}
   64
   }

3. 샘플을 실행하기 전에 <connection-string>을 Atlas 연결 문자열로 바꿉니다. 연결 문자열에는 데이터베이스 사용자의 자격 증명이 포함되어 있어야 합니다. 자세한 내용은 드라이버를 통한 연결을 참조하세요.

4. 다음 명령을 실행하여 컬렉션을 쿼리합니다.

   go run synonyms-equivalent-query.go

   출력 숨기기

   [{title The Dress} {score 4.812004089355469}]
   [{title Cars} {score 4.197734832763672}]
   [{title Dressed to Kill} {score 3.891493320465088}]
   [{title 27 Dresses} {score 3.891493320465088}]
   [{title Planes, Trains & Automobiles} {score 3.8511905670166016}]
   [{title Car Wash} {score 3.39473032951355}]
   [{title Used Cars} {score 3.39473032951355}]
   [{title Blue Car} {score 3.39473032951355}]
   [{title Cars 2} {score 3.39473032951355}]
   [{title Stealing Cars} {score 3.39473032951355}]

   Atlas Search 결과에는 두 검색어에 대한 문서가 모두 포함되어 있습니다. 결과에는 쿼리 용어 automobile에 대하여 title 필드에 car이(가) 포함된 영화가 포함됩니다. 이는 transport_synonyms 동의어 소스 컬렉션에서 automobile을(를) car, vehicle 및 automobile의 동의어로 구성했기 때문입니다. 결과에는 쿼리 용어 attire에 대하여 제목 필드에 dress이(가) 포함된 영화도 포함됩니다. 이는 attire_synonyms 동의어 소스 컬렉션에서 attire을(를) dress, apparel 및 attire의 동의어로 구성했기 때문입니다.

   Atlas Search는 transport_synonyms 소스 컬렉션에서 car 또는 vehicle을(를) 검색하고 attire_synonyms 소스 컬렉션에서 dress 또는 apparel을(를) 검색할 때 동일한 결과를 반환합니다. 이 예시를 테스트하려면 위 쿼리의 query 필드 값을 car 또는 vehicle(으)로 바꾸고 위 쿼리의 query 필드 값을 dress 또는 apparel(으)로 바꾼 다음 쿼리를 다시 실행합니다.

1. synonyms-explicit-query.go이라는 파일을 만듭니다.

2. 코드 예시를 복사하여 synonyms-explicit-query.go 파일에 붙여넣습니다.

   코드 예시에는 다음 단계가 포함되어 있습니다.

   • $search 단계는 title 필드에서 boat 단어를 검색하고 transportSynonyms 동의어 매핑 정의를 사용하여 transport_synonyms 동의어 소스 컬렉션에서 쿼리 단어 boat의 동의어로 구성된 단어를 검색하는 단계입니다. 쿼리는 hat 단어에 대한 title 필드도 검색하고 attireSynonyms 동의어 매핑 정의를 사용하여 attire_synonyms 동의어 소스 컬렉션에서 쿼리 단어 hat의 동의어로 구성된 단어를 검색합니다.

   • $limit 출력을 결과 10개로 제한하는 [$limit] 단계

   • title을 제외한 모든 필드를 제외하고 score라는 필드를 추가하려면 $project 단계를 수행합니다.

   1
   package main
   2
   3
   import (
   4
   	"context"
   5
   	"fmt"
   6
   	"time"
   7
   8
   	"go.mongodb.org/mongo-driver/v2/bson"
   9
   	"go.mongodb.org/mongo-driver/v2/mongo"
   10
   	"go.mongodb.org/mongo-driver/v2/mongo/options"
   11
   )
   12
   13
   // define structure of movies collection
   14
   type MovieCollection struct {
   15
   	title string `bson:"Title,omitempty"`
   16
   }
   17
   18
   func main() {
   19
   	var err error
   20
   	// connect to the Atlas cluster
   21
   	ctx := context.Background()
   22
   	client, err := mongo.Connect(options.Client().ApplyURI("<connection-string>"))
   23
   	if err != nil {
   24
   		panic(err)
   25
   	}
   26
   	defer client.Disconnect(ctx)
   27
   	// set namespace
   28
   	collection := client.Database("sample_mflix").Collection("movies")
   29
   	// define pipeline
   30
   	searchStage := bson.D{{"$search", bson.M{
   31
   		"index": "synonyms-tutorial",
   32
   		"compound": bson.M{
   33
   			"must": bson.A{
   34
   				bson.M{
   35
   					"text": bson.D{
   36
   						{"path", "title"}, {"query", "boat"}, {"synonyms", "transportSynonyms"},
   37
   					},
   38
   				},
   39
   				bson.M{
   40
   					"text": bson.D{
   41
   						{"path", "title"}, {"query", "hat"}, {"synonyms", "attireSynonyms"},
   42
   					},
   43
   				},
   44
   			},
   45
   		},
   46
   	}}}
   47
   	limitStage := bson.D{{"$limit", 10}}
   48
   	projectStage := bson.D{{"$project", bson.D{{"title", 1}, {"_id", 0}, {"score", bson.D{{"$meta", "searchScore"}}}}}}
   49
   	// specify the amount of time the operation can run on the server
   50
   	opts := options.Aggregate().SetMaxTime(5 * time.Second)
   51
   	// run pipeline
   52
   	cursor, err := collection.Aggregate(ctx, mongo.Pipeline{searchStage, limitStage, projectStage}, opts)
   53
   	if err != nil {
   54
   		panic(err)
   55
   	}
   56
   	// print results
   57
   	var results []bson.D
   58
   	if err = cursor.All(context.TODO(), &results); err != nil {
   59
   		panic(err)
   60
   	}
   61
   	for _, result := range results {
   62
   		fmt.Println(result)
   63
   	}
   64
   }

3. 샘플을 실행하기 전에 <connection-string>을 Atlas 연결 문자열로 바꿉니다. 연결 문자열에는 데이터베이스 사용자의 자격 증명이 포함되어 있어야 합니다. 자세한 내용은 드라이버를 통한 연결을 참조하세요.

4. 다음 명령을 실행하여 컬렉션을 쿼리합니다.

   go run synonyms-explicit-query.go

   출력 숨기기

   [{title Fedora} {score 5.673145294189453}]
   [{title Vessel} {score 5.373150825500488}]
   [{title Boats} {score 4.589139938354492}]
   [{title And the Ship Sails On} {score 4.3452959060668945}]
   [{title Broken Vessels} {score 4.3452959060668945}]
   [{title Sailing to Paradise} {score 4.3452959060668945}]
   [{title Top Hat} {score 4.066137313842773}]
   [{title A Hatful of Rain} {score 4.066137313842773}]
   [{title Boat People} {score 3.711261749267578}]
   [{title Boat Trip} {score 3.711261749267578}]

   Atlas Search 결과에 두 검색어에 대한 문서가 모두 포함됩니다. 검색어 boat에 대해 title 필드에 vessel, boat, sail이 있는 영화가 결과에 포함됩니다. 이는 transport_synonyms라는 동의어 소스 컬렉션에서 boat를 boat, vessel, sail의 동의어로 구성했기 때문입니다.

   Atlas Search는 vessel 용어 검색 결과에서 title 필드에 boat 또는 sail이 포함된 문서를 제외합니다. 동의어 소스 컬렉션에서 vessel을 boat 또는 sail의 동의어로 구성하지 않았기 때문입니다. 마찬가지로, Atlas Search는 sail 용어 검색 결과의 title 필드에 boat 또는 vessel이 포함된 문서를 제외합니다. 동의어 소스 컬렉션에서 sail을 boat 또는 vessel의 동의어로 구성하지 않았기 때문입니다. 이러한 예를 테스트하려면 위 쿼리의 query 필드 값을 vessel 또는 sail로 바꾸고 쿼리를 다시 실행하세요.

   검색어 hat에 대하여 제목 필드에 fedora 및 hat이 있는 동영상도 결과에 포함됩니다. attire_synonyms라는 동의어 소스 컬렉션에서 hat을 hat, fedora, headgear 동의어로 구성했기 때문입니다.

   Atlas Search는 headgear 용어 검색 결과에서 title 필드에 hat 또는 fedora이 포함된 문서를 제외합니다. 동의어 소스 컬렉션에서 headgear을 hat 또는 fedora의 동의어로 구성하지 않았기 때문입니다. 마찬가지로, Atlas Search는 fedora 용어 검색 결과의 title 필드에 hat 또는 headgear이 포함된 문서를 제외합니다. 동의어 소스 컬렉션에서 fedora을 hat 또는 headgear의 동의어로 구성하지 않았기 때문입니다. 이러한 예를 테스트하려면 위 쿼리의 query 필드 값을 fedora 또는 headgear로 바꾸고 쿼리를 다시 실행하세요.

1. SynonymsEquivalentQuery.java이라는 파일을 만듭니다.

2. 다음 코드를 복사하여 파일에 붙여넣습니다.

   코드 예시에는 다음 단계가 포함되어 있습니다.

   • $search 단계는 title 필드에서 automobile 단어를 검색하고 transportSynonyms 동의어 매핑 정의를 사용하여 transport_synonyms 동의어 소스 컬렉션에서 쿼리 단어 automobile의 동의어로 구성된 단어를 검색하는 단계입니다.

   • $limit 출력을 결과 10개로 제한하는 [$limit] 단계

   • title을 제외한 모든 필드를 제외하고 score라는 필드를 추가하려면 $project 단계를 수행합니다.

   1
   import java.util.Arrays;
   2
   import static com.mongodb.client.model.Filters.eq;
   3
   import static com.mongodb.client.model.Aggregates.limit;
   4
   import static com.mongodb.client.model.Aggregates.project;
   5
   import static com.mongodb.client.model.Projections.excludeId;
   6
   import static com.mongodb.client.model.Projections.fields;
   7
   import static com.mongodb.client.model.Projections.include;
   8
   import static com.mongodb.client.model.Projections.computed;
   9
   import com.mongodb.client.MongoClient;
   10
   import com.mongodb.client.MongoClients;
   11
   import com.mongodb.client.MongoCollection;
   12
   import com.mongodb.client.MongoDatabase;
   13
   import org.bson.Document;
   14
   15
   public class SynonymsEquivalentQuery {
   16
     public static void main( String[] args ) {
   17
       // define query
   18
       Document agg = new Document("$search",
   19
           new Document("index", "synonyms-tutorial")
   20
           .append("text", 
   21
               new Document("query", "automobile")
   22
               .append("path","title")
   23
               .append("synonyms", "transportSynonyms")));
   24
   25
       // specify connection
   26
       String uri = "<connection-string>";
   27
   28
       // establish connection and set namespace
   29
       try (MongoClient mongoClient = MongoClients.create(uri)) {
   30
         MongoDatabase database = mongoClient.getDatabase("sample_mflix");
   31
         MongoCollection<Document> collection = database.getCollection("movies");
   32
         
   33
   			// run query and print results
   34
         collection.aggregate(Arrays.asList(agg, 
   35
           limit(10), 
   36
           project(fields(excludeId(), include("title"), computed("score", new Document("$meta", "searchScore")))))
   37
         ).forEach(doc -> System.out.println(doc.toJson()));	
   38
       }
   39
     }
   40
   }

   참고

   Maven 환경에서 샘플 코드를 실행하려면 파일의 가져오기 문 위에 다음을 추가하세요.

   package com.mongodb.drivers;

3. 샘플을 실행하기 전에 <connection-string>을 Atlas 연결 문자열로 바꿉니다. 연결 문자열에는 데이터베이스 사용자의 자격 증명이 포함되어 있어야 합니다. 자세한 내용은 드라이버를 통한 연결을 참조하세요.

4. SynonymsEquivalentQuery.java 파일을 컴파일하고 실행합니다.

   javac SynonymsEquivalentQuery.java
   java SynonymsEquivalentQuery

   출력 숨기기

   {"title": "Cars", "score": 4.197734832763672}
   {"title": "Planes, Trains & Automobiles", "score": 3.8511905670166016}
   {"title": "Car Wash", "score": 3.39473032951355}
   {"title": "Used Cars", "score": 3.39473032951355}
   {"title": "Blue Car", "score": 3.39473032951355}
   {"title": "Cars 2", "score": 3.39473032951355}
   {"title": "Stealing Cars", "score": 3.39473032951355}
   {"title": "Cop Car", "score": 3.39473032951355}
   {"title": "The Cars That Eat People", "score": 2.8496146202087402}
   {"title": "Khrustalyov, My Car!", "score": 2.8496146202087402}

   쿼리 용어가 automobile인 경우에도 automobile을(를) 이름이 컬렉션에 대한 인덱스에 지정된 sample_synonyms인 동의어 소스 컬렉션에서 car, vehicle, automobile의 동의어로 구성했기 때문에 title 필드에 car 및 automobile이(가) 포함된 영화가 Atlas Search 결과에 포함됩니다. Atlas Search는 car 및 vehicle 단어를 검색할 때 동일한 결과를 반환합니다. 이를 테스트하려면 위 쿼리의 query 필드 값을 car 또는 vehicle 중 하나로 바꾸고 쿼리를 실행합니다.

1. SynonymsExplicitQuery.java이라는 파일을 만듭니다.

2. 다음 코드를 복사하여 파일에 붙여넣습니다.

   코드 예시에는 다음 단계가 포함되어 있습니다.

   • $search 단계는 title 필드에서 boat 단어를 검색하고 transportSynonyms 동의어 매핑 정의를 사용하여 transport_synonyms 동의어 소스 컬렉션에서 쿼리 단어 boat의 동의어로 구성된 단어를 검색하는 단계입니다.

   • $limit 출력을 결과 10개로 제한하는 [$limit] 단계

   • title을 제외한 모든 필드를 제외하고 score라는 필드를 추가하려면 $project 단계를 수행합니다.

   1
   import java.util.Arrays;
   2
   import static com.mongodb.client.model.Filters.eq;
   3
   import static com.mongodb.client.model.Aggregates.limit;
   4
   import static com.mongodb.client.model.Aggregates.project;
   5
   import static com.mongodb.client.model.Projections.excludeId;
   6
   import static com.mongodb.client.model.Projections.fields;
   7
   import static com.mongodb.client.model.Projections.include;
   8
   import static com.mongodb.client.model.Projections.computed;
   9
   import com.mongodb.client.MongoClient;
   10
   import com.mongodb.client.MongoClients;
   11
   import com.mongodb.client.MongoCollection;
   12
   import com.mongodb.client.MongoDatabase;
   13
   import org.bson.Document;
   14
   15
   public class SynonymsExplicitQuery {
   16
     public static void main( String[] args ) {
   17
       // define query
   18
       Document agg = new Document("$search",
   19
           new Document("index", "synonyms-tutorial")
   20
           .append("text", 
   21
               new Document("query", "boat")
   22
               .append("path","title")
   23
               .append("synonyms", "transportSynonyms")));
   24
   25
       // specify connection
   26
       String uri = "<connection-string>";
   27
   28
       // establish connection and set namespace
   29
       try (MongoClient mongoClient = MongoClients.create(uri)) {
   30
         MongoDatabase database = mongoClient.getDatabase("sample_mflix");
   31
         MongoCollection<Document> collection = database.getCollection("movies");
   32
   			
   33
         // run query and print results
   34
         collection.aggregate(Arrays.asList(agg, 
   35
           limit(10), 
   36
           project(fields(excludeId(), include("title"), computed("score", new Document("$meta", "searchScore")))))
   37
         ).forEach(doc -> System.out.println(doc.toJson()));	
   38
       }
   39
     }
   40
   }

   참고

   Maven 환경에서 샘플 코드를 실행하려면 파일의 가져오기 문 위에 다음을 추가하세요.

   package com.mongodb.drivers;

3. 샘플을 실행하기 전에 <connection-string>을 Atlas 연결 문자열로 바꿉니다. 연결 문자열에는 데이터베이스 사용자의 자격 증명이 포함되어 있어야 합니다. 자세한 내용은 드라이버를 통한 연결을 참조하세요.

4. SynonymsExplicitQuery.java 파일을 컴파일하고 실행합니다.

   javac SynonymsExplicitQuery.java
   java SynonymsExplicitQuery

   출력 숨기기

   {"title": "Vessel", "score": 5.373150825500488}
   {"title": "Boats", "score": 4.589139938354492}
   {"title": "And the Ship Sails On", "score": 4.3452959060668945}
   {"title": "Broken Vessels", "score": 4.3452959060668945}
   {"title": "Sailing to Paradise", "score": 4.3452959060668945}
   {"title": "Boat People", "score": 3.711261749267578}
   {"title": "Boat Trip", "score": 3.711261749267578}
   {"title": "Three Men in a Boat", "score": 3.1153182983398438}
   {"title": "The Glass Bottom Boat", "score": 3.1153182983398438}
   {"title": "Jack Goes Boating", "score": 3.1153182983398438}

   title 필드에 boat, vessel, sail이 있는 영화가 Atlas Search 결과에 포함됩니다. 이는 컬렉션의 인덱스에 지정된 sample_synonyms라는 동의어 소스 컬렉션에서 boat, vessel, sail을 boat 동의어로 구성했기 때문입니다.

   Atlas Search는 결과에서 vessel 단어를 검색한 경우에만 다음 문서를 반환합니다.

   { "title" : "Vessel", "score" : 5.373150825500488 }
   { "title" : "Broken Vessels", "score" : 4.3452959060668945 }

   Atlas Search는 title 필드에 boat 또는 sail이 포함된 문서를 결과에 포함하지 않습니다. 이는 동의어 소스 컬렉션에서 vessel을 boat 또는 sail의 동의어로 구성하지 않았기 때문입니다. 이를 테스트하려면 위 쿼리의 query 필드 값을 vessel로 바꾸고 쿼리를 다시 실행합니다.

   마찬가지로, Atlas Search는 sail 검색어에 대한 검색 결과에서만 다음 문서를 반환합니다.

   { "title" : "And the Ship Sails On", "score" : 4.3452959060668945 }
   { "title" : "Sailing to Paradise", "score" : 4.3452959060668945 }

   Atlas Search는 결과에서 title 필드에 boat 또는 vessel이 포함된 문서를 제외합니다. 이는 우리가 synonyms 소스 컬렉션에서 sail을 boat 또는 vessel의 동의어로 설정하지 않았기 때문입니다. 이 예시를 테스트하려면 위의 쿼리에서 query 필드의 값을 sail로 바꾼 후 쿼리를 다시 실행해 보세요.