FT.SEARCH

FT.SEARCH menelusuri indeks dengan kueri yang disediakan, lalu menampilkan nilai yang ditentukan.

Untuk mengetahui detail tentang sintaksis kueri, lihat Sintaksis kueri.

Sintaksis

FT.SEARCH index query
  [NOCONTENT]
  [TIMEOUT timeout]
  [PARAMS nargs name value [ name value ...]]
  [LIMIT offset num]
  DIALECT 2
  • index (wajib diisi): Indeks ini ingin Anda kueri.
  • query (wajib diisi): Ini adalah kueri Anda. Untuk mengetahui detail tentang sintaksis kueri, lihat Sintaksis kueri.
  • NOCONTENT (opsional): Metode ini hanya menampilkan ID dokumen, dan mengecualikan konten.
  • TIMEOUT (opsional): Memungkinkan Anda menetapkan nilai waktu tunggu untuk perintah penelusuran.
  • PARAMS (opsional): Jumlah pasangan nilai kunci dikali dua.
  • [LIMIT offset num] (opsional): Memungkinkan Anda memilih penomoran halaman dengan offset dan jumlah angka. Jika Anda tidak menggunakan parameter ini, defaultnya adalah LIMIT 0 10, yang menampilkan maksimal 10 kunci.
  • DIALECT 2 (opsional): Menentukan dialek Anda. Satu-satunya dialek yang didukung adalah dialek 2.

Pengembalian perintah

  • Perintah ini menampilkan array atau pesan error. Elemen array yang ditampilkan mewakili hasil kueri yang paling cocok. Setiap elemen array memiliki hal berikut:

  • Kunci hash entri

  • Array dari yang berikut ini:

    • Nilai kunci: [$score_as ] score_value
    • Nilai jarak
    • Nama atribut
    • Nilai vektor

    Jika NOCONTENT digunakan, elemen array hanya terdiri dari ID dokumen.

Contoh

Untuk contoh ini, asumsikan Anda membuat indeks HNSW pada kolom hash Vec. Misalkan Anda telah menambahkan beberapa entri Hash yang berisi nama kolom berikut, dan ingin menemukan vektor yang paling cocok dengan vektor input tertentu.

Nama kolom hash:

  • Vec - nilai kolom berisi vektor yang sebenarnya.
  • some_hash_key - Beberapa metadata vektor terkait.

Untuk menjalankan penelusuran, gunakan perintah FT.SEARCH:

FT.SEARCH idx "*=>[KNN 3 @vec $BLOB EF_RUNTIME 40 AS score]" PARAMS 2 BLOB
"\x12\xa9\xf5\x6c" DIALECT 2

Array yang ditampilkan:

[3, b'key_192', [b'__embedding_score', b'0.061539709568', b'embedding', b'd\xdeA?\xb7\\xbb>!\xb3\xd8>0\x94n?\xbd\xbco=WX\xe4>kN\x9e>\x1aV0>Z\x92*?\rD\x04>', b'some_hash_key', b'some_hash_key_value_192'], b'key_209', [b'__embedding_score', b'0.0803312063217', b'embedding', b's\xe1W?\xa4\x1d\xad>\xb8\x99Q?\xa9u ?6\xc8\xb2>=j5?!\x13\x96>~\x13\xb9=\xebcX?\x92\x86\xb8>', b'some_hash_key', b'some_hash_key_value_209'], b'key_821', [b'__embedding_score', b'0.0615693926811', b'embedding', b')\x1e\x03?\xa6\x10\xe0>^-\xa1\x00\x87>\x18u\xa2=\x06\xa2;>,\xeb=?\x0e%\xa4>', b'some_hash_key', b'some_hash_key_value_821']]