Lakukan kueri frasa cocok menggunakan Tablestore SDK untuk Python - Tablestore

Kueri frasa cocok mirip dengan kueri cocok, tetapi kueri frasa cocok mengevaluasi posisi token. Baris memenuhi kondisi kueri hanya jika urutan dan posisi token dalam baris sesuai dengan urutan dan posisi token dalam kata kunci. Jika metode tokenisasi kolom yang ingin Anda kueri adalah tokenisasi fuzzy, kueri frasa cocok memiliki latensi lebih rendah dibandingkan kueri wildcard.

Prasyarat

Sebuah instance OTSClient telah diinisialisasi. Untuk informasi lebih lanjut, lihat Inisialisasi Klien Tablestore.
Sebuah tabel data telah dibuat dan data telah ditulis ke tabel tersebut. Untuk informasi lebih lanjut, lihat Buat Tabel Data dan Tulis Data.
Indeks pencarian telah dibuat untuk tabel data. Untuk informasi lebih lanjut, lihat Buat Indeks Pencarian.

Parameter

Parameter	Deskripsi
field_name	Nama kolom yang ingin Anda kueri. Anda dapat melakukan kueri cocok pada kolom TEXT.
text	Kata kunci yang digunakan untuk mencocokkan nilai kolom saat Anda melakukan kueri frasa cocok. Jika kolom yang ingin Anda kueri adalah kolom TEXT, kata kunci akan di-tokenisasi menjadi beberapa token berdasarkan tipe analisis yang Anda tentukan saat membuat indeks pencarian. Secara default, tokenisasi satu kata dilakukan jika Anda tidak menentukan tipe analisis saat membuat indeks pencarian. Sebagai contoh, jika Anda melakukan kueri frasa cocok menggunakan frase "this is", "..., this is tablestore" dan "this is a table" akan dikembalikan. "this table is ..." atau "is this a table" tidak akan dikembalikan.
query	Tipe kueri. Atur parameter ini ke MatchPhraseQuery.
table_name	Nama tabel data.
index_name	Nama indeks pencarian.
limit	Jumlah maksimum baris yang ingin Anda kembalikan dalam kueri saat ini. Untuk hanya mengkueri jumlah baris yang memenuhi kondisi kueri tanpa mengkueri data spesifik dari baris-baris tersebut, atur parameter limit ke 0.
get_total_count	Menentukan apakah akan mengembalikan jumlah total baris yang memenuhi kondisi kueri. Nilai default dari parameter ini adalah false, yang menentukan bahwa jumlah total baris yang memenuhi kondisi kueri tidak dikembalikan. Jika Anda mengatur parameter ini ke true, kinerja kueri akan terpengaruh.
columns_to_get	Menentukan apakah akan mengembalikan semua kolom dari setiap baris yang memenuhi kondisi kueri. Jika Anda mengatur field return_type ke ColumnReturnType.SPECIFIED, Anda dapat menggunakan field column_names untuk menentukan kolom-kolom yang ingin Anda kembalikan. Jika Anda mengatur field return_type ke ColumnReturnType.ALL, semua kolom akan dikembalikan. Jika Anda mengatur field return_type ke ColumnReturnType.NONE, hanya kolom kunci utama yang akan dikembalikan.

Contoh

Contoh berikut menjelaskan cara menggunakan kueri frasa cocok untuk mengkueri baris-baris yang nilai kolom Col_Text-nya cocok dengan frasa 'this is' secara berurutan.

Lakukan kueri frasa cocok menggunakan Tablestore SDK for Python V5.2.1 atau yang lebih baru

Jika Anda menggunakan Tablestore SDK for Python V5.2.1 atau yang lebih baru untuk melakukan kueri frasa cocok, objek SearchResponse akan dikembalikan secara default. Kode berikut memberikan contoh permintaan:

query = MatchPhraseQuery('Col_Text', 'this is')
search_response = client.search(
    '<TABLE_NAME>', '<SEARCH_INDEX_NAME>', 
    SearchQuery(query, limit=100, get_total_count=True), 
    ColumnsToGet(return_type=ColumnReturnType.ALL)
)
print('request_id : %s' % search_response.request_id)
print('is_all_succeed : %s' % search_response.is_all_succeed)
print('total_count : %s' % search_response.total_count)
print('rows : %s' % search_response.rows)

# # Jika paging mendalam diperlukan, kami sarankan Anda mengonfigurasi parameter next_token karena metode ini tidak memiliki batasan pada kedalaman paging.
# all_rows = []
# next_token = None
# # putaran pertama
# search_response = client.search(
#     '<TABLE_NAME>', '<SEARCH_INDEX_NAME>',
#     SearchQuery(query, next_token=next_token, limit=100, get_total_count=True),
#     columns_to_get=ColumnsToGet(return_type=ColumnReturnType.ALL))
# all_rows.extend(search_response.rows)
# 
# # loop
# while search_response.next_token:
#     search_response = client.search(
#         '<TABLE_NAME>', '<SEARCH_INDEX_NAME>',
#         SearchQuery(query, next_token=search_response.next_token, limit=100, get_total_count=True),
#         columns_to_get=ColumnsToGet(return_type=ColumnReturnType.ALL))
#     all_rows.extend(search_response.rows)
# print('Total rows:%s' % len(all_rows))

Anda dapat menggunakan contoh permintaan berikut untuk mengembalikan hasil tipe Tuple:

query = MatchPhraseQuery('Col_Text', 'this is')
rows, next_token, total_count, is_all_succeed, agg_results, group_by_results = client.search(
    '<TABLE_NAME>', '<SEARCH_INDEX_NAME>', 
    SearchQuery(query, limit=100, get_total_count=True), 
    ColumnsToGet(return_type=ColumnReturnType.ALL)
).v1_response()

Lakukan kueri frasa cocok menggunakan Tablestore SDK for Python versi sebelum 5.2.1
Jika Anda menggunakan versi Tablestore SDK for Python yang lebih lama dari V5.2.1 untuk melakukan kueri frasa cocok, hasil tipe TUPLE akan dikembalikan secara default. Contoh kode berikut memberikan contoh permintaan:
```
query = MatchPhraseQuery('Col_Text', 'this is')
rows, next_token, total_count, is_all_succeed = client.search(
    '<TABLE_NAME>', '<SEARCH_INDEX_NAME>', 
    SearchQuery(query, limit=100, get_total_count=True), 
    ColumnsToGet(return_type=ColumnReturnType.ALL)
)
```

FAQ

Referensi

Saat menggunakan indeks pencarian untuk mengkueri data, Anda dapat menggunakan metode kueri berikut: kueri tepat, kueri terms, kueri cocok semua, kueri cocok, kueri frasa cocok, kueri awalan, kueri rentang, kueri wildcard, kueri geo, kueri Boolean, kueri vektor KNN, kueri nested, dan kueri exists. Anda dapat menggunakan metode kueri yang disediakan oleh indeks pencarian untuk mengkueri data dari berbagai dimensi sesuai kebutuhan bisnis Anda.
Anda dapat mengurutkan atau membagi halaman baris yang memenuhi kondisi kueri dengan menggunakan fitur pengurutan dan paging. Untuk informasi lebih lanjut, lihat Pengurutan dan Paging.
Anda dapat menggunakan fitur collapse (distinct) untuk meruntuhkan set hasil berdasarkan kolom tertentu. Dengan cara ini, data dari tipe yang ditentukan muncul hanya sekali dalam hasil kueri. Untuk informasi lebih lanjut, lihat Collapse (Distinct).
Jika Anda ingin menganalisis data dalam tabel data, Anda dapat menggunakan fitur agregasi operasi Search atau menjalankan pernyataan SQL. Sebagai contoh, Anda dapat memperoleh nilai minimum dan maksimum, jumlah, dan jumlah total baris. Untuk informasi lebih lanjut, lihat Agregasi dan Kueri SQL.
Jika Anda ingin memperoleh semua baris yang memenuhi kondisi kueri tanpa perlu mengurutkan baris-baris tersebut, Anda dapat memanggil operasi ParallelScan dan ComputeSplits untuk menggunakan fitur pemindaian paralel. Untuk informasi lebih lanjut, lihat Pemindaian Paralel.