{"title":"Fulltextsökning","version":"5.2","locale":"sv","docname":"ref/contrib/postgres/search","url":"/sv/5.2/ref/contrib/postgres/search/","canonical":"https://djangodocs.dev/sv/5.2/ref/contrib/postgres/search/","summary":"Databasfunktionerna i modulen django.contrib.postgres.search underlättar användningen av PostgreSQLs fulltextsökmotor . I exemplen i det här dokumentet använder vi…","html":"

FulltextsökningLink to this heading#

\n

Databasfunktionerna i modulen django.contrib.postgres.search underlättar användningen av PostgreSQLs fulltextsökmotor.

\n

I exemplen i det här dokumentet använder vi de modeller som definieras i Göra förfrågningar.

\n\n
\n

Uppslagsordet searchLink to this heading#

\n

Ett vanligt sätt att använda fulltextsökning är att söka en enskild term mot en enskild kolumn i databasen. Till exempel:

\n
Python console
>>> Entry.objects.filter(body_text__search="Cheese")\n<QuerySet [<Entry: Cheese on Toast recipes>, <Entry: Pizza Recipes>]>\n
\n

Detta skapar en to_tsvector i databasen från fältet body_text och en plainto_tsquery från söktermen 'Cheese', båda med standardkonfigurationen för databassökning. Resultaten erhålls genom att matcha frågan och vektorn.

\n

För att använda search-uppslaget måste 'django.contrib.postgres finnas i din INSTALLED_APPS.

\n
\n
\n

SökVektorLink to this heading#

\n
\n
\nclass SearchVector(*expressions, config=None, weight=None)Link to this definition#
\n
\n\n

Att söka mot ett enda fält är bra men ganska begränsande. De Entry-instanser vi söker tillhör en Blog, som har ett tagline-fält. Om du vill söka mot båda fälten använder du en SearchVector:

\n
Python console
>>> from django.contrib.postgres.search import SearchVector\n>>> Entry.objects.annotate(\n...     search=SearchVector("body_text", "blog__tagline"),\n... ).filter(search="Cheese")\n<QuerySet [<Entry: Cheese on Toast recipes>, <Entry: Pizza Recipes>]>\n
\n

Argumenten till SearchVector kan vara vilken Expression` som helst eller namnet på ett fält. Flera argument kommer att sammanfogas med ett mellanslag så att sökdokumentet innehåller dem alla.

\n

SearchVector-objekt kan kombineras med varandra, vilket gör att du kan återanvända dem. Ett exempel:

\n
Python console
>>> Entry.objects.annotate(\n...     search=SearchVector("body_text") + SearchVector("blog__tagline"),\n... ).filter(search="Cheese")\n<QuerySet [<Entry: Cheese on Toast recipes>, <Entry: Pizza Recipes>]>\n
\n

Se Ändra sökkonfigurationen och Viktning av frågor för en förklaring av parametrarna config och weight.

\n
\n
\n

SökfrågaLink to this heading#

\n
\n
\nclass SearchQuery(value, config=None, search_type='plain')Link to this definition#
\n
\n\n

SearchQuery översätter de termer som användaren anger till ett sökfrågeobjekt som databasen jämför med en sökvektor. Som standard skickas alla ord som användaren anger genom stamningsalgoritmerna och sedan letar den efter matchningar för alla resulterande termer.

\n

Om search_type är 'plain, vilket är standard, behandlas termerna som separata nyckelord. Om search_type är 'phrase behandlas termerna som en enda fras. Om search_type är 'raw kan du ange en formaterad sökfråga med termer och operatorer. Om search_type är 'websearch kan du ange en formaterad sökfråga som liknar den som används av webbsökmotorer. 'websearch' kräver PostgreSQL ≥ 11. Läs PostgreSQL: s Full Text Search docs för att lära dig mer om skillnader och syntax. Exempel:

\n
Python console
>>> from django.contrib.postgres.search import SearchQuery\n>>> SearchQuery("red tomato")  # two keywords\n>>> SearchQuery("tomato red")  # same results as above\n>>> SearchQuery("red tomato", search_type="phrase")  # a phrase\n>>> SearchQuery("tomato red", search_type="phrase")  # a different phrase\n>>> SearchQuery("'tomato' & ('red' | 'green')", search_type="raw")  # boolean operators\n>>> SearchQuery(\n...     "'tomato' ('red' OR 'green')", search_type="websearch"\n... )  # websearch operators\n
\n

termerna i SearchQuery kan kombineras logiskt för att ge mer flexibilitet:

\n
Python console
>>> from django.contrib.postgres.search import SearchQuery\n>>> SearchQuery("meat") & SearchQuery("cheese")  # AND\n>>> SearchQuery("meat") | SearchQuery("cheese")  # OR\n>>> ~SearchQuery("meat")  # NOT\n
\n

Se Ändra sökkonfigurationen för en förklaring av parametern config.

\n
\n
\n

SearchRankLink to this heading#

\n
\n
\nclass SearchRank(vector, query, weights=None, normalization=None, cover_density=False)Link to this definition#
\n
\n\n

Hittills har vi returnerat de resultat för vilka någon matchning mellan vektorn och frågan är möjlig. Det är troligt att du kanske vill ordna resultaten efter någon form av relevans. PostgreSQL tillhandahåller en rankningsfunktion som tar hänsyn till hur ofta frågetermerna visas i dokumentet, hur nära varandra termerna är i dokumentet och hur viktig den del av dokumentet är där de förekommer. Ju bättre matchning, desto högre värde på rankningen. För att beställa efter relevans:

\n
Python console
>>> from django.contrib.postgres.search import SearchQuery, SearchRank, SearchVector\n>>> vector = SearchVector("body_text")\n>>> query = SearchQuery("cheese")\n>>> Entry.objects.annotate(rank=SearchRank(vector, query)).order_by("-rank")\n<QuerySet [<Entry: Cheese on Toast recipes>, <Entry: Pizza recipes>]>\n
\n

Se Viktning av frågor för en förklaring av parametern weights.

\n

Ställ in parametern cover_density på True för att aktivera täckningsdensitetsrankningen, vilket innebär att närheten mellan matchande söktermer beaktas.

\n

Ange ett heltal till parametern normalization för att styra normalisering av rangordning. Detta heltal är en bitmask, så att du kan kombinera flera beteenden:

\n
Python console
>>> from django.db.models import Value\n>>> Entry.objects.annotate(\n...     rank=SearchRank(\n...         vector,\n...         query,\n...         normalization=Value(2).bitor(Value(4)),\n...     )\n... )\n
\n

PostgreSQL-dokumentationen har mer information om olika rangnormaliseringsalternativ.

\n
\n
\n

SökhuvudLink to this heading#

\n
\n
\nclass SearchHeadline(expression, query, config=None, start_sel=None, stop_sel=None, max_words=None, min_words=None, short_word=None, highlight_all=None, max_fragments=None, fragment_delimiter=None)Link to this definition#
\n
\n\n

Accepterar ett enda textfält eller ett uttryck, en fråga, en konfiguration och en uppsättning alternativ. Returnerar markerade sökresultat.

\n

Ställ in parametrarna start_sel och stop_sel till strängvärdena som ska användas för att linda markerade frågetermer i dokumentet. PostgreSQL: s standardvärden är <b> och </b>.

\n

Ge heltalsvärden till parametrarna max_words och min_words för att bestämma de längsta och kortaste rubrikerna. PostgreSQL: s standardvärden är 35 och 15.

\n

Ge ett heltalsvärde till parametern short_word för att kassera ord av denna längd eller mindre i varje rubrik. PostgreSQL: s standard är 3.

\n

Ställ in parametern highlight_all till True för att använda hela dokumentet i stället för ett fragment och ignorera parametrarna max_words, min_words och short_word. Det är inaktiverat som standard i PostgreSQL.

\n

Ge ett heltalsvärde som inte är noll till max_fragments för att ställa in det maximala antalet fragment som ska visas. Det är inaktiverat som standard i PostgreSQL.

\n

Ställ in strängparametern fragment_delimiter för att konfigurera avgränsaren mellan fragment. PostgreSQL: s standard är " ... ".

\n

PostgreSQL-dokumentationen har mer information om upphighlighting search results.

\n

Exempel på användning:

\n
Python console
>>> from django.contrib.postgres.search import SearchHeadline, SearchQuery\n>>> query = SearchQuery("red tomato")\n>>> entry = Entry.objects.annotate(\n...     headline=SearchHeadline(\n...         "body_text",\n...         query,\n...         start_sel="<span>",\n...         stop_sel="</span>",\n...     ),\n... ).get()\n>>> print(entry.headline)\nSandwich with <span>tomato</span> and <span>red</span> cheese.\n
\n

Se Ändra sökkonfigurationen för en förklaring av parametern config.

\n
\n
\n

Ändra sökkonfigurationenLink to this heading#

\n

Du kan ange attributet config till en SearchVector och SearchQuery för att använda en annan sökkonfiguration. Detta gör det möjligt att använda olika språkparsers och ordböcker som definieras av databasen:

\n
Python console
>>> from django.contrib.postgres.search import SearchQuery, SearchVector\n>>> Entry.objects.annotate(\n...     search=SearchVector("body_text", config="french"),\n... ).filter(search=SearchQuery("œuf", config="french"))\n<QuerySet [<Entry: Pain perdu>]>\n
\n

Värdet på config kan också lagras i en annan kolumn:

\n
Python console
>>> from django.db.models import F\n>>> Entry.objects.annotate(\n...     search=SearchVector("body_text", config=F("blog__language")),\n... ).filter(search=SearchQuery("œuf", config=F("blog__language")))\n<QuerySet [<Entry: Pain perdu>]>\n
\n
\n
\n

Viktning av frågorLink to this heading#

\n

Alla fält kanske inte har samma relevans i en fråga, så du kan ställa in vikter för olika vektorer innan du kombinerar dem:

\n
Python console
>>> from django.contrib.postgres.search import SearchQuery, SearchRank, SearchVector\n>>> vector = SearchVector("body_text", weight="A") + SearchVector(\n...     "blog__tagline", weight="B"\n... )\n>>> query = SearchQuery("cheese")\n>>> Entry.objects.annotate(rank=SearchRank(vector, query)).filter(rank__gte=0.3).order_by(\n...     "rank"\n... )\n
\n

Vikten ska vara en av följande bokstäver: D, C, B, A. Som standard hänvisar dessa vikter till siffrorna 0,1, 0,2, 0,4 respektive 1,0. Om du vill vikta dem annorlunda, skicka en lista med fyra flyttal till SearchRank som vikter i samma ordning som ovan:

\n
Python console
>>> rank = SearchRank(vector, query, weights=[0.2, 0.4, 0.6, 0.8])\n>>> Entry.objects.annotate(rank=rank).filter(rank__gte=0.3).order_by("-rank")\n
\n
\n
\n

PrestandaLink to this heading#

\n

Det krävs ingen särskild databaskonfiguration för att använda någon av dessa funktioner, men om du söker efter mer än några hundra poster kommer du sannolikt att stöta på prestandaproblem. Fulltextsökning är en mer intensiv process än att t.ex. jämföra storleken på ett heltal.

\n

Om alla fält som du söker på finns i en viss modell kan du skapa ett funktionellt GIN eller GiST index som matchar den sökvektor du vill använda. Till exempel:

\n
Code
GinIndex(\n    SearchVector("body_text", "headline", config="english"),\n    name="search_vector_idx",\n)\n
\n

PostgreSQL-dokumentationen har detaljer om att skapa index för fulltextsökning <https://www.postgresql.org/docs/current/textsearch-tables.html#TEXTSEARCH-TABLES-INDEX>`_.

\n
\n

SökVektorFieldLink to this heading#

\n
\n
\nclass SearchVectorFieldLink to this definition#
\n
\n\n

Om detta tillvägagångssätt blir för långsamt kan du lägga till en SearchVectorField i din modell. Du måste hålla den befolkad med triggers, till exempel, som beskrivs i PostgreSQL-dokumentationen. Du kan sedan fråga fältet som om det var en annoterad SearchVector:

\n
Python console
>>> Entry.objects.update(search_vector=SearchVector("body_text"))\n>>> Entry.objects.filter(search_vector="cheese")\n<QuerySet [<Entry: Cheese on Toast recipes>, <Entry: Pizza recipes>]>\n
\n
\n
\n
\n

Likhet mellan trigramLink to this heading#

\n

En annan metod för sökning är trigramlikhet. Ett trigram är en grupp med tre på varandra följande tecken. Förutom uppslagen trigram_similar, trigram_word_similar och trigram_strict_word_similar kan du använda ett par andra uttryck.

\n

För att använda dem måste du aktivera pg_trgm-tillägget på PostgreSQL. Du kan installera den med hjälp av TrigramExtension migreringsoperation.

\n
\n

TrigramSimilarityLink to this heading#

\n
\n
\nclass TrigramSimilarity(expression, string, **extra)Link to this definition#
\n
\n\n

Accepterar ett fältnamn eller uttryck och en sträng eller ett uttryck. Returnerar trigramlikheten mellan de två argumenten.

\n

Exempel på användning:

\n
Python console
>>> from django.contrib.postgres.search import TrigramSimilarity\n>>> Author.objects.create(name="Katy Stevens")\n>>> Author.objects.create(name="Stephen Keats")\n>>> test = "Katie Stephens"\n>>> Author.objects.annotate(\n...     similarity=TrigramSimilarity("name", test),\n... ).filter(\n...     similarity__gt=0.3\n... ).order_by("-similarity")\n<QuerySet [<Author: Katy Stevens>, <Author: Stephen Keats>]>\n
\n
\n
\n

TrigramordlikhetLink to this heading#

\n
\n
\nclass TrigramWordSimilarity(string, expression, **extra)Link to this definition#
\n
\n\n

Accepterar en sträng eller ett uttryck och ett fältnamn eller ett uttryck. Returnerar trigramordlikheten mellan de två argumenten.

\n

Exempel på användning:

\n
Python console
>>> from django.contrib.postgres.search import TrigramWordSimilarity\n>>> Author.objects.create(name="Katy Stevens")\n>>> Author.objects.create(name="Stephen Keats")\n>>> test = "Kat"\n>>> Author.objects.annotate(\n...     similarity=TrigramWordSimilarity(test, "name"),\n... ).filter(\n...     similarity__gt=0.3\n... ).order_by("-similarity")\n<QuerySet [<Author: Katy Stevens>]>\n
\n
\n
\n

TrigramStrictWordSimilarityLink to this heading#

\n
\n
\nclass TrigramStrictWordSimilarity(string, expression, **extra)Link to this definition#
\n
\n\n

Accepterar en sträng eller ett uttryck och ett fältnamn eller ett uttryck. Returnerar den trigramstrikta ordlikheten mellan de två argumenten. Liknar TrigramWordSimilarity(), förutom att den tvingar gränser för utsträckning att matcha ordgränser.

\n
\n
\n

TrigramDistanceLink to this heading#

\n
\n
\nclass TrigramDistance(expression, string, **extra)Link to this definition#
\n
\n\n

Accepterar ett fältnamn eller uttryck och en sträng eller ett uttryck. Returnerar trigramavståndet mellan de två argumenten.

\n

Exempel på användning:

\n
Python console
>>> from django.contrib.postgres.search import TrigramDistance\n>>> Author.objects.create(name="Katy Stevens")\n>>> Author.objects.create(name="Stephen Keats")\n>>> test = "Katie Stephens"\n>>> Author.objects.annotate(\n...     distance=TrigramDistance("name", test),\n... ).filter(\n...     distance__lte=0.7\n... ).order_by("distance")\n<QuerySet [<Author: Katy Stevens>, <Author: Stephen Keats>]>\n
\n
\n
\n

TrigramWordDistanceLink to this heading#

\n
\n
\nclass TrigramWordDistance(string, expression, **extra)Link to this definition#
\n
\n\n

Accepterar en sträng eller ett uttryck och ett fältnamn eller ett uttryck. Returnerar trigramordavståndet mellan de två argumenten.

\n

Exempel på användning:

\n
Python console
>>> from django.contrib.postgres.search import TrigramWordDistance\n>>> Author.objects.create(name="Katy Stevens")\n>>> Author.objects.create(name="Stephen Keats")\n>>> test = "Kat"\n>>> Author.objects.annotate(\n...     distance=TrigramWordDistance(test, "name"),\n... ).filter(\n...     distance__lte=0.7\n... ).order_by("distance")\n<QuerySet [<Author: Katy Stevens>]>\n
\n
\n
\n

TrigramStrictWordDistanceLink to this heading#

\n
\n
\nclass TrigramStrictWordDistance(string, expression, **extra)Link to this definition#
\n
\n\n

Accepterar en sträng eller ett uttryck och ett fältnamn eller ett uttryck. Returnerar det trigramstrikta ordavståndet mellan de två argumenten.

\n
\n
","rootId":"full-text-search","toc":[{"title":"Uppslagsordet search","anchor":"the-search-lookup","children":[]},{"title":"SökVektor","anchor":"searchvector","children":[]},{"title":"Sökfråga","anchor":"searchquery","children":[]},{"title":"SearchRank","anchor":"searchrank","children":[]},{"title":"Sökhuvud","anchor":"searchheadline","children":[]},{"title":"Ändra sökkonfigurationen","anchor":"changing-the-search-configuration","children":[]},{"title":"Viktning av frågor","anchor":"weighting-queries","children":[]},{"title":"Prestanda","anchor":"performance","children":[{"title":"SökVektorField","anchor":"searchvectorfield","children":[]}]},{"title":"Likhet mellan trigram","anchor":"trigram-similarity","children":[{"title":"TrigramSimilarity","anchor":"trigramsimilarity","children":[]},{"title":"Trigramordlikhet","anchor":"trigramwordsimilarity","children":[]},{"title":"TrigramStrictWordSimilarity","anchor":"trigramstrictwordsimilarity","children":[]},{"title":"TrigramDistance","anchor":"trigramdistance","children":[]},{"title":"TrigramWordDistance","anchor":"trigramworddistance","children":[]},{"title":"TrigramStrictWordDistance","anchor":"trigramstrictworddistance","children":[]}]}],"breadcrumbs":[{"docname":"ref/index","title":"API-referens","url":"/sv/5.2/ref/"},{"docname":"ref/contrib/index","title":"contrib paket","url":"/sv/5.2/ref/contrib/"},{"docname":"ref/contrib/postgres/index","title":"django.contrib.postgres","url":"/sv/5.2/ref/contrib/postgres/"}],"prev":{"docname":"ref/contrib/postgres/operations","title":"Migrering av databaser","url":"/sv/5.2/ref/contrib/postgres/operations/"},"next":{"docname":"ref/contrib/postgres/validators","title":"Validerare","url":"/sv/5.2/ref/contrib/postgres/validators/"},"formats":{"html":"/sv/5.2/ref/contrib/postgres/search/","markdown":"/sv/5.2/ref/contrib/postgres/search.md","json":"/sv/5.2/ref/contrib/postgres/search.json"},"source":"https://github.com/django/django/blob/stable/5.2.x/docs/ref/contrib/postgres/search.txt","official":"https://docs.djangoproject.com/sv/5.2/ref/contrib/postgres/search/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}