Kaip pridėti paiešką į savo programėlę: nuo paprastų filtrų iki viso teksto paieškos

Kad pridėtumėte paiešką į programėlę, pradėkite nuo paprasčiausio veikiančio dalyko: paieškos lauko, kuris kviečia serverio maršrutą, filtruoja jūsų duomenų bazės eilutes pagal užklausos atitikimą keliuose stulpeliuose, ir papildomų filtrų kategorijai ar kainai. Kai to nepakanka – reikia rezultatų reitingavimo, žodžių šaknų atpažinimo ar daug įrašų – perjunkite į duomenų bazės viso teksto paiešką, o talpinamą paieškos variklį naudokite tik tada, kai reikia stiprios klaidų tolerancijos ar momentinių rezultatų labai dideliuose duomenyse. Kad ir ką pasirinktumėte, paieška turi paisyti teisių: vartotojai niekada neturėtų rasti įrašų, kurių nemato.

Ką reiškia „paieška“ jūsų programėlei

Paieška apima keletą skirtingų dalykų, ir daugumai programėlių reikia daugiau nei vieno:

• Raktažodžių paieška: teksto laukas – „rasti skelbimus, kuriuose minimas „sodas““.
• Filtrai: struktūruoti pasirinkimai – kategorija, miestas, kainų intervalas, data, būsena.
• Rikiavimas: naujausi, pigiausi, svarbiausi.
• Automatinis pasiūlymas: pasiūlymai rašant.
• Klaidų tolerancija: „restuarant“ vis tiek randa „restaurant“.

Katalogui, darbo skelbimų lentai ar parduotuvei filtrai dažnai svarbesni nei teksto laukas. Prieš renkantis įrankį nuspręskite, ko iš tikrųjų reikia.

Jūsų variantai

Jei jūsų duomenys jau saugomi Postgres, jo įmontuota viso teksto paieška yra stiprus vidurio variantas. Ji skaido tekstą į žodžius, redukuoja juos iki šaknų (taip „running“ atitinka „run“), ignoruoja dažnus žodžius ir gali rikiuoti rezultatus pagal atitikimo kokybę. Su tinkamu indeksu ji išlieka greita didelėse lentelėse.

Pavyzdiniai raginimai

Paprastas startas:

Pridėk paieškos lauką ir filtrus skelbimų puslapyje. Paieška turi atitikti užklausą pavadinime ir aprašyme, nepriklausomai nuo raidžių dydžio. Filtrai: kategorija (išskleidžiamasis sąrašas), miestas (išskleidžiamasis sąrašas) ir didžiausia kaina. Paiešką vykdyk serveryje su puslapiuotu API maršrutu, 20 rezultatų puslapyje. Paieškos ir filtrų būseną laikyk URL, kad rezultatais būtų galima dalytis ir veiktų grįžimo mygtukas. Kai nieko nerasta, rodyk draugišką tuščios būsenos pranešimą.

Perėjimas prie viso teksto paieškos:

Perjunk skelbimų paiešką į Postgres viso teksto paiešką pavadinime (aukštesnis svoris) ir aprašyme. Pridėk tinkamą indeksą, rikiuok rezultatus pagal svarbą ir palik esamus filtrus bei puslapiavimą. Nekeisk jokių esamų duomenų.

Klaidų tolerancija vardams:

Pridėk neaiškų atitikimą pagal verslo pavadinimą, kad nedidelės klaidos vis tiek rastų rezultatus. Naudok trigramų panašumą, jei yra, su indeksu, o jei nėra – grįžk prie dabartinės paieškos.

Žingsnis po žingsnio

1. Surašykite, ko žmonės ieško. Kuriuose laukuose (pavadinimas, aprašymas, žymos, vardas)? Kokie filtrai? Jei galite, paklauskite kelių tikrų vartotojų.
2. Pradėkite nuo serverio. Pridėkite API maršrutą, kuris priima užklausą ir filtrus ir grąžina vieną rezultatų puslapį. Nekraukite visko į naršyklę.
3. Taikykite teises užklausoje. Jei vartotojai mato tik savo įrašus ar tik paskelbtus, ta sąlyga turi būti toje pačioje užklausoje kaip ir paieška.
4. Pridėkite puslapiavimą nuo pat pradžios – puslapių numerius arba „įkelti daugiau“.
5. Laikykite paieškos būseną URL (pavyzdžiui ?q=sodas&city=vilnius). Taip nuorodomis galima dalytis, veikia grįžimo mygtukas, o paieškos robotai gali indeksuoti filtruotus puslapius, jei to norite.
6. Atidėkite paiešką rašant. Palaukite kelis šimtus milisekundžių po to, kai nustojote rašyti, prieš siųsdami užklausą, kad nesiųstumėte užklausos kiekvienam klavišui.
7. Pridėkite indeksus, kai žinote, pagal kuriuos stulpelius filtruojate ir ieškote.
8. Tobulinkite: viso teksto paieška, tada neaiškus atitikimas, tada talpinamas variklis – tik tada, kai paprastesnis žingsnis nepatenkina tikrų vartotojų.
9. Testuokite su panašiais į realius duomenimis: šimtais ar tūkstančiais eilučių, keistais simboliais, tuščiomis ir labai ilgomis užklausomis, kitomis kalbomis, jei jas palaikote.

Dažniausios klaidos

• Visos lentelės įkėlimas į naršyklę. Tinka 50 įrašų, bet skauda su 50 000, ir atskleidžia kiekvieną įrašą – įskaitant tuos, kurių vartotojas neturėtų matyti.
• Paieška, ignoruojanti teises. Paieška – dažnas nutekėjimas: privatus ar juodraštinis įrašas pasirodo, nes paieškos užklausa pamiršo sąlygą „tik mano“ ar „tik paskelbti“.
• SQL kūrimas iš neapdorotos vartotojo įvesties. Visada naudokite parametrizuotas užklausas. DI kūrimo įrankis paprastai taip daro, bet patikrinkite, ar nematote eilučių, sulipdytų kartu.
• Jokios tuščios būsenos. „Rezultatų nerasta“ su pasiūlymu (išvalyti filtrus, patikrinti rašybą) neleidžia žmonėms išeiti.
• Jokių indeksų. Paieška su testiniais duomenimis atrodo gerai, bet lėtėja augant tikriems duomenims.
• Šuolis tiesiai prie paieškos paslaugos. Tada turite laikyti antrą duomenų kopiją sinchronizuotą, tvarkyti trynimus ir apsaugoti dar vieną raktų rinkinį – dažnai be matomos naudos.
• Mobiliųjų pamiršimas. Filtrai turi tilpti telefone; filtrų stalčius ar sutraukiamas skydelis paprastai veikia geriau nei šoninė juosta.

Kontrolinis sąrašas

• Žinote, kurie laukai ieškomi ir kokie filtrai egzistuoja
• Paieška vykdoma serveryje ir grąžina puslapiuotus rezultatus
• Užklausa taiko tas pačias teises kaip ir visa kita programėlė
• Vartotojo įvestis perduodama kaip parametrai, niekada nesulipdoma į SQL
• Paieškos būsena laikoma URL
• Rašymas atidedamas (debounce)
• Ieškomi ir filtruojami stulpeliai indeksuoti
• Tuščios, be rezultatų ir klaidų būsenos aiškios
• Išbandyta realistiškais duomenų kiekiais ir netvarkingąja įvestimi

Paieškos pridėjimas su Mythex

Programėlėje, sukurtoje su Mythex, duomenys paprastai saugomi projekto Postgres duomenų bazėje, todėl galite pradėti nuo aukščiau pateiktų raginimų: pirmiausia šablono atitikimas, o kai reikia reitingavimo – Postgres viso teksto paieška. Jei norite talpinamo paieškos variklio, naudokite savo paskyrą ir raktą, saugokite jį kaip projekto paslaptį ir paprašykite agento indeksuoti bei vykdyti užklausas iš serverio, kaip aprašyta Integruokite bet kokį API.

Paieška – daugelio programėlių pagrindas: žr. kaip sukurti katalogo svetainę, kaip sukurti darbo skelbimų lentą ir kaip sukurti rinką, kaip ji susijusi su likusiu produktu.

Klausimai