검색 인덱스 파티셔닝 유형

검색 인덱스는 다음에서 파티션 유형을 상속합니다. options.partitioned 디자인 문서의 해당 필드에 포함됩니다.

Index 함수

존재하지 않는 데이터 필드를 사용하여 인덱싱하려고 시도하는 경우 해당 시도가 실패합니다. 이 문제점을 방지하려면 적절한 보호 절을 사용하십시오.

인덱싱 함수는 문서 자체가 해당 환경에서 사용되는 메모리의 일부를 구성하는 메모리 제한 환경에서 작동합니다. 코드의 스택 및 문서가 이 메모리 내에 들어가야 합니다. 문서의 최대 크기는 64MB입니다.

검색 인덱스 내에서 동일한 필드 이름을 둘 이상의 데이터 유형으로 인덱싱하지 마십시오. 동일한 검색 index 함수에서 동일한 필드 이름이 서로 다른 데이터 유형으로 인덱싱되는 경우 오류가 발생할 수 있습니다. was indexed without position data 라는 필드를 가리키는 검색 인덱스를 쿼리할 때 이 오류가 발생합니다. 예를 들어 동일한 검색 index 함수에 이러한 두 개의 행을 모두 포함시키지 마십시오. 다음 행은 myfield 필드를 두 개의 서로 다른 데이터 유형인 문자열 "this is a string" 및 숫자 123으로 인덱싱합니다.

index("myfield", "this is a string");
index("myfield", 123);

인덱스 필드에 포함된 함수는 데이터베이스에 있는 각각의 문서에 대해 호출되는 JavaScript 함수입니다. 이 함수는 문서를 매개변수로 사용하고 해당 문서에서 일부 데이터를 추출한 후 index 필드에 정의된 함수를 호출하여 해당 데이터를 인덱싱합니다.

index 함수에서는 세 개의 매개변수를 사용하며, 여기서 세 번째 매개변수는 선택사항입니다.

첫 번째 매개변수는 인덱스를 쿼리할 때 사용할 필드의 이름입니다. 이는 이후 쿼리의 Lucene 구문 부분에 지정되어 있습니다. 다음 조회에 예제가 표시되어 있습니다.

query=color:red

Lucene 필드 이름 color는 index 함수의 첫 번째 매개변수입니다.

query 매개변수는 q로 축약될 수 있기 때문에 다음 예제에서는 해당 조회를 다른 방식으로 작성하는 방법을 보여줍니다.

q=color:red

이름을 정의할 때 특수 값인 "default"가 사용되는 경우 조회 시 필드 이름을 지정할 필요가 없습니다. 이를 통해 조회를 단순화할 수 있습니다.

query=red

두 번째 매개변수는 인덱싱할 데이터입니다. 데이터를 인덱싱하는 경우 다음과 같은 정보를 기억해 두십시오.

• 이 데이터는 문자열, 숫자 또는 부울이어야 합니다. 다른 유형의 경우 index 함수 호출 시 오류가 리턴됩니다.
• 함수를 실행할 때 오류가 리턴되는 경우 이러한 이유 또는 다른 이유로 해당 검색 인덱스에 문서가 추가되지 않습니다.

선택사항인 세 번째 매개변수는 다음과 같은 필드가 포함된 JavaScript 오브젝트입니다.

store 매개변수를 설정하지 않을 경우 조회에 대한 응답에서 문서에 대한 인덱스 데이터 결과가 리턴되지 않습니다.

다음과 같이 검색 index 함수 예제를 참조하십시오.

function(doc) {
	index("default", doc._id);
	if (doc.min_length) {
		index("min_length", doc.min_length, {"store": true});
	}
	if (doc.diet) {
		index("diet", doc.diet, {"store": true});
	}
	if (doc.latin_name) {
		index("latin_name", doc.latin_name, {"store": true});
	}
	if (doc.class) {
		index("class", doc.class, {"store": true});
	}
}

if (doc.min_length) {
	index("min_length", doc.min_length, {"store": true});
}

if (typeof doc.min_length === 'number') {
    index("min_length", doc.min_length, {"store": true});
}

if (typeof doc.min_length) !== 'undefined') {
	// The field exists, and does have a type, so we can proceed to index using it.
	...
}

분석기

분석기는 텍스트 내에 있는 용어를 인식하는 방법을 정의하는 설정입니다. 자세한 내용은 검색 분석기를 참조하세요.

분석기는 복수의 언어를 인덱싱해야 하는 경우에 유용합니다.

다음 표는 IBM Cloudant 검색에서 지원되는 일반 분석기 목록입니다:

다음과 같이 분석기 문서 예제를 참조하십시오.

{
	"_id": "_design/analyzer_example",
	"indexes": {
		"INDEX_NAME": {
			"index": "function (doc) { ... }",
			"analyzer": "$ANALYZER_NAME"
		}
	}
}

{
	"_id": "_design/analyzer_example",
	"indexes": {
		"INDEX_NAME": {
			"analyzer": {
				"name": "perfield",
				"default": "english",
				"fields": {
					"spanish": "spanish",
					"german": "german"
				}
			},
			"index": "function (doc) { ... }"
		}
	}
}

 "a", "an", "and", "are", "as", "at", "be", "but", "by", "for", "if",
 "in", "into", "is", "it", "no", "not", "of", "on", "or", "such",
 "that", "the", "their", "then", "there", "these", "they", "this",
 "to", "was", "will", "with"

{
	"_id": "_design/stop_words_example",
	"indexes": {
		"INDEX_NAME": {
			"analyzer": {
				"name": "portuguese",
				"stopwords": [
					"foo",
					"bar",
					"baz"
				]
			},
			"index": "function (doc) { ... }"
		}
	}
}

Host: $ACCOUNT.cloudant.com
POST /_search_analyze HTTP/1.1
Content-Type: application/json
{"analyzer":"keyword", "text":"ablanks@renovations.com"}

curl "https://$ACCOUNT.cloudant.com/_search_analyze" \
	-H "Content-Type: application/json" \
	-d '{"analyzer":"keyword", "text":"ablanks@renovations.com"}'

import com.ibm.cloud.cloudant.v1.Cloudant;
import com.ibm.cloud.cloudant.v1.model.PostSearchAnalyzeOptions;
import com.ibm.cloud.cloudant.v1.model.SearchAnalyzeResult;

Cloudant service = Cloudant.newInstance();

PostSearchAnalyzeOptions searchAnalyzerOptions =
    new PostSearchAnalyzeOptions.Builder()
        .analyzer("keyword")
        .text("ablanks@renovations.com")
        .build();

SearchAnalyzeResult response =
    service.postSearchAnalyze(searchAnalyzerOptions).execute()
        .getResult();

System.out.println(response);

import { CloudantV1 } from '@ibm-cloud/cloudant';

const service = CloudantV1.newInstance({});

service.postSearchAnalyze({
	analyzer: 'keyword',
	text: 'ablanks@renovations.com',
}).then(response => {
	console.log(response.result);
});

from ibmcloudant.cloudant_v1 import CloudantV1

service = CloudantV1.new_instance()

response = service.post_search_analyze(
	analyzer='keyword',
	text='ablanks@renovations.com'
).get_result()

print(response)

postSearchAnalyzeOptions := service.NewPostSearchAnalyzeOptions(
	"keyword",
	"ablanks@renovations.com",
)

searchAnalyzeResult, _, err := service.PostSearchAnalyze(postSearchAnalyzeOptions)
if err != nil {
	panic(err)
}

b, _ := json.MarshalIndent(searchAnalyzeResult, "", "  ")
fmt.Println(string(b))

import (
   "encoding/json"
   "fmt"
   "github.com/IBM/cloudant-go-sdk/cloudantv1"
)

{
	"tokens": [
		"ablanks@renovations.com"
	]
}

Host: $ACCOUNT.cloudant.com
POST /_search_analyze HTTP/1.1
Content-Type: application/json
{"analyzer":"standard", "text":"ablanks@renovations.com"}

curl "https://$ACCOUNT.cloudant.com/_search_analyze" -H "Content-Type: application/json"
	-d '{"analyzer":"standard", "text":"ablanks@renovations.com"}'

{
	"tokens": [
		"ablanks",
		"renovations.com"
	]
}

쿼리

검색 인덱스를 작성한 후에는 해당 인덱스를 조회할 수 있습니다.

• 다음 요청을 사용하여 파티션 조회를 실행하십시오.

  GET /$DATABASE/_partition/$PARTITION_KEY/_design/$DDOC/_search/$INDEX_NAME
  

• 다음 요청을 사용하여 글로벌 조회를 실행하십시오.

  GET /$DATABASE/_design/$DDOC/_search/$INDEX_NAME
  

query 매개변수를 사용하여 검색을 지정하십시오.

다음과 같이 HTTP를 사용하여 파티션된 인덱스를 조회하는 예제를 참조하십시오.

GET /$DATABASE/_partition/$PARTITION_KEY/_design/$DDOC/_search/$INDEX_NAME?include_docs=true&query="*:*"&limit=1 HTTP/1.1
Content-Type: application/json
Host: $ACCOUNT.cloudant.com

다음과 같이 명령행을 사용하여 파티션된 인덱스를 조회하는 예제를 참조하십시오.

curl "https://$ACCOUNT.cloudant.com/$DATABASE/_partition/$PARTITION_KEY/_design/$DDOC/_search/$INDEX_NAME?include_docs=true&query=\"*:*\"&limit=1"

import com.ibm.cloud.cloudant.v1.Cloudant;
import com.ibm.cloud.cloudant.v1.model.PostPartitionSearchOptions;
import com.ibm.cloud.cloudant.v1.model.SearchResult;

Cloudant service = Cloudant.newInstance();

PostPartitionSearchOptions searchOptions =
    new PostPartitionSearchOptions.Builder()
		.db("<db-name>")
		.partitionKey("<partition-key>")
		.ddoc("<ddoc>")
		.index("<index-name>")
		.query("*:*")
		.includeDocs(true)
		.limit(1)
		.build();

SearchResult response =
    service.postPartitionSearch(searchOptions).execute()
        .getResult();

System.out.println(response);

import { CloudantV1 } from '@ibm-cloud/cloudant';

const service = CloudantV1.newInstance({});

service.postSearch({
	db: '<db-name>',
	partitionKey: '<partition-key>',
	ddoc: '<ddoc>',
	index: '<index-name>',
	query: '*:*',
	includeDocs: true,
	limit: 1
}).then(response => {
	console.log(response.result);
});

from ibmcloudant.cloudant_v1 import CloudantV1

service = CloudantV1.new_instance()

response = service.post_search(
	db='<db-name>',
	partition_key='<partition-key>',
	ddoc='<ddoc>',
	index='<index-name>',
	query='*:*',
	include_docs=True,
	limit=1
).get_result()

print(response)

postPartitionSearchOptions := service.NewPostPartitionSearchOptions(
	"<db-name>",
	"<partition-key>",
	"<ddoc>",
	"<index-name>",
	"*:*",
)
postPartitionSearchOptions.SetIncludeDocs(true)
postPartitionSearchOptions.SetLimit(1)

searchResult, _, err := service.PostPartitionSearch(postPartitionSearchOptions)
if err != nil {
	panic(err)
}

b, _ := json.MarshalIndent(searchResult, "", "  ")
fmt.Println(string(b))

이전 Go 예제에서는 다음 가져오기 블록이 필요합니다.

import (
   "encoding/json"
   "fmt"
   "github.com/IBM/cloudant-go-sdk/cloudantv1"
)

다음과 같이 HTTP를 사용하여 글로벌 인덱스를 조회하는 예제를 참조하십시오.

GET /$DATABASE/_design/$DDOC/_search/$INDEX_NAME?include_docs=true&query="*:*"&limit=1 HTTP/1.1
Content-Type: application/json
Host: $ACCOUNT.cloudant.com

다음과 같이 명령행을 사용하여 글로벌 인덱스를 조회하는 예제를 참조하십시오.

curl "https://$ACCOUNT.cloudant.com/$DATABASE/_design/$DDOC/_search/$INDEX_NAME?include_docs=true&query=\"*:*\"&limit=1"

import com.ibm.cloud.cloudant.v1.Cloudant;
import com.ibm.cloud.cloudant.v1.model.PostSearchOptions;
import com.ibm.cloud.cloudant.v1.model.SearchResult;

Cloudant service = Cloudant.newInstance();

PostSearchOptions searchOptions = new PostSearchOptions.Builder()
    .db("<db-name>")
    .ddoc("<ddoc>")
    .index("<index-name>")
    .query("*:*")
	.includeDocs(true)
	.limit(1)
    .build();

SearchResult response =
    service.postSearch(searchOptions).execute()
        .getResult();

System.out.println(response);

import { CloudantV1 } from '@ibm-cloud/cloudant';

const service = CloudantV1.newInstance({});

service.postSearch({
	db: '<db-name>',
	ddoc: '<ddoc>',
	index: '<index-name>',
	query: '*:*',
	includeDocs: true,
	limit: 1
}).then(response => {
	console.log(response.result);
});

from ibmcloudant.cloudant_v1 import CloudantV1

service = CloudantV1.new_instance()

response = service.post_search(
	db='<db-name>',
	ddoc='<ddoc>',
	index='<index-name>',
	query='*:*',
	include_docs=True,
	limit=1
).get_result()

print(response)

postSearchOptions := service.NewPostSearchOptions(
	"<db-name>",
	"<ddoc>",
	"<index-name>",
	"*:*",
)
postSearchOptions.SetIncludeDocs(true)
postSearchOptions.SetLimit(1)

searchResult, _, err := service.PostSearch(postSearchOptions)
if err != nil {
	panic(err)
}

b, _ := json.MarshalIndent(searchResult, "", "  ")
fmt.Println(string(b))

이전 Go 예제에서는 다음 가져오기 블록이 필요합니다.

import (
   "encoding/json"
   "fmt"
   "github.com/IBM/cloudant-go-sdk/cloudantv1"
)

POST /db/_design/ddoc/_search/searchname HTTP/1.1
Content-Type: application/json
Host: $ACCOUNT.cloudant.com

curl "https://$ACCOUNT.cloudant.com/$DATABASE/_design/$DDOC/_search/$INDEX_NAME" -X POST -H "Content-Type: application/json" -d @search.json

{
    "q": "index:my query",
    "sort": "foo",
    "limit": 3
}

쿼리 구문

IBM Cloudant 의 검색 쿼리 구문은 루씬(Lucene)구문을 기반으로 합니다 검색 조회는 이름이 생략되지 않을 경우 name:value 양식을 사용합니다. 이 경우 다음 예제에서 설명하는 것과 같이 기본 필드를 사용합니다.

다음과 같이 검색 조회 표현식 예제를 참조하십시오.

// Birds
class:bird

// Animals that begin with the letter "l"
l*

// Carnivorous birds
class:bird AND diet:carnivore

// Herbivores that start with letter "l"
l* AND diet:herbivore

// Medium-sized herbivores
min_length:[1 TO 3] AND diet:herbivore

// Herbivores that are 2m long or less
diet:herbivore AND min_length:[-Infinity TO 2]

// Mammals that are at least 1.5m long
class:mammal AND min_length:[1.5 TO Infinity]

// Find "Meles meles"
latin_name:"Meles meles"

// Mammals who are herbivore or carnivore
diet:(herbivore OR omnivore) AND class:mammal

// Return all results
*:*

복수의 필드에 대한 조회를 논리적으로 결합할 수 있으며 그룹 및 필드를 추가로 그룹화할 수 있습니다. 사용 가능한 논리 연산자는 대소문자를 구분하며, AND, +, OR, NOT, and -. 범위 조회는 문자열 또는 숫자에 대해 실행할 수 있습니다.

퍼지 검색을 원하는 경우 ~를 통해 조회를 실행하여 검색어와 유사한 용어를 찾을 수 있습니다. 예를 들면 다음과 같습니다. look~ book 와 took 라는 용어를 찾습니다.

범위 조회의 상한이 둘 다 숫자만 포함된 문자열인 경우 해당 경계가 문자열이 아닌 숫자로 간주됩니다. 예를 들어 mod_date:["20170101" TO "20171231"]라는 조회를 사용하여 검색하는 경우 결과에는 mod_date가 문자열 "20170101" - "20171231" 사이가 아닌 숫자 값 20170101 - 20171231 사이에 있는 문서가 포함됩니다.

^ 및 양수를 추가하여 검색어의 중요도를 변경할 수 있습니다. 이 변경을 수행하는 경우 부스트 값의 제곱에 비례하여 관련성이 높거나 낮은 용어가 포함된 일치 항목이 작성됩니다. 기본값은 일치 항목의 강도가 증가하거나 감소하지 않음을 의미하는 1입니다. 0 - 1의 10진수 값은 일치 항목의 강도를 낮추어 중요도를 감소시킵니다. 1보다 큰 값은 일치 항목의 강도를 올려서 중요도를 증가시킵니다.

와일드카드 검색은 단일 문자 검색 (?) 또는 다중 문자 검색 (*) 모두에 대해 지원됩니다. 예를 들면 다음과 같습니다. dat? would match date and data, and dat* would match date, data, database, and dates. 와일드카드는 반드시 검색어 다음에 와야 합니다.

모든 결과를 리턴하려면 *:*를 사용하십시오.

검색의 결과 세트는 200행으로 제한되며 기본적으로 25행이 리턴됩니다. 리턴되는 행 수는 limit 매개변수를 사용하여 변경할 수 있습니다.

검색 조회에서 "group_field" 인수를 지정하지 않을 경우 응답에 책갈피가 포함됩니다. 이 책갈피가 나중에 URL 매개변수로 제공되는 경우 응답에서 이미 표시된 행을 건너뛰고 빠르고 쉽게 다음 결과 세트를 가져올 수 있습니다.

검색 조회에 "group_field" 매개변수가 포함된 경우 응답에 책갈피가 포함되지 않습니다.

group_field, group_limit 및 group_sort 옵션은 글로벌 조회를 작성하는 경우에만 사용할 수 있습니다.

다음 문자를 검색하는 경우 해당 문자를 이스케이프해야 합니다.

+ - && || ! ( ) { } [ ] ^ " ~ * ? : \ /

이러한 문자 중 하나를 이스케이프 처리하려면 앞의 백슬래시 문자(\)를 사용하십시오.

검색 조회에 대한 응답에는 각각의 결과에 대한 order 필드가 포함되어 있습니다. order 필드는 첫 번째 요소가 sort 매개변수에 지정된 하나 이상의 필드인 배열입니다. 쿼리에 ' sort ' 매개변수가 포함되지 않은 경우, ' order ' 필드에 Lucene 관련성 점수가 포함됩니다. sort by distance지리적 검색에서 설명한 것과 같이 를 사용하는 경우 첫 번째 요소는 특정 위치로부터의 거리입니다. 거리는 킬로미터 또는 마일을 사용하여 측정됩니다.

순서 배열의 두 번째 요소는 무시할 수 있습니다. 이 요소는 문제점 해결 용도로만 사용됩니다.

패싯 지정

IBM Cloudant 검색에서는 빠르고 쉽게 일치 항목에 대한 집계 정보를 발견할 수 있도록 해주는 패싯 지정 검색도 지원됩니다. 특수한 ?q=*:* 조회 구문을 사용하여 모든 문서를 일치시킨 후 리턴되는 패싯을 사용하여 조회를 세분화할 수 있습니다. 필드가 패싯 지정 조회에 대해 인덱싱됨을 나타내려면 해당 옵션에서 {"facet": true}를 설정하십시오.

다음과 같이 패싯 지정 검색을 사용으로 설정한 검색 조회 예제를 참조하십시오.

function(doc) {
    index("type", doc.type, {"facet": true});
    index("price", doc.price, {"facet": true});
}

패싯을 사용하려면 인덱스에 있는 모든 문서에 패싯 지정이 사용으로 설정된 모든 필드가 포함되어 있어야 합니다. 문서에 모든 필드가 포함되어 있지 않은 경우 "bad_request이 존재하지 않음"이라는 이유로 field_name 오류가 수신됩니다. 각각의 문서에 패싯에 대한 모든 필드가 포함되어 있지 않은 경우 각각의 필드에 대해 별도의 인덱스를 작성하십시오. 각각의 필드에 대해 별도의 인덱스를 작성하지 않을 경우 모든 필드가 포함된 문서만 포함시켜야 합니다. 하나의 if문을 사용하여 각각의 문서에 필드가 존재하는지 확인하십시오.

다음과 같이 각각의 문서에 필요한 필드가 존재하는지 확인하기 위한 if문 예제를 참조하십시오.

if (typeof doc.town == "string" && typeof doc.name == "string") {
        index("town", doc.town, {facet: true});
        index("name", doc.name, {facet: true});        
    }

?q=*:*&counts=["type"]

{
    "total_rows":100000,
    "bookmark":"g...",
    "rows":[...],
    "counts":{
        "type":{
            "sofa": 10,
            "chair": 100,
            "lamp": 97
        }
    }
}

?q=*:*&ranges={"price":{"cheap":"[0 TO 100]","expensive":"{100 TO Infinity}"}}

{
    "total_rows":100000,
    "bookmark":"g...",
    "rows":[...],
    "ranges": {
        "price": {
            "expensive": 278682,
            "cheap": 257023
        }
    }
}

지리적 검색

텍스트 필드의 컨텐츠를 검색하는 것 뿐만 아니라 지리적 좌표로부터의 거리를 기준으로 결과를 정렬할 수도 있습니다.

이러한 방식으로 결과를 정렬하려면 경도 및 위도를 나타내는 두 개의 숫자 필드를 인덱싱해야 합니다.

그리고 다섯 개의 매개변수를 사용하는 특수 <distance...> 정렬 필드를 사용하여 쿼리할 수 있습니다.

• 경도 필드 이름 - 경도 필드의 이름입니다(예: mylon).
• 위도 필드 이름 - 위도 필드의 이름입니다(예: mylat).
• 원점 경도 - 거리를 기준으로 정렬하기 위한 원점 위치의 경도입니다.
• 원점 위도 - 거리를 기준으로 정렬하기 위한 원점 위치의 위도입니다.
• 단위 - 킬로미터의 경우 km 또는 마일의 경우 mi 등의 사용할 단위입니다. 거리는 순서 필드에서 리턴됩니다.

거리별로 정렬하는 기능을 다른 검색 쿼리와 결합할 수 있습니다. 위도 및 경도에 대한 범위 검색이나, 비지리학적 정보를 포함하는 쿼리와 같은 다른 검색 쿼리와 결합할 수 있습니다.

이러한 방식으로 경계 상자에서 검색하고 추가 기준을 사용하여 검색 범위를 좁힐 수 있습니다.

다음과 같이 지리적 데이터 예제를 참조하십시오.

{
    "name":"Aberdeen, Scotland",
    "lat":57.15,
    "lon":-2.15,
    "type":"city"
}

다음과 같이 지리적 데이터에 대한 검색 인덱스가 포함된 디자인 문서 예제를 참조하십시오.

function(doc) {
    if (doc.type && doc.type == 'city') {
        index('city', doc.name, {'store': true});
        index('lat', doc.lat, {'store': true});
        index('lon', doc.lon, {'store': true});
    }
}

다음과 같이 HTTP를 사용하여 뉴욕까지의 거리를 기준으로 북반구의 도시를 정렬하는 조회 예제를 참조하십시오.

GET /examples/_design/cities-designdoc/_search/cities?q=lat:[0+TO+90]&sort="<distance,lon,lat,-74.0059,40.7127,km>" HTTP/1.1
Host: $ACCOUNT.cloudant.com

다음과 같이 명령행을 사용하여 뉴욕까지의 거리를 기준으로 북반구의 도시를 정렬하는 조회 예제를 참조하십시오.

curl "https://$ACCOUNT.cloudant.com/examples/_design/cities-designdoc/_search/cities?q=lat:\[0+TO+90\]&sort=\"<distance,lon,lat,-74.0059,40.7127,km>\""

import com.ibm.cloud.cloudant.v1.Cloudant;
import com.ibm.cloud.cloudant.v1.model.PostSearchOptions;
import com.ibm.cloud.cloudant.v1.model.SearchResult;

import java.util.Arrays;

Cloudant service = Cloudant.newInstance();

PostSearchOptions searchOptions = new PostSearchOptions.Builder()
	.db("examples")
	.ddoc("cities-designdoc")
	.index("cities")
	.query("lat:\\[0+TO+90\\]")
	.sort(Arrays.asList("<distance,lon,lat,-74.0059,40.7127,km>"))
	.build();

SearchResult response =
    service.postSearch(searchOptions).execute()
        .getResult();

System.out.println(response);

import { CloudantV1 } from '@ibm-cloud/cloudant';

const service = CloudantV1.newInstance({});

service.postSearch({
	db: 'examples',
	ddoc: 'cities-designdoc',
	index: 'cities',
	query: 'lat:\\[0+TO+90\\]',
	sort: ['<distance,lon,lat,-74.0059,40.7127,km>']
}).then(response => {
	console.log(response.result);
});

from ibmcloudant.cloudant_v1 import CloudantV1

service = CloudantV1.new_instance()

response = service.post_search(
	db='examples',
	ddoc='cities-designdoc',
	index='cities',
	query='lat:\\[0+TO+90\\]',
	sort=['<distance,lon,lat,-74.0059,40.7127,km>']
).get_result()

print(response)

postSearchOptions := service.NewPostSearchOptions(
	"examples",
	"cities-designdoc",
	"cities",
	"lat:\\[0+TO+90\\]",
)
postSearchOptions.SetSort([]string{"<distance,lon,lat,-74.0059,40.7127,km>"})

searchResult, _, err := service.PostSearch(postSearchOptions)
if err != nil {
  panic(err)
}

b, _ := json.MarshalIndent(searchResult, "", "  ")
fmt.Println(string(b))

이전 Go 예제에서는 다음 가져오기 블록이 필요합니다.

import (
   "encoding/json"
   "fmt"
   "github.com/IBM/cloudant-go-sdk/cloudantv1"
)

다음과 같이 뉴욕까지의 거리를 기준으로 정렬된 북반구 도시의 목록이 포함된 응답 예제(축약됨)를 참조하십시오.

{
    "total_rows": 205,
    "bookmark": "g1A...XIU",
    "rows": [
        {
            "id": "city180",
            "order": [
                8.530665755719783,
                18
            ],
            "fields": {
                "city": "New York, N.Y.",
                "lat": 40.78333333333333,
                "lon": -73.96666666666667
            }
        },
        {
            "id": "city177",
            "order": [
                13.756343205985946,
                17
            ],
            "fields": {
                "city": "Newark, N.J.",
                "lat": 40.733333333333334,
                "lon": -74.16666666666667
            }
        },
        {
            "id": "city178",
            "order": [
                113.53603438866077,
                26
            ],
            "fields": {
                "city": "New Haven, Conn.",
                "lat": 41.31666666666667,
                "lon": -72.91666666666667
            }
        }
    ]
}

검색어 강조 표시

사용자에게 더 강조된 결과를 표시할 수 있도록 검색어가 언급된 컨텍스트를 가져오는 것이 유용한 경우도 있습니다.

더 강조된 결과를 가져오려면 검색 조회에 highlight_fields 매개변수를 추가하십시오. 강조된 검색어가 포함된 발췌 항목이 리턴될 필드 이름을 지정하십시오.

기본적으로 검색 용어는 강조표시를 위해 <em> 태그에 배치되지만, 강조표시는 highlights_pre_tag 및 highlights_post_tag 매개변수를 사용하여 대체할 수 있습니다.

단편의 길이는 기본적으로 100자입니다. highlights_size 매개변수를 사용하여 다른 길이를 요청할 수 있습니다.

highlights_number 매개변수는 리턴되는 단편의 수를 제어하며, 기본값은 1입니다.

응답에는 필드 이름당 하나의 서브필드가 포함된 highlights 필드가 추가됩니다.

각각의 필드에 대해 검색어가 강조표시된 단편의 배열이 수신됩니다.

강조표시가 작동하도록 하려면 store: true 옵션을 사용하여 인덱스에 필드를 저장하십시오.

다음과 같이 HTTP를 사용하여 강조표시가 사용으로 설정된 검색 예제를 참조하십시오.

GET /movies/_design/searches/_search/movies?q=movie_name:Azazel&highlight_fields=["movie_name"]&highlight_pre_tag=" "&highlight_post_tag=" "&highlights_size=30&highlights_number=2 HTTP/1.1
HOST: $ACCOUNT.cloudant.com
Authorization: ...

강조 표시를 활성화한 상태에서 검색하는 명령줄의 예는 다음과 같습니다

curl "https://$ACCOUNT.cloudant.com/movies/_design/searches/_search/movies?q=\"movie_name:Azazel\"&highlight_fields=\[\"movie_name\"\]&highlight_pre_tag=\" \"&highlight_post_tag=\" \"&highlights_size=30&highlights_number=2" \
	-X GET

import com.ibm.cloud.cloudant.v1.Cloudant;
import com.ibm.cloud.cloudant.v1.model.PostSearchOptions;
import com.ibm.cloud.cloudant.v1.model.SearchResult;

import java.util.Arrays;

Cloudant service = Cloudant.newInstance();

PostSearchOptions searchOptions = new PostSearchOptions.Builder()
    .db("movies")
    .ddoc("searches")
    .index("movies")
    .query("movie_name:Azazel")
    .highlightFields(Arrays.asList("[\"movie_name\"]"))
    .highlightPreTag("\" \"")
    .highlightPostTag("\" \"")
    .highlightSize(30)
    .highlightNumber(2)
    .build();

SearchResult response =
    service.postSearch(searchOptions).execute()
        .getResult();

System.out.println(response);

import { CloudantV1 } from '@ibm-cloud/cloudant';

const service = CloudantV1.newInstance({});

service.postSearch({
	db: 'movies',
	ddoc: 'searches',
	index: 'movies',
	query: 'movie_name:Azazel',
	highlightFields: ['["movie_name"]'],
	highlightPreTag: '" "',
	highlightPostTag: '" "',
	highlightSize: 30,
	highlightNumber: 2
}).then(response => {
	console.log(response.result);
});

from ibmcloudant.cloudant_v1 import CloudantV1

service = CloudantV1.new_instance()

response = service.post_search(
	db='movies',
	ddoc='searches',
	index='movies',
	query='movie_name:Azazel',
	highlight_fields=['["movie_name"]'],
	highlight_pre_tag='" "',
	highlight_post_tag='" "',
	highlight_size=30,
	highlight_number=2
).get_result()

print(response)

postSearchOptions := service.NewPostSearchOptions(
	"movies",
	"searches",
	"movies",
	"movie_name:Azazel",
)
postSearchOptions.SetHighlightFields([]string{"[\"movie_name\"]"})
postSearchOptions.SetHighlightPreTag("\" \"")
postSearchOptions.SetHighlightPostTag("\" \"")
postSearchOptions.SetHighlightSize(30)
postSearchOptions.SetHighlightNumber(2)

searchResult, _, err := service.PostSearch(postSearchOptions)
if err != nil {
	panic(err)
}

b, _ := json.MarshalIndent(searchResult, "", "  ")
fmt.Println(string(b))

이전 Go 예제에서는 다음 가져오기 블록이 필요합니다.

import (
   "encoding/json"
   "fmt"
   "github.com/IBM/cloudant-go-sdk/cloudantv1"
)

다음과 같이 강조표시된 검색 결과 예제를 참조하십시오.

{
    "highlights": {
        "movie_name": [
            " on the Azazel Orient Express",
            " Azazel manuals, you"
        ]
    }
}

검색 인덱스 메타데이터

검색 인덱스에 대한 정보를 검색하려면 다음 예제에 표시된 것과 같이 GET 엔드포인트로 _search_info 요청을 전송하십시오. DDOC는 인덱스가 포함된 디자인 문서를 참조하며 INDEX_NAME은 인덱스의 이름입니다.

다음과 같이 HTTP를 사용하여 검색 인덱스 메타데이터를 요청하는 예제를 참조하십시오.

GET /$DATABASE/_design/$DDOC/_search_info/$INDEX_NAME HTTP/1.1

다음과 같이 명령행을 사용하여 검색 인덱스 메타데이터를 요청하는 예제를 참조하십시오.

curl "https://$ACCOUNT.cloudant.com/$DATABASE/_design/$DDOC/_search_info/$INDEX_NAME" \
     -X GET

import com.ibm.cloud.cloudant.v1.Cloudant;
import com.ibm.cloud.cloudant.v1.model.GetSearchInfoOptions;
import com.ibm.cloud.cloudant.v1.model.SearchInfoResult;

Cloudant service = Cloudant.newInstance();

GetSearchInfoOptions infoOptions =
    new GetSearchInfoOptions.Builder()
        .db("<db-name>")
        .ddoc("<ddoc>")
        .index("<index-name>")
        .build();

SearchInfoResult response =
    service.getSearchInfo(infoOptions).execute()
        .getResult();

System.out.println(response);

import { CloudantV1 } from '@ibm-cloud/cloudant';

const service = CloudantV1.newInstance({});

service.getSearchInfo({
	db: '<db-name>',
	ddoc: '<ddoc>',
	index: '<index-name>'
}).then(response => {
	console.log(response.result);
});

from ibmcloudant.cloudant_v1 import CloudantV1

service = CloudantV1.new_instance()

response = service.get_search_info(
	db='<db-name>',
	ddoc='<ddoc>',
	index='<index-name>'
).get_result()

print(response)

getSearchInfoOptions := service.NewGetSearchInfoOptions(
	"<db-name>",
	"<ddoc>",
	"<index-name>",
)

searchInfoResult, _, err := service.GetSearchInfo(getSearchInfoOptions)
if err != nil {
  panic(err)
}

b, _ := json.MarshalIndent(searchInfoResult, "", "  ")
fmt.Println(string(b))

이전 Go 예제에서는 다음 가져오기 블록이 필요합니다.

import (
   "encoding/json"
   "fmt"
   "github.com/IBM/cloudant-go-sdk/cloudantv1"
)

응답에는 인덱스의 문서 수 및 디스크에서 인덱스의 크기와 같은 인덱스에 대한 정보가 포함되어 있습니다.

다음과 같이 검색 인덱스 메타데이터를 요청한 이후의 응답 예제를 참조하십시오.

{
    "name": "_design/DDOC/INDEX",
    "search_index": {
        "pending_seq": 7125496,
        "doc_del_count": 129180,
        "doc_count": 1066173,
        "disk_size": 728305827,
        "committed_seq": 7125496
    }
}