Ringkasan kueri

Halaman ini menjelaskan fungsi SEARCH dan mode kueri yang ditingkatkan, yang digunakan untuk menjalankan kueri penelusuran teks lengkap di tabel Spanner.

Membuat kueri indeks penelusuran

Spanner menyediakan fungsi SEARCH untuk digunakan untuk kueri indeks penelusuran. Contoh kasus penggunaan adalah aplikasi tempat pengguna memasukkan teks di kotak penelusuran dan aplikasi mengirim input pengguna langsung ke fungsi SEARCH. Fungsi SEARCH kemudian akan menggunakan indeks penelusuran untuk menemukan teks tersebut.

Fungsi SEARCH memerlukan dua argumen:

  • Nama indeks penelusuran
  • Kueri penelusuran

Fungsi SEARCH hanya berfungsi jika indeks penelusuran ditentukan. Fungsi SEARCH dapat digabungkan dengan konstruksi SQL arbitrer, seperti filter, agregasi, atau join.

Fungsi SEARCH tidak dapat digunakan dengan kueri transaksi.

Kueri berikut menggunakan fungsi SEARCH untuk menampilkan semua album yang memiliki friday atau monday dalam judul:

GoogleSQL 

SELECT AlbumId
FROM Albums
WHERE SEARCH(AlbumTitle_Tokens, 'friday OR monday')

PostgreSQL

Contoh ini menggunakan spanner.search.

SELECT albumid
FROM albums
WHERE spanner.search(albumtitle_tokens, 'friday OR monday')

Kueri penelusuran

Kueri penelusuran menggunakan sintaksis kueri penelusuran mentah secara default. Sintaksis alternatif dapat ditentukan menggunakan argumen SEARCH dialect.

dialek rquery

Dialek default-nya adalah kueri penelusuran mentah. Spanner menggunakan bahasa khusus domain (DSL) yang disebut rquery.

Bahasa rquery mengikuti aturan yang sama dengan tokenizer teks biasa saat membagi kueri penelusuran input menjadi istilah yang berbeda. Hal ini mencakup segmentasi bahasa Asia.

Untuk informasi tentang cara menggunakan rquery, lihat sintaksis rquery.

dialek kata

Dialek kata seperti rquery, tetapi lebih sederhana. Operator ini tidak menggunakan operator khusus. Misalnya, OR diperlakukan sebagai istilah penelusuran, bukan operator disjungsi. Tanda kutip ganda ditangani sebagai tanda baca, bukan penelusuran frasa, dan diabaikan.

Dengan dialek kata, AND diterapkan secara implisit ke semua istilah, dan diperlukan selama pencocokan. Fungsi ini mengikuti aturan yang sama dengan pemisah teks biasa saat membagi kueri penelusuran input menjadi istilah.

Untuk informasi tentang penggunaan dialek kata, lihat sintaksis kata.

dialek words_phrase

Dialek words_phrase tidak menggunakan operator khusus dan semua istilah diperlakukan sebagai frasa, yang berarti istilah harus berdekatan dan dalam urutan yang ditentukan.

Sama seperti rquery, dialek words_phrase mengikuti aturan yang sama dengan tokenizer teks biasa saat membagi kueri penelusuran input menjadi istilah.

Untuk informasi tentang cara menggunakan dialek words_phrase, lihat sintaksis ungkapan kata.

Mode kueri yang ditingkatkan

Spanner menawarkan dua mode penelusuran teks lengkap: penelusuran dasar berbasis token dan mode lanjutan yang disebut enhance_query. Jika diaktifkan, enhance_query akan memperluas kueri penelusuran untuk menyertakan istilah dan sinonim terkait, sehingga meningkatkan kemungkinan menemukan hasil yang relevan.

Untuk mengaktifkan opsi ini, tetapkan argumen opsional enhance_query=>true dalam fungsi SEARCH. Misalnya, kueri penelusuran hotl cal cocok dengan album Hotel California.

GoogleSQL 

SELECT AlbumId
FROM Albums
WHERE SEARCH(AlbumTitle_Tokens, 'hotl cal', enhance_query=>true)

PostgreSQL 

SELECT albumid
FROM albums
WHERE spanner.search(albumtitle_tokens, 'hotl cal', enhance_query=>true)

Mode enhance_query adalah opsi waktu kueri. Hal ini tidak memengaruhi tokenisasi. Anda dapat menggunakan indeks penelusuran yang sama dengan atau tanpa enhance_query.

Google terus meningkatkan algoritma peningkatan kueri. Akibatnya, kueri dengan enhance_query == true mungkin menghasilkan hasil yang sedikit berbeda dari waktu ke waktu.

Jika mode enhance_query diaktifkan, mode ini dapat meningkatkan jumlah istilah yang dicari fungsi SEARCH yang dapat sedikit meningkatkan latensi.

Misalnya, kueri berikut menggunakan waktu tunggu tiga detik dan gagal jika enhance_query tidak tersedia:

GoogleSQL 

@{require_enhance_query=true, enhance_query_timeout_ms=3000}
SELECT AlbumId
FROM Albums
WHERE SEARCH(AlbumTitle_Tokens, 'fast car', enhance_query=>true)

PostgreSQL 

/*@require_enhance_query=true, enhance_query_timeout_ms=3000*/
SELECT albumid
FROM albums
WHERE spanner.search(albumtitle_tokens, 'fast car', enhance_query=>true)

Persyaratan kueri SQL

Ada beberapa kondisi yang harus dipenuhi kueri SQL untuk menggunakan indeks penelusuran. Jika kondisi ini tidak terpenuhi, kueri akan menggunakan rencana kueri alternatif atau gagal jika tidak ada rencana alternatif.

Kueri harus memenuhi kondisi berikut:

  • Fungsi SEARCH dan SEARCH_SUBSTRING memerlukan indeks penelusuran. Spanner tidak mendukung fungsi ini dalam kueri terhadap tabel dasar atau indeks sekunder.

  • Indeks partisi harus memiliki semua kolom partisi yang terikat oleh kondisi kesetaraan dalam klausul WHERE kueri.

    Misalnya, jika indeks penelusuran ditentukan sebagai PARTITION BY x, y, kueri harus memiliki konjungsi dalam klausul WHERE dari x = <parameter or constant> AND y = <parameter or constant>. Indeks penelusuran tersebut tidak dipertimbangkan oleh pengoptimal kueri jika kondisi tersebut tidak ada.

  • Semua kolom TOKENLIST yang dirujuk oleh operator SEARCH dan SEARCH_SUBSTRING harus diindeks dalam indeks penelusuran yang sama.

    Misalnya, pertimbangkan tabel dan definisi indeks berikut:

    GoogleSQL 

    CREATE TABLE Albums (
    AlbumId STRING(MAX) NOT NULL,
    AlbumTitle STRING(MAX),
    AlbumStudio STRING(MAX),
    AlbumTitle_Tokens TOKENLIST AS (TOKENIZE_FULLTEXT(AlbumTitle)) HIDDEN,
    AlbumStudio_Tokens TOKENLIST AS (TOKENIZE_FULLTEXT(AlbumStudio)) HIDDEN
) PRIMARY KEY(AlbumId);

CREATE SEARCH INDEX AlbumsTitleIndex ON Albums(AlbumTitle_Tokens);
CREATE SEARCH INDEX AlbumsStudioIndex ON Albums(AlbumStudio_Tokens);

    PostgreSQL 

    CREATE TABLE albums (
    albumid character varying NOT NULL,
    albumtitle character varying,
    albumstudio character varying,
    albumtitle_tokens spanner.tokenlist GENERATED ALWAYS AS (spanner.tokenize_fulltext(albumtitle)) VIRTUAL HIDDEN,
    albumstudio_tokens spanner.tokenlist GENERATED ALWAYS AS (spanner.tokenize_fulltext(albumstudio)) VIRTUAL HIDDEN,
PRIMARY KEY(albumid));

CREATE SEARCH INDEX albumstitleindex ON albums(albumtitle_tokens);
CREATE SEARCH INDEX albumsstudioindex ON albums(albumstudio_tokens);

    Kueri berikut gagal karena tidak ada satu indeks penelusuran yang mengindeks AlbumTitle_Tokens dan AlbumStudio_Tokens:

    GoogleSQL 

    SELECT AlbumId
FROM Albums
WHERE SEARCH(AlbumTitle_Tokens, @p1)
    AND SEARCH(AlbumStudio_Tokens, @p2)

    PostgreSQL

    Contoh ini menggunakan parameter kueri $1 dan $2 yang masing-masing terikat dengan 'fast car' dan 'blue note'.

    SELECT albumid
FROM albums
WHERE spanner.search(albumtitle_tokens, $1)
    AND spanner.search(albumstudio_tokens, $2)

  • Jika kolom urutan pengurutan bersifat nullable, skema dan kueri harus mengecualikan baris dengan kolom urutan pengurutan NULL. Untuk mengetahui detailnya, lihat Urutan pengurutan indeks penelusuran.

  • Jika indeks penelusuran difilter NULL, kueri harus menyertakan ekspresi pemfilteran NULL yang sama dengan yang digunakan dalam indeks. Lihat Indeks penelusuran yang difilter NULL untuk mengetahui detailnya.

  • Indeks penelusuran dan fungsi penelusuran tidak didukung di DML, DML yang dipartisi, atau kueri yang dipartisi.

  • Indeks penelusuran dan fungsi penelusuran biasanya digunakan dalam transaksi hanya baca. Jika persyaratan aplikasi mengizinkan hasil yang sudah tidak berlaku, Anda mungkin dapat meningkatkan latensi dengan menjalankan kueri penelusuran dengan durasi tidak berlaku selama 10 detik atau lebih. Untuk mengetahui informasi selengkapnya, lihat Membaca data yang tidak berlaku. Hal ini sangat berguna untuk kueri penelusuran yang menyebar ke banyak pemisahan indeks.

Indeks penelusuran dan fungsi penelusuran tidak direkomendasikan dalam transaksi baca-tulis. Selama eksekusi, kueri penelusuran mengunci seluruh partisi indeks; akibatnya, tingkat kueri penelusuran yang tinggi dalam transaksi baca-tulis dapat menyebabkan konflik kunci yang menyebabkan lonjakan latensi. Secara default, indeks penelusuran tidak dipilih secara otomatis dalam transaksi baca-tulis. Jika kueri dipaksa untuk menggunakan indeks penelusuran dalam transaksi baca-tulis, kueri akan gagal secara default. Fungsi ini juga akan gagal jika kueri berisi salah satu fungsi penelusuran. Perilaku ini dapat diganti dengan petunjuk tingkat pernyataan @{ALLOW_SEARCH_INDEXES_IN_TRANSACTION=TRUE} GoogleSQL (tetapi kueri masih rentan terhadap konflik kunci).

Setelah kondisi kelayakan indeks terpenuhi, pengoptimal kueri akan mencoba mempercepat kondisi kueri non-teks (seperti Rating > 4). Jika indeks penelusuran tidak menyertakan kolom TOKENLIST yang sesuai, kondisi tersebut tidak akan dipercepat dan tetap menjadi kondisi residual.

Parameter kueri

Argumen kueri penelusuran ditentukan sebagai literal atau parameter kueri. Sebaiknya gunakan parameter kueri untuk penelusuran teks lengkap, bukan literal string jika argumen mengizinkan nilai parameter kueri.

Pemilihan indeks

Spanner biasanya memilih indeks yang paling efisien untuk kueri menggunakan pemodelan berbasis biaya. Namun, petunjuk FORCE_INDEX secara eksplisit menginstruksikan Spanner untuk menggunakan indeks penelusuran tertentu. Misalnya, contoh berikut menunjukkan cara memaksa Spanner menggunakan AlbumsIndex:

GoogleSQL 

SELECT AlbumId
FROM Albums @{FORCE_INDEX=AlbumsIndex}
WHERE SEARCH(AlbumTitle_Tokens, "fifth symphony")

PostgreSQL 

SELECT albumid
FROM albums/*@force_index=albumsindex*/
WHERE spanner.search(albumtitle_tokens, 'fifth symphony')

Jika indeks penelusuran yang ditentukan tidak memenuhi syarat, kueri akan gagal, meskipun ada indeks penelusuran lain yang memenuhi syarat.

Cuplikan di hasil penelusuran

Cuplikan adalah potongan teks yang diekstrak dari string tertentu yang memberi pengguna gambaran tentang isi hasil penelusuran, dan alasan hasil tersebut relevan dengan kueri mereka.

Misalnya, Gmail menggunakan cuplikan untuk menunjukkan bagian email yang cocok dengan kueri penelusuran:

Daftar cuplikan

Membuat database menghasilkan cuplikan memiliki beberapa manfaat:

  1. Kemudahan: Anda tidak perlu menerapkan logika untuk membuat cuplikan dari kueri penelusuran.
  2. Efisiensi: Cuplikan mengurangi ukuran output dari server.

Fungsi SNIPPET membuat cuplikan. Metode ini menampilkan bagian yang relevan dari nilai string asli beserta posisi karakter yang akan ditandai. Klien kemudian dapat memilih cara menampilkan cuplikan kepada pengguna akhir (misalnya, menggunakan teks yang ditandai atau dicetak tebal).

Misalnya, kode berikut menggunakan SNIPPET untuk mengambil teks dari AlbumTitle:

GoogleSQL 

SELECT AlbumId, SNIPPET(AlbumTitle, "Fast Car")
FROM Albums
WHERE SEARCH(AlbumTitle_Tokens, "Fast Car")

PostgreSQL

Contoh ini menggunakan spanner.snippet.

SELECT albumid, spanner.snippet(albumtitle, 'Fast Car')
FROM albums
WHERE spanner.search(albumtitle_tokens, 'Fast Car')

Langkah berikutnya