{"title":"Cuardach","version":"5.2","locale":"ga","docname":"topics/db/search","url":"/ga/5.2/topics/db/search/","canonical":"https://djangodocs.dev/ga/5.2/topics/db/search/","summary":"Tasc coitianta d'fheidhmchláir gréasáin is ea roinnt sonraí sa bhunachar sonraí a chuardach le hionchur úsáideora. I gcás simplí, d'fhéadfadh sé seo a bheith ag…","html":"<h1>Cuardach<a class=\"heading-anchor\" href=\"#search\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>Tasc coitianta d'fheidhmchláir gréasáin is ea roinnt sonraí sa bhunachar sonraí a chuardach le hionchur úsáideora. I gcás simplí, d'fhéadfadh sé seo a bheith ag scagadh liosta rudaí de réir catagóire. D'fhéadfadh go mbeadh gá le cás úsáide níos casta cuardach le meáchain, catagóiriú, aibhsiú, teangacha éagsúla, agus mar sin de. Míníonn an doiciméad seo cuid de na cásanna úsáide féideartha agus na huirlisí is féidir leat a úsáid.</p>\n<p>Déanfaimid tagairt do na samhlacha céanna a úsáidtear in:doc: /topics/db/queries.</p>\n<section id=\"use-cases\">\n<h2>Úsáid Cásanna<a class=\"heading-anchor\" href=\"#use-cases\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<section id=\"standard-textual-queries\">\n<h3>Ceisteanna téacsúla caighdeán<a class=\"heading-anchor\" href=\"#standard-textual-queries\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>Tá rogha oibríochtaí meaitseála ag réimsí téacs-bhunaithe. Mar shampla, b'fhéidir gur mhaith leat údar a chuardach mar sin a cheadú:</p>\n<div class=\"code-block\" data-language=\"pycon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Python console</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Python console code\"><code><span class=\"gp\">&gt;&gt;&gt; </span><span class=\"n\">Author</span><span class=\"o\">.</span><span class=\"n\">objects</span><span class=\"o\">.</span><span class=\"n\">filter</span><span class=\"p\">(</span><span class=\"n\">name__contains</span><span class=\"o\">=</span><span class=\"s2\">&quot;Terry&quot;</span><span class=\"p\">)</span>\n<span class=\"go\">[&lt;Author: Terry Gilliam&gt;, &lt;Author: Terry Jones&gt;]</span>\n</code></pre></div>\n<p>Is réiteach an-leochaileach é seo mar éilíonn sé ar an úsáideoir fotheagán cruinn d'ainm an údair a fháil amach. D'fhéadfadh cur chuige níos fearr a bheith ina mheaitseáil cás-neamh-íogair (:lookup: icontains), ach níl sé seo ach beagán níos fearr.</p>\n</section>\n<section id=\"a-database-s-more-advanced-comparison-functions\">\n<h3>Feidhmeanna comparáide níos airde bunachar sonraí<a class=\"heading-anchor\" href=\"#a-database-s-more-advanced-comparison-functions\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>Má tá PostgreSQL á úsáid agat, soláthraíonn Django: doc: <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">`</span></a>rogha uirlisí sonracha bunachar sonraí' chun ligean duit roghanna fiosrúcháin níos casta a gh&lt;/ref/contrib/postgres/search&gt; iaráil. Tá roghanna éagsúla uirlisí ag bunachair sonraí eile, b'fhéidir trí bhreiseáin nó feidhmeanna sainmhínithe Ní chuimsíonn Django aon tacaíocht dóibh ag an am seo. Úsáidfimid roinnt samplaí ó PostgreSQL chun an cineál feidhmiúlachta a d'fhéadfadh a bheith ag bunachair sonraí a thaispeáint.</p>\n<aside class=\"admonition-searching-in-other-databases admonition\">\n<p class=\"admonition-title\">Cuardach i mbunachair sonraí eile</p>\n<p>Tá na huirlisí cuardaigh go léir a sholáthraí:mod: django.contrib.postgres tógtha go hiomlán ar APIs poiblí mar: doc: saincheaptha lookups agus:doc: <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">`</span></a>feidhmeanna bunachar sonraí&lt;/ref/models/lookups&gt; &lt;/ref/models/database-functions&gt; <a href=\"#id3\"><span class=\"problematic\" id=\"id4\">`</span></a>. Ag brath ar do bhunachar sonraí, ba cheart go mbeadh tú in ann ceisteanna a thógáil chun APIs comhchosúla Má tá rudaí ar leith ann nach féidir a bhaint amach ar an mbealach seo, oscail ticéad le do thoil.</p>\n</aside>\n<p>Sa sampla thuas, chinneamar go mbeadh cuardach neamhíogair cás níos úsáideach. &lt;unaccent&gt;Agus tú ag déileáil le hainmneacha neamh-Bhéarla, is é feabhas breise le húsáid:lookup: <a href=\"#id1\"><span class=\"problematic\" id=\"id2\">`</span></a>comparáid unacented <a href=\"#id3\"><span class=\"problematic\" id=\"id4\">`</span></a>:</p>\n<div class=\"code-block\" data-language=\"pycon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Python console</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Python console code\"><code><span class=\"gp\">&gt;&gt;&gt; </span><span class=\"n\">Author</span><span class=\"o\">.</span><span class=\"n\">objects</span><span class=\"o\">.</span><span class=\"n\">filter</span><span class=\"p\">(</span><span class=\"n\">name__unaccent__icontains</span><span class=\"o\">=</span><span class=\"s2\">&quot;Helen&quot;</span><span class=\"p\">)</span>\n<span class=\"go\">[&lt;Author: Helen Mirren&gt;, &lt;Author: Helena Bonham Carter&gt;, &lt;Author: Hélène Joy&gt;]</span>\n</code></pre></div>\n<p>Taispeánann sé seo saincheist eile, áit a bhfuilimid ag meaitseáil i gcoinne litriú difriúil an ainm. Sa chás seo tá neamhshiméadracht againn áfach - piocfaidh cuardach ar <code class=\"docutils literal notranslate\"><span class=\"pre\">Helen</span></code> suas <code class=\"docutils literal notranslate\"><span class=\"pre\">Helena</span></code> nó <code class=\"docutils literal notranslate\"><span class=\"pre\">Hélène</span></code>, ach ní an cúil. Rogha eile ba ea comparáid a: lookup: trigram_similar a úsáid, a dhéanann comparáid idir seicheamh litreacha.</p>\n<p>Mar shampla:</p>\n<div class=\"code-block\" data-language=\"pycon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Python console</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Python console code\"><code><span class=\"gp\">&gt;&gt;&gt; </span><span class=\"n\">Author</span><span class=\"o\">.</span><span class=\"n\">objects</span><span class=\"o\">.</span><span class=\"n\">filter</span><span class=\"p\">(</span><span class=\"n\">name__unaccent__lower__trigram_similar</span><span class=\"o\">=</span><span class=\"s2\">&quot;Hélène&quot;</span><span class=\"p\">)</span>\n<span class=\"go\">[&lt;Author: Helen Mirren&gt;, &lt;Author: Hélène Joy&gt;]</span>\n</code></pre></div>\n<p>Anois tá fadhb dhifriúil againn - ní thaispeánann ainm níos faide “Helena Bonham Carter” mar tá sé i bhfad níos faide. Measann cuardaigh Trigram gach teaglaim de thrí litir, agus déanann siad comparáid idir cé mhéad atá le feiceáil i dteaghráin cuardaigh agus foinse Maidir leis an ainm níos faide, tá níos mó teaglaim ann nach bhfuil le feiceáil sa sreang foinse, mar sin ní mheastar gur dlúthmheaitseáil é a thuilleadh.</p>\n<p>Braitheann an rogha ceart feidhmeanna comparáide anseo ar do shraith sonraí, mar shampla an teanga/na teanga/na teangacha a úsáidtear agus an cineál téacs atá á chuardach. Tá na samplaí go léir a chonaic muid ar teaghráin ghearra inar dócha go gcuirfidh an t-úsáideoir rud éigin gar (trí shainmhínithe éagsúla) do na sonraí foinse.</p>\n</section>\n<section id=\"document-based-search\">\n<h3>Cuardach doiciméadarbhun<a class=\"heading-anchor\" href=\"#document-based-search\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>Stopann oibríochtaí caighdeánacha bunachar sonraí ina chur chuige úsáideach nuair a thosaíonn tú ag smaoineamh ar bh Cé gur féidir smaoineamh ar na samplaí thuas mar oibríochtaí ar shreang carachtair, féachann cuardach téacs iomlán ar na focail iarbhír. Ag brath ar an gcóras a úsáidtear, is dócha go n-úsáidfidh sé cuid de na smaointe seo a leanas:</p>\n<ul class=\"simple\">\n<li><p>Neamhaird a dhéanamh ar “focail stad” mar “a”, “an”, “agus”.</p></li>\n<li><p>Focail a spreagadh, ionas go meastar go bhfuil “pánach” agus “pánaigh” cosúil leo.</p></li>\n<li><p>Focail mheáchain bunaithe ar chritéir éagsúla amhail cé chomh minic a bhíonn siad le feiceáil sa téacs, nó tábhacht na réimsí, amhail an teideal nó an eochairfhocail, a bhfuil siad le feiceáil iontu.</p></li>\n</ul>\n<p>Tá go leor roghanna eile ann maidir le bogearraí cuardaigh a úsáid, is iad <a class=\"reference external\" href=\"https://www.elastic.co/\">Elastic</a> agus <a class=\"reference external\" href=\"https://solr.apache.org/\">Solr</a> cuid de na cinn is suntasaí. Is réitigh chuardaigh iomlána bunaithe ar dhoiciméid iad seo Chun iad a úsáid le sonraí ó mhúnlaí Django, beidh ciseal ag teastáil uait a aistríonn do chuid sonraí go doiciméad téacsúil, lena n-áirítear cúltagairtí do idí bunachar sonraí. Nuair a chuireann cuardach ag baint úsáide as an inneall doiciméad áirithe ar ais, is féidir leat é a lorg suas sa bhunachar sonraí ansin. Tá éagsúlacht leabharlanna tríú páirtí ann atá deartha chun cabhrú leis an bpróiseas seo.</p>\n<section id=\"postgresql-support\">\n<h4>Tacaíocht PostgreSQL<a class=\"heading-anchor\" href=\"#postgresql-support\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h4>\n<p>Tá a chur i bhfeidhm cuardaigh téacs iomlán féin ionsuite ag PostgreSQL. Cé nach bhfuil sé chomh cumhachtach le roinnt innill chuardaigh eile, tá an buntáiste aige a bheith taobh istigh de do bhunachar sonraí agus mar sin is féidir é a chomhcheangal go héasca le ceisteanna gaolmhara eile mar chatagóiriú.</p>\n<p>Soláthraíonn an modúl:MOD: django.contrib.postgres roinnt cúntóirí chun na ceisteanna seo a dhéanamh. Mar shampla, d'fhéadfadh ceist na hiontrálacha blag go léir a luann “cáis” a roghnú:</p>\n<div class=\"code-block\" data-language=\"pycon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Python console</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Python console code\"><code><span class=\"gp\">&gt;&gt;&gt; </span><span class=\"n\">Entry</span><span class=\"o\">.</span><span class=\"n\">objects</span><span class=\"o\">.</span><span class=\"n\">filter</span><span class=\"p\">(</span><span class=\"n\">body_text__search</span><span class=\"o\">=</span><span class=\"s2\">&quot;cheese&quot;</span><span class=\"p\">)</span>\n<span class=\"go\">[&lt;Entry: Cheese on Toast recipes&gt;, &lt;Entry: Pizza recipes&gt;]</span>\n</code></pre></div>\n<p>Is féidir leat scagadh freisin ar mheascán de réimsí agus ar mhúnlaí gaolmhara:</p>\n<div class=\"code-block\" data-language=\"pycon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Python console</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Python console code\"><code><span class=\"gp\">&gt;&gt;&gt; </span><span class=\"n\">Entry</span><span class=\"o\">.</span><span class=\"n\">objects</span><span class=\"o\">.</span><span class=\"n\">annotate</span><span class=\"p\">(</span>\n<span class=\"gp\">... </span>    <span class=\"n\">search</span><span class=\"o\">=</span><span class=\"n\">SearchVector</span><span class=\"p\">(</span><span class=\"s2\">&quot;blog__tagline&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;body_text&quot;</span><span class=\"p\">),</span>\n<span class=\"gp\">... </span><span class=\"p\">)</span><span class=\"o\">.</span><span class=\"n\">filter</span><span class=\"p\">(</span><span class=\"n\">search</span><span class=\"o\">=</span><span class=\"s2\">&quot;cheese&quot;</span><span class=\"p\">)</span>\n<span class=\"go\">[</span>\n<span class=\"go\">    &lt;Entry: Cheese on Toast recipes&gt;,</span>\n<span class=\"go\">    &lt;Entry: Pizza Recipes&gt;,</span>\n<span class=\"go\">    &lt;Entry: Dairy farming in Argentina&gt;,</span>\n<span class=\"go\">]</span>\n</code></pre></div>\n<p>Féach an doiciméad <code class=\"docutils literal notranslate\"><span class=\"pre\">contrib.postgres</span></code>:doc: /ref/contrib/postgres/search le haghaidh sonraí iomlána.</p>\n</section>\n</section>\n</section>","rootId":"search","toc":[{"title":"Úsáid Cásanna","anchor":"use-cases","children":[{"title":"Ceisteanna téacsúla caighdeán","anchor":"standard-textual-queries","children":[]},{"title":"Feidhmeanna comparáide níos airde bunachar sonraí","anchor":"a-database-s-more-advanced-comparison-functions","children":[]},{"title":"Cuardach doiciméadarbhun","anchor":"document-based-search","children":[{"title":"Tacaíocht PostgreSQL","anchor":"postgresql-support","children":[]}]}]}],"breadcrumbs":[{"docname":"topics/index","title":"Using Django","url":"/ga/5.2/topics/"},{"docname":"topics/db/index","title":"Samhlacha agus bunachair sonraí","url":"/ga/5.2/topics/db/"}],"prev":{"docname":"topics/db/aggregation","title":"Comhiomlánú","url":"/ga/5.2/topics/db/aggregation/"},"next":{"docname":"topics/db/managers","title":"Bainisteoirí","url":"/ga/5.2/topics/db/managers/"},"formats":{"html":"/ga/5.2/topics/db/search/","markdown":"/ga/5.2/topics/db/search.md","json":"/ga/5.2/topics/db/search.json"},"source":"https://github.com/django/django/blob/stable/5.2.x/docs/topics/db/search.txt","official":"https://docs.djangoproject.com/ga/5.2/topics/db/search/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}