Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Gestructureerd zoeken en zoeken in tekst combineren op relevantie gerangschikte tekstovereenkomsten met exacte waarden, numerieke bereiken en datumbereiken, en andere voorwaarden in één $search-fase. Neem tekst- en gestructureerde velden op in dezelfde zoekindex en gebruik vervolgens compound om de voorwaarden te combineren.
Gebruik deze aanpak voor productcatalogussen, kennisbanken en andere verzamelingen waar het matchen van tekst alleen niet voldoende is. Zoek bijvoorbeeld naar een productbeschrijving en vereis daarbij een artikel dat op voorraad is en binnen een bepaalde prijsklasse valt.
Note
Volledige-tekstzoekfunctie is in preview. Voordat u deze voorbeelden gebruikt, schakelt u de volledige-tekstzoekfunctie in op uw cluster.
Ondersteunde veldtoewijzingen
Definieer doorzoekbare velden onder mappings.fields. Kies een type dat overeenkomt met de opgeslagen waarden en de query’s die u wilt uitvoeren.
| Veldtype | Purpose | Ondersteunde query’s en sortering |
|---|---|---|
string |
Geanalyseerde tekst. |
text, vaag text, en phrase. |
document |
Container voor geneste velden. | Query’s richten zich op de expliciet toegewezen bladvelden. |
token |
Exacte tekenreekstermen, zoals id's en categorieën. |
equals, range, exists, in en inline sorteren. |
number |
Numerieke waarden. |
equals, range, exists, in en inline sorteren. |
date |
Datumwaarden. |
equals, range, exists, in, en inline sorteren. |
boolean |
Booleaanse waarden. |
equals, exists, inen inline sorteren. |
Gebruik string voor geanalyseerde taaltekst en token voor exacte tekenreeksvergelijkingen. Stel voor numerieke velden in representationdouble op of int64 indien van toepassing op uw gegevens.
Geneste velden maken gebruik van recursieve document.fields toewijzingen. Benader toegewezen leaf fields met puntnotatiepaden, zoals details.region.
Voor matrices is geen afzonderlijk toewijzingstype vereist. Breng het type van de elementen in kaart. Matrixwaarden worden geïndexeerd wanneer het type overeenkomt met de veldtoewijzing; elementen met andere typen worden niet geïndexeerd voor dat veld.
Een zoekindex maken voor tekst en gestructureerde velden
In de volgende voorbeelden worden mongoDB Shell-syntaxis en een verbonden Azure DocumentDB-cluster gebruikt waarvoor zoeken in volledige tekst is ingeschakeld. Gebruik een nieuwe verzameling met de naam products.
Voorbeelddocumenten toevoegen
Maak de verzameling en voeg documenten toe met tekst, id's, prijzen, beschikbaarheid en datums.
db.createCollection("products");
db.products.insertMany([
{
_id: 1,
title: "Bracket controller",
description: "Steel mounting bracket for a controller",
partNumber: "SKU-BRACKET-001",
category: "hardware",
price: 49.0,
inStock: true,
publishedAt: ISODate("2026-09-01T00:00:00Z"),
details: { region: "west" }
},
{
_id: 2,
title: "Bracket assembly",
description: "Heavy-duty bracket for an industrial controller",
partNumber: "SKU-BRACKET-002",
category: "hardware",
price: 129.0,
inStock: true,
publishedAt: ISODate("2026-10-01T00:00:00Z"),
details: { region: "east" }
},
{
_id: 3,
title: "Lightweight bracket",
description: "Compact bracket for a controller",
partNumber: "SKU-BRACKET-003",
category: "accessories",
price: 29.0,
inStock: false,
publishedAt: ISODate("2026-10-15T00:00:00Z"),
details: { region: "west" }
}
]);
De doorzoekbare velden toewijzen
Maak één index die betrekking heeft op elk veld dat wordt gebruikt door de query's.
db.runCommand({
createSearchIndexes: "products",
indexes: [
{
name: "idx_products_filters",
definition: {
mappings: {
dynamic: false,
fields: {
title: { type: "string" },
description: { type: "string" },
partNumber: { type: "token" },
category: { type: "token" },
price: { type: "number", representation: "double" },
inStock: { type: "boolean" },
publishedAt: { type: "date" },
details: {
type: "document",
fields: {
region: { type: "token" }
}
}
}
}
}
}
]
});
Controleer of de index gereed is
Het maken van een index kan worden voortgezet nadat de opdracht terugkeert. Wacht totdat de index status: "READY" en queryable: true meldt.
db.products.aggregate([
{ $listSearchIndexes: { name: "idx_products_filters" } }
]);
Tekst en gestructureerde voorwaarden combineren
Gebruik compound om operatordocumenten te combineren. Elke clausule bevat een array van condities.
| Clause | Behavior |
|---|---|
must |
Elke voorwaarde moet overeenkomen en draagt bij aan de relevantie. |
should |
Overeenkomende voorwaarden kunnen de relevantie verbeteren. In een query met vereiste voorwaarden hoeven ze niet overeen te komen. |
mustNot |
Overeenkomende documenten worden uitgesloten. |
filter |
Elke voorwaarde moet overeenkomen. Voorwaarden kunnen momenteel van invloed zijn op relevantie. |
De volgende query doorzoekt beide tekstvelden, vereist een product dat op voorraad is en geprijsd van 20 tot en met 100, en geeft de voorkeur aan een exacte woordgroep in de titel:
db.products.aggregate([
{
$search: {
index: "idx_products_filters",
compound: {
must: [
{
text: {
query: "bracket controller",
path: ["title", "description"],
matchCriteria: "all"
}
}
],
should: [
{
phrase: {
query: "bracket controller",
path: "title",
slop: 0
}
}
],
filter: [
{ equals: { path: "inStock", value: true } },
{ range: { path: "price", gte: 20, lte: 100 } },
{ in: { path: "category", value: ["hardware", "accessories"] } },
{ exists: { path: "publishedAt" } }
],
mustNot: [
{ equals: { path: "details.region", value: "retired" } }
]
}
}
},
{ $limit: 10 },
{
$project: {
_id: 0,
title: 1,
partNumber: 1,
price: 1,
inStock: 1,
score: { $meta: "searchScore" }
}
}
]);
Voor de voorbeeldgegevens retourneert Bracket controllerde query . De duurdere samenstel en de out-of-stock haak voldoen niet aan de vereiste voorwaarden.
Important
compound.minimumShouldMatch wordt momenteel niet ondersteund. Voorwaarden in compound.filter kunnen zowel bijdragen aan de relevantiescore als overeenkomsten beperken. Ga er niet van uit dat een filter scores ongewijzigd laat.
Gebruik gestructureerde operatoren
De gestructureerde operators matchen geïndexeerde waarden in plaats van geanalyseerde tekst. Querywaardetypen moeten overeenkomen met de veldtoewijzingen.
| Operator | Purpose | Vereiste opties |
|---|---|---|
equals |
Komt overeen met een exacte waarde. |
path en value. |
range |
Komt overeen met gebonden waarden op een number-, date- of token-veld. |
path en ten minste één van gt, gte, ltof lte. |
exists |
Komt overeen met documenten met een geïndexeerde waarde op het pad. |
path. |
in |
Komt overeen met een waarde uit een set. |
path en een value array. |
Zoek bijvoorbeeld naar een exact onderdeelnummer met equals:
db.products.aggregate([
{
$search: {
index: "idx_products_filters",
equals: {
path: "partNumber",
value: "SKU-BRACKET-001"
}
}
},
{ $limit: 10 },
{ $project: { _id: 0, title: 1, partNumber: 1 } }
]);
Gebruik voor datumbereiken datumwaarden in plaats van tekenreeksen:
db.products.aggregate([
{
$search: {
index: "idx_products_filters",
range: {
path: "publishedAt",
gte: ISODate("2026-10-01T00:00:00Z"),
lt: ISODate("2026-11-01T00:00:00Z")
}
}
},
{ $limit: 10 },
{ $project: { _id: 0, title: 1, publishedAt: 1 } }
]);
Meerdere tekstvelden doorzoeken
Geef een expliciete array van gemapte paden door om meerdere velden met text te doorzoeken. Gebruik matchCriteria: "any" om overeen te komen met elke geanalyseerde queryterm of "all" om alle geanalyseerde querytermen te vereisen.
db.products.aggregate([
{
$search: {
index: "idx_products_filters",
text: {
query: "bracket controller",
path: ["title", "description"],
matchCriteria: "all"
}
}
},
{ $limit: 20 },
{
$project: {
_id: 0,
title: 1,
description: 1,
score: { $meta: "searchScore" }
}
}
]);
U moet elk pad in de geselecteerde zoekindex opnemen. Een text query accepteert één niet-lege querytekenreeks, geen array van querytekenreeksen. Zie Custom Analyzers als u meerdere id-velden met verschillende analysevereisten wilt doorzoeken.
Querypaden met jokertekens worden niet ondersteund. Geef elk toegewezen pad expliciet op.
Zoekresultaten sorteren en beperken
Zoekresultaten worden standaard gerangschikt op aflopende relevantie. Stel sort binnen in $search om resultaten te ordenen op geïndexeerde scalaire velden.
db.products.aggregate([
{
$search: {
index: "idx_products_filters",
text: {
query: "bracket",
path: "description"
},
sort: {
inStock: -1,
price: 1,
score: { $meta: "searchScore" }
}
}
},
{ $limit: 20 },
{
$project: {
_id: 0,
title: 1,
price: 1,
inStock: 1,
score: { $meta: "searchScore" }
}
}
]);
Inline veldsortering accepteert 1 voor oplopende of -1 aflopende volgorde voor toegewezen token-, boolean-, date- en number-velden. Score sorteren is alleen aflopend. Vermijd inlinesortering op velden met arraywaarden wanneer u dezelfde semantiek voor arrayvolgorde als een downstream $sort nodig hebt.
Plaats $limit indien mogelijk direct na $search. De limiet wordt gepusht naar de zoekuitvoering, zodat de engine kan stoppen nadat de aangevraagde topresultaten zijn verzameld.
Als een voorwaarde niet kan worden uitgedrukt met een ondersteunde zoekoperator, gebruikt u een downstream $match na de laatste $limit. Het beperken van kandidaten voordat een bedrijfsfilter wordt toegepast, kan in aanmerking komende resultaten weglaten.
Huidige beperkingen
De volgende beperkingen zijn van toepassing op gestructureerde en samengestelde zoekopdrachten:
- Toewijzingen zijn statisch. U moet elke query en het inlinesorteerpad in de geselecteerde zoekindex declareren.
- De veldtypen
objectId,uuidenembeddedDocumentworden niet ondersteund. - De
near-operator wordt niet ondersteund. - De
regexenwildcardoperators binnen$searchworden niet ondersteund. - De
$searchMetafase,$$SEARCH_METAvariabele, aantallen, facetten, markeringen en aangepaste score-boosts worden niet ondersteund. - Gebruik de
dropIndexesopdracht om een zoekindex te verwijderen. Specifieke API's voor het bijwerken van zoekindexen maken geen deel uit van het momenteel ondersteunde beheeroppervlak.