Để thực hiện kèo bóng đá pháp toàn văn, phải có một chức năng để tạo AtsVector
Từ một tài kèo bóng đá pháp và mộttsquery
Từ truy vấn người dùng. Ngoài ra, chúng ta cần trả lại kết quả theo thứ tự hữu ích, vì vậy chúng ta cần một chức năng so sánh các tài kèo bóng đá pháp liên quan đến mức độ liên quan của chúng với truy vấn.PostgreSQLCung cấp hỗ trợ cho tất cả các chức năng này.
PostgreSQLcung cấp chức năngto_tsVector
Để chuyển đổi tài kèo bóng đá pháp thànhTSVECTOR
Kiểu dữ kèo bóng đá pháp.
to_tsVector ([config
Regconfig
, ]Document
Text
) Trả vềTSVECTOR
to_tsVector
11929_12016tsVector
liệt kê các từ vựng cùng với vị trí của họ trong tài liệu. Tài liệu được xử lý theo cấu hình kèo bóng đá pháp bản được chỉ định hoặc mặc định.
Chọn to_tsvector ('tiếng Anh', 'một con mèo béo ngồi trên thảm - nó đã ăn một con chuột béo');
Trong ví dụ trên, chúng ta thấy rằng kết quảtsVector
không chứa các từA
, trên
hoặcIT
, từRATS
trở thànhRAT
và Dấu chấm câu-
đã bị bỏ qua.
Theto_tsVector
chức năng gọi nội bộ gọi trình phân tích cú pháp chia văn bản tài kèo bóng đá pháp vào mã thông báo và gán một loại cho mỗi mã thông báo. Đối với mỗi mã thông báo, một danh sách từ điển (Phần 12.6) được tư vấn, trong đó danh sách có thể thay đổi tùy thuộc vào loại mã thông báo. Từ điển đầu tiênNhận dạngMã thông báo phát ra một hoặc nhiều bình thườngLexemeĐể đại diện cho mã thông báo. Ví dụ,chuột
trở thànhRAT
Bởi vì một trong những từ điển nhận ra rằng từRATS
là một dạng số nhiều củaRAT
. Một số từ được công nhận làDừng từ(Phần 12.6.1), khiến chúng bị bỏ qua vì chúng xảy ra quá thường xuyên để kèo bóng đá pháp. Trong ví dụ của chúng tôi, đây làA
, trên
vàIT
. Nếu không có từ điển trong danh sách nhận ra mã thông báo thì nó cũng bị bỏ qua.-
Bởi vì trên thực tế không có từ điển nào được gán cho loại mã thông báo của nó (Biểu tượng không gian
), nghĩa là mã thông báo không gian sẽ không bao giờ được lập chỉ mục. Các lựa chọn của trình phân tích cú pháp, từ điển và loại mã thông báo cho chỉ mục được xác định bởi cấu hình kèo bóng đá pháp bản đã chọn (Phần 12.7). Có thể có nhiều cấu hình khác nhau trong cùng một cơ sở dữ kèo bóng đá pháp và các cấu hình được xác định trước có sẵn cho các ngôn ngữ khác nhau.Tiếng Anh
Đối với ngôn ngữ tiếng Anh.
hàmSetweight
có thể được sử dụng để dán nhãn các mục của AtsVector
với một đã choTrọng lượng, trong đó trọng lượng là một trong các chữ cáiA
, B
, C
hoặcD
. Điều này thường được sử dụng để đánh dấu các mục đến từ các phần khác nhau của tài kèo bóng đá pháp, chẳng hạn như tiêu đề so với cơ thể.
vìto_tsVector
(null
) sẽ trả vềnull
, nên sử dụngHOUNESCE
Bất cứ khi nào một trường có thể là NULL. Đây là phương thức được đề xuất để tạotsVector
Từ một tài kèo bóng đá pháp có cấu trúc:
Cập nhật TT SET TI =
Ở đây chúng tôi đã sử dụngSetweight
Để dán nhãn nguồn của mỗi từ vựng trong hoàn thànhTSVECTOR
, và sau đó hợp nhất được dán nhãntsVector
Giá trị sử dụngTSVECTOR
Toán tử Concatenation||
. (Phần 12.4.1cung cấp chi tiết về các hoạt động này.)
PostgreSQLCung cấp các chức năngto_tsquery
, Plainto_tsquery
, PHRASETO_TSQUERY
vàwebsearch_to_tsquery
để chuyển đổi truy vấn thànhtsquery
Kiểu dữ kèo bóng đá pháp.to_tsquery
cung cấp quyền truy cập vào nhiều tính năng hơnPlainto_tsquery
hoặcPHRASETO_TSQUERY
, nhưng nó ít tha thứ về đầu vào của nó.WebSearch_TO_TSQuery
là phiên kèo bóng đá pháp đơn giản củato_tsquery
Với cú pháp thay thế, tương tự như bộ được sử dụng bởi các công cụ kèo bóng đá pháp web.
to_tsquery ([config
RegConfig
, ]Querytext
Text
) Trả vềtsquery
to_tsquery
Tạo Atsquery
Giá trị từQueryText
, phải bao gồm các mã thông báo đơn lẻ được phân tách bởitsquery
Người vận hành&
(và),|
(hoặc),!
(không) và<-
(tiếp theo là), có thể được nhóm lại bằng cách sử dụng dấu ngoặc đơn. Nói cách khác, đầu vào choto_tsquery
Phải tuân theo các quy tắc chung chotsquery
Đầu vào, như được mô tả trongPhần 8.11.2. Sự khác biệt là trong khi cơ kèo bóng đá pháptsquery
Đầu vào lấy các mã thông báo theo mệnh giá,to_tsquery
Bình thường hóa mỗi mã thông báo thành từ vựng bằng cách sử dụng cấu hình được chỉ định hoặc mặc định và loại bỏ bất kỳ mã thông báo nào là các từ dừng theo cấu hình. Ví dụ:
Chọn To_TSQuery ('Tiếng Anh', 'The & Fat & Rats');
như trong cơ kèo bóng đá pháptsquery
Đầu vào, trọng lượng có thể được gắn vào mỗi từ vựng để hạn chế nó chỉ phù hợpTSVECTOR
Lexeme của những trọng lượng đó. Ví dụ:
Chọn to_tsquery ('tiếng Anh', 'chất béo | chuột: ab');
Ngoài ra,*
có thể được gắn vào từ vựng để chỉ định khớp tiền tố:
Chọn To_TSQuery ('Supern:*A & Star: A*B');
Một từ vựng như vậy sẽ phù hợp với bất kỳ từ nào trong mộttsVector
bắt đầu bằng chuỗi đã cho.
to_tsquery
cũng có thể chấp nhận các cụm từ được trích xuất đơn. Điều này chủ yếu hữu ích khi cấu hình bao gồm từ điển từ điển có thể kích hoạt trên các cụm từ đó.Supernovae Stars: SN
:
Chọn to_tsquery ('' 'Supernovae Stars' '&! Crab');
Không có báo giá,to_tsquery
sẽ tạo lỗi cú pháp cho các mã thông báo không được phân tách bởi một và, hoặc hoặc theo sau bởi toán tử.
Plainto_tsquery ([config
RegConfig
, ]Querytext
Text
) Trả vềtsquery
Plainto_tsquery
Chuyển đổi văn kèo bóng đá pháp không được định dạngQuerytext
đến Atsquery
Giá trị. Văn kèo bóng đá pháp được phân tích cú pháp và chuẩn hóa nhiều như choTO_TSVECTOR
, sau đó&
(và)tsquery
toán tử được chèn vào giữa các từ còn sống.
Ví dụ:
Chọn Plainto_tsquery ('Tiếng Anh', 'chuột béo');
Lưu ý rằngPlainto_tsquery
sẽ không nhận ratsquery
toán tử, nhãn trọng lượng hoặc nhãn tiền tố-match trong đầu vào của nó:
Chọn Plainto_tsquery ('English', 'The Fat & Rats: C');
Ở đây, tất cả các dấu câu đầu vào đã bị loại bỏ là ký hiệu không gian.
PHRASETO_TSQUERY ([config
Regconfig
, ]Querytext
Text
) Trả vềtsquery
PHRASETO_TSQUERY
Hành xử giống nhưPlainto_tsquery
, ngoại trừ việc nó chèn<-
(tiếp theo là) toán tử giữa các từ còn sống thay vì&
(và) toán tử. Ngoài ra, các từ dừng không chỉ đơn giản là bị loại bỏ, mà được tính bằng cách chèn<
Người vận hành chứ không phảin
<-
Người vận hành. Chức năng này rất hữu ích khi kèo bóng đá pháp các chuỗi từ vựng chính xác, vì sau đó là các toán tử kiểm tra thứ tự từ bỏ không chỉ sự hiện diện của tất cả các từ vựng.
Ví dụ:
chọn Phraseto_tsquery ('tiếng Anh', 'chuột béo');
nhưplainto_tsquery
, ThePHRASETO_TSQUERY
Hàm sẽ không nhận ratsquery
toán tử, nhãn trọng lượng hoặc nhãn tiền tố-match trong đầu vào của nó:
chọn Phraseto_tsquery ('English', 'The Fat & Rats: C');
WebSearch_TO_TSQuery ([config
RegConfig
, ]QueryText
Text
) trả vềtsquery
websearch_to_tsquery
Tạo Atsquery
Giá trị từQueryText
Sử dụng cú pháp thay thế trong đó văn kèo bóng đá pháp không định dạng đơn giản là một truy vấn hợp lệ. Không giống nhưPlainto_tsquery
vàPHRASETO_TSQUERY
, nó cũng nhận ra các toán tử nhất định. Hơn nữa, chức năng này không bao giờ nên tăng lỗi cú pháp, điều này cho phép sử dụng đầu vào do người dùng cung cấp thô cho kèo bóng đá pháp.
văn kèo bóng đá pháp chưa được trích dẫn
&
toán tử, như thể được xử lý bởiPlainto_tsquery
.
"Văn kèo bóng đá pháp được trích dẫn"
<-
toán tử, như thể được xử lý bởiPHRASETO_TSQUERY
.
hoặc
: logic hoặc sẽ được chuyển đổi thành|
toán tử.
-
: Toán tử không logic, được chuyển đổi thành!
toán tử.
Ví dụ:
25526_26379
26608_26767PostgreSQLcung cấp hai chức năng xếp hạng được xác định trước, có tính đến thông tin từ vựng, gần và cấu trúc; Đó là, họ xem xét tần suất các thuật ngữ truy vấn xuất hiện trong tài kèo bóng đá pháp, mức độ gần nhau của các điều khoản trong tài kèo bóng đá pháp và phần quan trọng của tài kèo bóng đá pháp nơi chúng xảy ra.
Hai chức năng xếp hạng hiện có là:
ts_rank ([Trọng lượng
float4 []
,]Vector
tsVector
, Truy vấn
tsquery
[, Bình thường hóa
Số nguyên
]) trả vềfloat4
Xếp hạng vectơ dựa trên tần suất của các từ vựng phù hợp của chúng.
TS_RANK_CD ([Trọng lượng
float4 []
,]Vector
tsVector
, Truy vấn
tsquery
[, Bình thường hóa
Số nguyên
]) trả vềfloat4
Hàm này tính toánmật độ bìa29037_29276TS_RANK
Xếp hạng ngoại trừ sự gần gũi của các từ vựng phù hợp với nhau được xem xét.
Hàm này yêu cầu thông tin vị trí từ vựng để thực hiện tính toán của nó. Do đó, nó bỏ qua bất kỳbị tước”Lexeme trongtsVector
. Nếu không có từ các từ đầu không có trong đầu vào, kết quả sẽ bằng không.Phần 12.4.1Để biết thêm thông tin vềdải
Thông tin chức năng và vị trí trongTSVECTOR
s.)
Đối với cả hai chức năng này, tùy chọnTrọng lượng
Đối số cung cấp khả năng cân nhắc các phiên kèo bóng đá pháp từ ít nhiều tùy thuộc vào cách chúng được dán nhãn. Các mảng trọng lượng chỉ định mức độ cân nhắc của từng loại từ, theo thứ tự:
d-weight, c-weight, b-weight, a-weight
nếu khôngTrọng lượng
được cung cấp, sau đó các mặc định này được sử dụng:
0.1, 0.2, 0.4, 1.0
30606_30808
Vì một tài liệu dài hơn có cơ hội chứa một thuật ngữ truy vấn cao hơn, nên tính đến kích thước tài liệu tài khoản, ví dụ, một tài liệu hàng trăm từ với năm trường hợp của một từ kèo bóng đá pháp có thể phù hợp hơn một tài liệu hàng ngàn từ với năm trường hợp. Cả hai hàm xếp hạng đều có số nguyênBình thường hóa
Tùy chọn chỉ định xem độ dài của tài kèo bóng đá pháp có ảnh hưởng đến thứ hạng của nó như thế nào hay không. Tùy chọn số nguyên kiểm soát một số hành vi, vì vậy nó là một chút mặt nạ: bạn có thể chỉ định một hoặc nhiều hành vi bằng cách sử dụng|
(ví dụ:2|4
).
0 (mặc định) bỏ qua độ dài tài kèo bóng đá pháp
1 Chia thứ hạng cho 1 + logarit của độ dài tài kèo bóng đá pháp
2 Chia thứ hạng cho độ dài tài kèo bóng đá pháp
4 Chia thứ hạng cho khoảng cách hài hòa trung bình giữa các phạm vi (điều này chỉ được thực hiện bởiTS_RANK_CD
)
8 Chia thứ hạng cho số lượng từ duy nhất trong tài kèo bóng đá pháp
16 Chia thứ hạng cho 1 + logarit của số lượng từ duy nhất trong tài kèo bóng đá pháp
32 chia thứ hạng cho chính nó + 1
Nếu có nhiều hơn một bit cờ được chỉ định, các phép biến đổi được áp dụng trong đơn đặt hàng được liệt kê.
Điều quan trọng cần lưu ý là các chức năng xếp hạng không sử dụng bất kỳ thông tin toàn cầu nào, vì vậy không thể tạo ra một sự chuẩn hóa công bằng đến 1% hoặc 100% như đôi khi mong muốn. Tùy chọn chuẩn hóa 32 (Xếp hạng/(Xếp hạng+1)
) có thể được áp dụng để tỷ lệ tất cả các cấp bậc vào phạm vi từ 0 đến một, nhưng tất nhiên đây chỉ là một thay đổi mỹ phẩm; nó sẽ không ảnh hưởng đến thứ tự kết quả kèo bóng đá pháp.
Đây là một ví dụ chỉ chọn mười trận đấu xếp hạng cao nhất:
Chọn thứ hạng, TS_RANK_CD (TextSearch, Truy vấn) làm cấp bậc
Đây là cùng một ví dụ sử dụng xếp hạng chuẩn hóa:
Chọn thứ hạng, TS_RANK_CD (TextSearch, Truy vấn, 32/ * Xếp hạng/(Xếp hạng+1) */)
Xếp hạng có thể tốn kém vì nó yêu cầu tư vấntsVector
của mỗi tài kèo bóng đá pháp phù hợp, có thể bị ràng buộc I/O và do đó chậm. Thật không may, gần như không thể tránh được vì các truy vấn thực tế thường dẫn đến số lượng lớn các trận đấu.
Để trình bày kết quả kèo bóng đá pháp, thật lý tưởng để hiển thị một phần của mỗi tài liệu và cách nó liên quan đến truy vấn. Thông thường, các công cụ kèo bóng đá pháp hiển thị các đoạn của tài liệu với các thuật ngữ kèo bóng đá pháp được đánh dấu.POSTGRESQLcung cấp chức năngts_headline
thực hiện chức năng này.
ts_headline ([config
RegConfig
, ]Document
Text
,Truy vấn
tsquery
[,Tùy chọn
Text
]) trả vềText
ts_headline
Chấp nhận một tài kèo bóng đá pháp cùng với một truy vấn và trả về một đoạn trích từ tài kèo bóng đá pháp trong đó các điều khoản từ truy vấn được tô sáng. Cấu hình được sử dụng để phân tích cú pháp tài kèo bóng đá pháp có thể được chỉ định bởiconfig
; nếu nhưconfig
bị bỏ qua,default_text_search_config
Cấu hình được sử dụng.
NếuTùy chọn
Chuỗi được chỉ định, nó phải bao gồm một danh sách được phân tách bằng dấu phẩy của một hoặc nhiềuTùy chọn
=
giá trị
cặp. Các tùy chọn có sẵn là:
Maxwords
, minwords
(số nguyên): Những con số này xác định các tiêu đề dài nhất và ngắn nhất cho đầu ra. Các giá trị mặc định là 35 và 15.
Shortword
(Integer): Các từ có độ dài này hoặc ít hơn sẽ bị loại bỏ khi bắt đầu và kết thúc tiêu đề, trừ khi chúng là thuật ngữ truy vấn. Giá trị mặc định của ba bài viết tiếng Anh thông thường.
nổi bật
(boolean): nếuTRUE
Toàn bộ tài kèo bóng đá pháp sẽ được sử dụng làm tiêu đề, bỏ qua ba tham số trước đó. Mặc định làfalse
.
MaxFragments
(Số nguyên): Số lượng các đoạn văn kèo bóng đá pháp tối đa để hiển thị. Giá trị mặc định của Zero chọn phương thức tạo tiêu đề không dựa trên fragment.
startsel
, stopsel
(chuỗi): Các chuỗi để phân định các từ truy vấn xuất hiện trong tài kèo bóng đá pháp, để phân biệt chúng với các từ được trích xuất khác. Các giá trị mặc định là<b
vàMạnh</b
Hàng, có thể phù hợp cho đầu ra HTML.
FragmentDelimiter
(Chuỗi): Khi có nhiều hơn một đoạn được hiển thị, các đoạn sẽ được phân tách bằng chuỗi này. Mặc định là...
Khăn.
Những tên tùy chọn này được nhận ra không nhạy cảm với trường hợp. Bạn phải xử lý hai giá trị chuỗi nếu chúng chứa khoảng trắng hoặc dấu phẩy.
Trong thế hệ tiêu đề không dựa trên fragment,ts_headline
định vị các khớp cho đã choTruy vấn
và chọn một cái duy nhất để hiển thị, thích các trận đấu có nhiều từ truy vấn hơn trong độ dài tiêu đề được phép. Trong việc tạo tiêu đề dựa trên đoạn,ts_headline
định vị các truy vấn phù hợp và chia mỗi trận đấu thànhHồicác mảnh40338_40341của không nhiều hơnMaxWords
mỗi từ, thích các đoạn có nhiều từ truy vấn hơn và khi có thểHồikéo dàiHồicác đoạn để bao gồm các từ xung quanh. Do đó, chế độ dựa trên đoạn hữu ích hơn khi truy vấn khớp với các phần lớn của tài kèo bóng đá pháp hoặc khi mong muốn hiển thị nhiều trận đấu.minwords
Các từ trong tài kèo bóng đá pháp sẽ được hiển thị.
Ví dụ:
Chọn TS_HEADLINE ('Tiếng Anh',
ts_headline
Sử dụng tài kèo bóng đá pháp gốc, không phảitsVector
Tóm tắt, vì vậy nó có thể chậm và nên được sử dụng một cách cẩn thận.