IntroductionThe previous class cove

Introduction

The previous class covered the basics of defining, submitting, and processing a search query. The Search API supports more complex queries, including specification of the point in the index at which query should start, how the results should be sorted and formatted, and what information about the docs should be returned from the query. It also supports Geosearch (location-based queries).

In this lesson, we'll look in more detail at some of these features. You'll learn how to

define and process the results of complex queries
generate field snippets and computed fields
control which document fields are returned from a query
use offsets and limits to control where a query starts and how many results are returned
construct and use location-based queries (Geosearch)
See the Search API documentation for more detail on the features described in this lesson, as well as some additional capabilities that we won't cover here.

Query Options

The constructor for class Query accepts an optional QueryOptions object as an argument, allowing you to configure a wide range of options:


search_query = search.Query(
query_string=query.strip(),
options=search.QueryOptions(...)
)
Consider one of the QueryOptions configurations used in the example product search application:


search_query = search.Query(
query_string=query.strip(),
options=search.QueryOptions(
limit=doc_limit,
offset=offsetval,
sort_options=sortopts,
snippeted_fields=[docs.Product.DESCRIPTION],
returned_expressions=[search.FieldExpression(name='adjusted_price',
expression='max(price, 14.99)')],
returned_fields = [docs.Product.PID, docs.Product.DESCRIPTION,
docs.Product.CATEGORY, docs.Product.AVG_RATING,
docs.Product.PRICE, docs.Product.PRODUCT_NAME]
))
This specifies an offset (where to start the query) and a limit (the maximum number of results to return), some sort options (discussed in the next lesson), a list of snippeted fields, a list of returned expressions (computed fields), and a list of returned fields. Let's look at what each of these options does.

Query Offsets, Limits, and Cursors

To control the number of results a query returns, use the QueryOptions constructor's limit parameter. The example product search application uses limit to return a maximum of three results per page.

The example above also shows the use of the offset parameter. The offset specifies the number of matched documents to skip before beginning to return results:


search.QueryOptions(
limit=doc_limit,
offset=offsetval,
...)
One common use for the offset and limit parameters is to paginate the query results. To implement pagination, you need to know the total number of matches the query found and how many have been returned so far. You can get that information from the returned SearchResults object:


number_found = search_results.number_found
returned_count = len(search_results.results)
The Search API also supports the use of query cursors. Cursors are another way to indicate the point from which to begin a query, allowing you to continue a search from the end of the previous result set. Using a cursor is generally more efficient than using offsets. However, the Search API doesn't currently support a "reverse cursor" as does the Datastore API, making it more difficult to to implement backward paging. For this reason, the example application uses offsets rather than cursors to paginate its query results. You can find an example using cursors here.

Snippeting

Snippeted fields allow you to return an abbreviated portion of a field instead of its full content. The returned snippet will include the fragment of the field on which the match occurred, with the matched search terms highlighted in bold. In the product search application (with default data), a search on the query stories returns three matches, in the documents' description fields. Because we requested that description be snippeted, the snippet expressions in the results have the word "stories" highlighted.

ผลลัพธ์ (ไทย) 1:

การแนะนำ

ชั้นก่อนหน้านี้ครอบคลุมพื้นฐานของการกำหนดการส่งและการประมวลผลการค้นหา API ของการค้นหาสนับสนุนแบบสอบถามที่ซับซ้อนมากขึ้นรวมทั้งคุณสมบัติของจุดในดัชนีที่แบบสอบถามควรเริ่มต้นอย่างไรผลที่ควรจะเรียงลำดับและการจัดรูปแบบและสิ่งที่ข้อมูลเกี่ยวกับเอกสารที่ควรจะกลับมาจากแบบสอบถามก็ยังสนับสนุน geosearch (การค้นหาสถานที่ที่ใช้).

ในบทเรียนนี้เราจะดูในรายละเอียดเพิ่มเติมที่บางส่วนของคุณสมบัติเหล่านี้ คุณจะได้เรียนรู้วิธีการ

กำหนดและผลของการประมวลผลแบบสอบถามที่ซับซ้อน
สร้างตัวอย่างเขตข้อมูลและเขตคำนวณ
ควบคุมฟิลด์เอกสารจะถูกส่งกลับจากแบบสอบถาม
ชดเชยการใช้และข้อ จำกัด ในการควบคุมที่จะเริ่มต้นการค้นหาและจำนวนผลลัพธ์ถูกส่งคืน
สร้างและใช้แบบสอบถามตามพื้นที่ (geosearch)
ดูที่เอกสาร API ของการค้นหารายละเอียดเพิ่มเติมเกี่ยวกับคุณสมบัติที่อธิบายไว้ในบทเรียนนี้เป็นความสามารถเพิ่มเติมบางอย่างที่เราจะไม่ครอบคลุมที่นี่.

ตัวเลือกแบบสอบถาม

สร้างสำหรับ ชั้นแบบสอบถามยอมรับ queryoptions เลือกวัตถ​​ุเป็นอาร์กิวเมนต์ช่วยให้คุณสามารถกำหนดค่าที่หลากหลายของตัวเลือก:


SEARCH_QUERY = search.query (
QUERY_STRING = query.strip ()
ตัวเลือก = search.queryoptions (... )
)
พิจารณาอย่างใดอย่างหนึ่งของการกำหนดค่า queryoptions ที่ใช้ในการประยุกต์ใช้ในการค้นหาผลิตภัณฑ์เช่น:


SEARCH_QUERY = search.query (
QUERY_STRING = แบบสอบถาม แถบ ()
ตัวเลือก = search.queryoptions (
= doc_limit จำกัด ,
= ชดเชย offsetval
sort_options = sortopts
snippeted_fields = [docs.product.description]
returned_expressions = [ค้นหาfieldexpression (ชื่อ = 'adjusted_price'
แสดงออก = 'max (ราคา 14.99)')]
returned_fields = [docs.product.pid, docs.product.description
docs.product.category, docs.product.avg_rating
docs.product.price, docs.product.product_name]
))
นี้ระบุชดเชย (ที่จะเริ่มต้นการค้นหา) และ จำกัด (จำนวนสูงสุดของผลลัพธ์ที่จะกลับมา) ตัวเลือกการจัดเรียงบาง (กล่าวถึงในครั้งต่อไป บทเรียน)รายชื่อของเขตข้อมูล snippeted รายการของสำนวนกลับ (เขตข้อมูลการคำนวณ) และรายการของเขตข้อมูลกลับมา ให้ดูที่สิ่งที่แต่ละตัวเลือกเหล่านี้จะ. ชดเชย

แบบสอบถาม จำกัด และเคอร์เซอร์

การควบคุมจำนวนของผลตอบแทนแบบสอบถามที่ใช้พารามิเตอร์ จำกัด queryoptions สร้างของ ตัวอย่างการประยุกต์ใช้ค้นหาผลิตภัณฑ์ขีด จำกัด ที่จะกลับมาเกินสามผลต่อหน้า.

ตัวอย่างข้างต้นยังแสดงให้เห็นการใช้พารามิเตอร์ชดเชย ชดเชยระบุจำนวนเอกสารตรงข้ามก่อนที่จะเริ่มต้นเพื่อให้ได้ผลลัพธ์:


search.queryoptions (
= doc_limit จำกัด ,
= ชดเชย offsetval
... )
หนึ่งการใช้งานทั่วไปสำหรับการชดเชยและพารามิเตอร์ จำกัด คือการ เลขหน้าผลการค้นหา ในการดำเนินการแบ่งหน้าคุณจำเป็นต้องรู้จำนวนรวมของการแข่งขันแบบสอบถามที่พบและวิธีการจำนวนมากได้รับกลับมาเพื่อให้ห่างไกล คุณจะได้รับข้อมูลว่าจากวัตถ​​ุกลับ searchresults:


number_found = search_results.number_found
returned_count = len (search_results.results)
API ของการค้นหายังสนับสนุนการใช้งานของเคอร์เซอร์แบบสอบถาม เคอร์เซอร์เป็นวิธีที่จะแสดงให้เห็นจุดที่จะเริ่มต้นการค้นหาอื่นช่วยให้คุณสามารถค้นหาต่อจากจุดสิ้นสุดของผลการตั้งค่าก่อนหน้านี้ ใช้เคอร์เซอร์โดยทั่วไปมีประสิทธิภาพมากขึ้นกว่าการใช้ชดเชย แต่ API ของการค้นหาไม่สนับสนุน "เคอร์เซอร์กลับ" เช่นเดียวกับ API ของ datastore ทำให้เป็นเรื่องยากมากขึ้นในการที่จะใช้เพจจิ้งได้ย้อนหลัง ด้วยเหตุนี้การใช้งานเช่นใช้ชดเชยมากกว่าเคอร์เซอร์ไปที่เลขหน้าผลการค้นหาของคุณสามารถหาตัวอย่างการใช้เคอร์เซอร์ที่นี่.



snippeting ฟิลด์ snippeted ช่วยให้คุณสามารถที่จะกลับมาเป็นส่วนหนึ่งยากของสนามแทนของเนื้อหาเต็ม ตัวอย่างกลับจะรวมถึงส่วนของเขตข้อมูลที่ตรงกับที่เกิดขึ้นที่มีการค้นหาคำที่ตรงกับที่เน้นในตัวหนา ในโปรแกรมค้นหาผลิตภัณฑ์ (ที่มีข้อมูลเริ่มต้น),ค้นหาเรื่องราวแบบสอบถามกลับสามขีดในฟิลด์คำอธิบายเอกสาร ' เพราะเราขอให้คำอธิบายที่ถูก snippeted สำนวนตัวอย่างในผลการมีคำว่า "เรื่อง" ไฮไลต์

ผลลัพธ์ (ไทย) 2:

แนะนำ

เรียนก่อนหน้านี้ครอบคลุมพื้นฐานการกำหนด ส่ง และการประมวลผลแบบสอบถามการค้นหา API ค้นหาสนับสนุนการสอบถามซับซ้อน รวมถึงข้อมูลจำเพาะของจุดดัชนีที่ถามว่าควรเริ่มต้น วิธีผลลัพธ์ควรจะเรียงลำดับ และจัดรูปแบบ และข้อมูลเกี่ยวกับเอกสารควรถูกส่งกลับจากแบบสอบถาม สนับสนุน Geosearch (สอบถามข้อมูลตำแหน่ง)

ในบทเรียนนี้ เราจะดูในรายละเอียดเพิ่มเติมในบางคุณลักษณะเหล่านี้ คุณจะได้เรียนรู้วิธีการ

กำหนด และประมวลผลผลลัพธ์ของแบบสอบถามที่ซับซ้อน
สร้างโค้ดเขตข้อมูลและเขตข้อมูลจากการคำนวณ
ควบคุมฟิลด์เอกสารจะถูกส่งกลับจากแบบสอบถาม
ใช้ชดเชย และควบคุมซึ่งการเริ่มต้นของแบบสอบถามและมีการส่งคืนผลลัพธ์จำนวนจำกัด
สร้าง และใช้จัดสอบถาม (Geosearch)
ดูเอกสาร API ค้นหารายละเอียดเพิ่มเติมเกี่ยวกับคุณลักษณะต่าง ๆ ที่อธิบายไว้ในบทเรียนนี้ รวมทั้งความสามารถบางอย่างเพิ่มเติมว่า เราจะไม่ปกนี่

สอบถามตัว

ตัวสร้างสำหรับการเรียนแบบสอบถามรับวัตถุ QueryOptions ก็ได้เป็นอาร์กิวเมนต์ ช่วยให้คุณสามารถกำหนดค่าตัวเลือกที่หลากหลาย:


search_query =ค้นหาแบบสอบถาม (
query_string=query.strip(),
ตัว =ค้นหาQueryOptions(...)
)
พิจารณากำหนดค่า QueryOptions ที่ใช้ในโปรแกรมประยุกต์ตัวอย่างผลิตภัณฑ์ค้นหาอย่างใดอย่างหนึ่ง:


search_query =ค้นหาแบบสอบถาม (
query_string=query.strip(),
ตัว =ค้นหาQueryOptions (
วงเงิน = doc_limit,
ออฟเซ็ต = offsetval,
sort_options = sortopts,
snippeted_fields = [เอกสารการProduct.DESCRIPTION],
returned_expressions = [ค้นหาFieldExpression (ชื่อ = 'adjusted_price',
นิพจน์ = 'สูงสุด (ราคา 14.99)')],
returned_fields = [เอกสารการProduct.PID เอกสารProduct.DESCRIPTION,
เอกสารการProduct.CATEGORY เอกสารProduct.AVG_RATING,
เอกสารการProduct.PRICE เอกสารProduct.PRODUCT_NAME]
))
ระบุออฟเซต (ตำแหน่งที่จะเริ่มต้นแบบสอบถาม) และขีดจำกัด (จำนวนผลลัพธ์กลับ), บางเรียงตัวเลือก (ที่กล่าวถึงในบทถัดไป), รายการของฟิลด์ snippeted รายการของนิพจน์ที่ส่งกลับ (คำนวณฟิลด์), และรายการของฟิลด์ที่ส่งคืน ลองดูที่อุปกรณ์แต่ละชนิดไม่ตัวเลือกเหล่านี้

สอบถามเหลื่อม จำกัด และเคอร์เซอร์

การพารามิเตอร์วงเงิน QueryOptions เหมาควบคุมจำนวนของผลลัพธ์แบบสอบถามส่งกลับ การ ตัวอย่างผลิตภัณฑ์ค้นหาแอพลิเคชันใช้วงเงินกลับสูงสุดสามผลลัพธ์ต่อหน้า

ตัวอย่างข้างต้นยังแสดงการใช้พารามิเตอร์ออฟเซ็ต ออฟเซตระบุหมายเลขของเอกสารที่ตรงกันข้ามก่อนที่จะเริ่มการส่งคืนผลลัพธ์:


ค้นหาQueryOptions (
วงเงิน = doc_limit,
ออฟเซ็ต = offsetval,
...)
ทั่วไปใช้สำหรับพารามิเตอร์ออฟเซ็ตและวงเงินจะไปถาม สามารถแบ่งหน้า คุณจำเป็นต้องทราบจำนวนตรงกันพบการสอบถามและจำนวนมีการส่งคืนเพื่อให้ห่างไกล คุณสามารถรับข้อมูลจากวัตถุ SearchResults ส่งคืน:


number_found = search_results.number_found
returned_count = len (search_results.results)
ค้นหา API ยังสนับสนุนการใช้เคอร์เซอร์แบบสอบถามได้ เคอร์เซอร์เป็นวิธีอื่นเพื่อระบุจุดที่จะเริ่มต้นแบบสอบถาม ช่วยให้คุณสามารถค้นหาจากจุดสิ้นสุดของชุดผลลัพธ์ก่อนหน้านี้ต่อไป ใช้เคอร์เซอร์อยู่โดยทั่วไปมีประสิทธิภาพมากขึ้นกว่าการใช้ปรับค่า อย่างไรก็ตาม API ค้นหาไม่อยู่ในขณะนี้สนับสนุน "เคอร์เซอร์กลับ" กับ API Datastore ทำให้ยากต่อการใช้เพจจิ้งย้อนหลัง ด้วยเหตุนี้ แอพลิเคชันตัวอย่างใช้ปรับค่าแทนเคอร์เซอร์ไปยังหน้าผลลัพธ์ของแบบสอบถาม คุณสามารถค้นหาตัวอย่างโดยใช้เคอร์เซอร์นี้ได้

Snippeting

ฟิลด์ Snippeted ช่วยให้คุณสามารถกลับเป็นส่วนย่อของฟิลด์แทนเนื้อหาเต็มได้ ส่วนย่อยของการส่งคืนจะรวมส่วนของฟิลด์ที่ตรงกันที่เกิด กับคำค้นหาตรงกันเน้นเป็นตัวหนา การค้นหาสินค้า (มีข้อมูลเริ่มต้น), ค้นหาในเรื่องราวสอบถามส่งกลับตรงสาม ในฟิลด์คำอธิบายของเอกสาร เนื่องจากเราขอให้ รายละเอียดได้ snippeted นิพจน์ของส่วนย่อยในผลลัพธ์ได้คำเรื่อง "ราว" เน้น

ผลลัพธ์ (ไทย) 3:

ก่อนหน้า: บทนำ

Class ซึ่งอยู่ ภายใต้ พื้นฐานของการกำหนดการส่งและการประมวลผลการค้นหาการสืบค้นพื้นฐาน API การค้นหาที่รองรับการค้นหาข้อมูลความซับซ้อนมากขึ้นรวมถึงข้อมูลจำเพาะของจุดที่อยู่ในดัชนีที่สืบค้นควรจะเริ่มว่าผลลัพธ์ที่จะจัดเรียงและจัดรูปแบบและข้อมูลที่เกี่ยวกับเอกสารที่จะต้องกลับมาจากการสอบถามดังกล่าวนอกจากนี้ยังสนับสนุน geosearch (สอบถามข้อมูลตามตำแหน่ง)

ในบทเรียนนี้เราจะดูในรายละเอียดเพิ่มเติมที่โดดเด่นไปด้วยบางส่วน คุณจะได้เรียนรู้ถึง วิธีการ

กำหนดกระบวนการและผลของคอมเพล็กซ์สอบถาม
ซึ่งจะช่วยสร้างฟิลด์ข้อความสั้นและคำนวณฟิลด์
ซึ่งจะช่วยควบคุมซึ่งเอกสารข้อมูลในฟิลด์มีการส่งคืนจากที่สืบค้น
ซึ่งจะช่วยการกำหนดยอดสุทธิเป็นการชดเชยยอดการใช้และการจำกัดในการควบคุมที่มีการสอบถามจะเริ่มต้นและวิธีการมากผลมีการส่งคืน
สร้างและใช้ตำแหน่ง - ขึ้นอยู่การค้นหา( geosearch )
ดูที่การค้นหาเอกสารของ API สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับคุณสมบัติที่ระบุไว้ในที่นี้บทเรียนให้เป็นไปตามความสามารถในบางส่วนเพิ่มเติมที่เราจะไม่ครอบคลุมอยู่ที่นี่.



สืบค้นตัวเลือกที่ผู้สร้างสำหรับ Class คำถามจะยอมรับที่เป็นอุปกรณ์เสริม queryoptions วัตถุเป็นอาร์กิวเมนต์ช่วยให้คุณสามารถกำหนดค่าที่หลากหลายของตัวเลือก:


search_query =ค้นหาคำถาม(
query_string =การสืบค้น. Strip (),
options=search.queryoptions( ...)
)
พิจารณาหนึ่งใน queryoptions การปรับตั้งค่าใช้งานในตัวอย่างเช่น ผลิตภัณฑ์ การค้นหาแอปพลิเคชัน:


search_query =ค้นหาคำถาม(
query_string =การสืบค้น. Strip (),
=ตัวเลือกการค้นหา queryoptions (
limit = doc_limit ,
ชดเชย= offsetval ,
sort_options = sortopts ,
snippeted_fields =[ docs . ผลิตภัณฑ์ .คำอธิบาย],
returned_expressions =[การค้นหา.fieldexpression ( name =" adjusted_price ','
การแสดง=สูงสุด( MAX )(ราคา, 14.99 )')],
returned_fields =[ docs . ผลิตภัณฑ์ .โพรเซส, docs . ผลิตภัณฑ์ .คำอธิบาย,
docs . ผลิตภัณฑ์ . ประเภท , docs . ผลิตภัณฑ์ . avg_rating ,
docs . ผลิตภัณฑ์ .ราคา, docs . ผลิตภัณฑ์ . - product _ NAME ]

))นี้จะกำหนดค่าออฟเซ็ต(ซึ่งจะเริ่มที่การสืบค้น)และที่จำกัด(จำนวนสูงสุดของผลเพื่อกลับไป),บางคนเรียงลำดับตัวเลือก(มีประเด็นในบทเรียน)รายการของข้อมูลในฟิลด์ snippeted รายการของสำนวนส่งคืน(ในฟิลด์คำนวณ)และรายการของฟิลด์กลับมา. ปล่อยให้ดูว่าอะไรคือสิ่งที่แต่ละตัวเลือกไม่.

สืบค้นและการจำกัดการกำหนดยอดสุทธิเป็นการชดเชยยอดตัว ชี้

เพื่อควบคุมจำนวนของผลลัพธ์การค้นหาจะแสดงผลลัพธ์ที่ใช้พารามิเตอร์ของ queryoptions ผู้สร้างได้ แอปพลิเคชันการค้นหา ผลิตภัณฑ์ ตัวอย่างเช่นที่ใช้การจำกัดในการกลับไปที่สูงสุดของสามผลต่อหน้า.

ตัวอย่างที่ด้านบนแสดงการใช้พารามิเตอร์ชดเชยได้ ออฟเซ็ตระบุหมายเลขของตรงกันเอกสารเพื่อข้ามไปก่อนที่จะเริ่มต้นในการส่งกลับผลลัพธ์:


การค้นหา. queryoptions (
limit = doc_limit ,
ออฟเซ็ต= offsetval ,
...)
หนึ่งใช้ร่วมกันสำหรับชดเชยและจำกัดพารามิเตอร์คือการจัดหน้าขึ้นสืบค้นผล. การใช้งานแบบพูลดาวน์สำหรับหมายเลขหน้าคุณต้องทราบจำนวนรวมของรายการที่ตรงกันจะพบคำถามและว่าจำนวนมากถูกตีกลับมาอย่างมาก คุณสามารถดูข้อมูลที่กลับมาจากผลการค้นหาวัตถุ:


number_found = search_results . number_found
returned_count =เลน( search_results .ผล)ที่
API การค้นหาที่ยังสนับสนุนการใช้งานของการสืบค้นตัวชี้ ตัวชี้จะเป็นอีกวิธีหนึ่งในการแสดงจุดจากที่ในการเริ่มการสืบค้นพื้นฐานช่วยให้คุณสามารถดำเนินการต่อการค้นหาจากปลายของผลลัพธ์ก่อนหน้าที่ตั้งค่าไว้ โดยใช้เคอร์เซอร์ที่ทำงานโดยทั่วไปแล้วจะมี ประสิทธิภาพ มากกว่าการใช้การกำหนดยอดสุทธิเป็นการชดเชยยอด แต่ถึงอย่างไรก็ตามสำหรับการค้นหาที่ไม่สนับสนุน"เคอร์เซอร์ย้อนกลับ"สำหรับการเก็บข้อมูลที่ไม่ซับซ้อนที่ทำให้เป็นการยากขึ้นเพื่อใช้ติดตามตัวย้อนกลับในขณะนี้ สำหรับเหตุผลนี้แอปพลิเคชันตัวอย่างที่ใช้การกำหนดยอดสุทธิเป็นการชดเชยยอดมากกว่าตัวชี้การจัดหน้าขึ้นสืบค้นผลคุณสามารถค้นหาโดยใช้ตัวชี้ตัวอย่างเช่นที่อยู่ที่นี่.

ฟิลด์

snippeted snippeting ช่วยให้คุณสามารถกลับมาเป็นตัวย่อส่วนของฟิลด์แทนที่การเนื้อหาอย่างเต็มที่ ข้อความสั้นส่งคืนนี้จะรวมถึงแยกส่วนของฟิลด์ที่ตรงกับที่เกิดขึ้นกับเงื่อนไขการค้นหาที่ตรงที่ถูกไฮไลท์ให้เด่นชัดขึ้นในตัวหนา ในแอปพลิเคชันการค้นหา ผลิตภัณฑ์ (พร้อมด้วยข้อมูลเริ่มต้น)การค้นหาในฟิลด์คำถามเรื่องที่สามจะกลับมาตรงกับในฟิลด์คำอธิบายของเอกสารนี้ เพราะเราได้ขอว่ารายละเอียดเป็นสำนวน snippeted ข้อความสั้นในการแสดงผลที่มีคำว่า"เรื่องที่"ที่ถูกไฮไลท์ให้เด่นชัดขึ้น