FeedOptions interface

Voorwaarden die aan de aanvraag zijn gekoppeld.

accessCondition?: { condition: string, type: string }

Waarde van eigenschap

Alleen geldig voor niet-streamingvolgorde per query. Standaard: onwaar; Als deze optie is ingesteld op true, kunnen query's het standaardgedrag omzeilen dat niet-streamingquery's zonder boven- of limietclausules blokkeert.

allowUnboundedNonStreamingQueries?: boolean

Waarde van eigenschap

Schakel buffering van extra items in tijdens query's. Standaard: onwaar

Hiermee wordt een extra pagina tegelijk gebufferd (vermenigvuldigd met maxDegreeOfParallelism) van de server op de achtergrond. Dit verbetert de latentie door pagina's op te halen voordat deze nodig zijn voor de client. Als u alle resultaten van de server leegloopt, zoals .fetchAll, moet u dit meestal inschakelen. Als u slechts één pagina tegelijk ophaalt via een vervolgtoken, moet u dit vermijden. Als u meer dan één pagina leegloopt, maar niet de volledige resultatenset, kan dit helpen de latentie te verbeteren, maar wordt de totale hoeveelheid RU/s verhoogd om de hele query te verwerken (omdat sommige pagina's meer dan één keer worden opgehaald).

bufferItems?: boolean

Waarde van eigenschap

Ondoorzichtig token voor het voortzetten van de opsomming. Standaard: niet gedefinieerd

continuation?: string

Waarde van eigenschap

Ondoorzichtig token voor het voortzetten van de opsomming. Standaard: niet gedefinieerd

continuationToken?: string

Waarde van eigenschap

Hiermee beperkt u de grootte van het vervolgtoken in het antwoord. Standaard: niet gedefinieerd

Vervolgtokens bevatten optionele gegevens die uit de serialisatie kunnen worden verwijderd voordat ze naar een header worden geschreven. Dit wordt standaard beperkt tot 1 kB om lange kopteksten te voorkomen (Node.js een limiet heeft voor de grootte van globale headers). Een gebruiker kan dit veld instellen om langere headers toe te staan, waardoor de back-end de uitvoering van query's kan optimaliseren."

continuationTokenLimitInKB?: number

Waarde van eigenschap

Standaard: false. Als deze optie is ingesteld op true, wordt de optimalisatie van het plan voor hybride zoekquery's uitgeschakeld. Deze optimalisatie is standaard ingeschakeld en wordt gebruikt om de prestaties van hybride zoekopdrachten te verbeteren.

disableHybridSearchQueryPlanOptimization?: boolean

Waarde van eigenschap

Schakel de nietStreamingOrderBy-queryfunctie uit in ondersteunde queryfuncties. Standaard: false. Ingesteld op True om fouten te voorkomen van een oude gateway die deze functie niet ondersteunt.

disableNonStreamingOrderByQuery?: boolean

Waarde van eigenschap

Hiermee bepaalt u het gedrag van de uitvoering van query's. Standaard: false. Als de query is ingesteld op onwaar, wordt het opnieuw geprobeerd totdat de resultaten gereed zijn en maxItemCount zijn bereikt, wat enige tijd kan duren voor grote partities met relatief kleine gegevens. Als deze instelling is ingesteld op true, worden partities gescand tot maxDegreeOfParallelism, worden resultaten aan de buffer toegevoegd en wordt geretourneerd wat beschikbaar is. Als de resultaten niet klaar zijn, wordt een leeg antwoord geretourneerd.

enableQueryControl?: boolean

Waarde van eigenschap

Scan toestaan op de query's die niet kunnen worden uitgevoerd als indexering, is afgemeld voor de aangevraagde paden. Standaard: onwaar

Over het algemeen is het raadzaam om te voorkomen dat u deze instelling gebruikt. Scans zijn relatief duur en het duurt lang om te dienen.

enableScanInQuery?: boolean

Waarde van eigenschap

Met deze instelling wordt de query gedwongen een queryplan te gebruiken. Standaard: onwaar

Opmerking: hiermee wordt ondersteuning voor vervolgtoken uitgeschakeld, zelfs voor query's met één partitie.

Voor query's zoals aggregaties en de meeste query's voor meerdere partities gebeurt dit toch. Omdat de bibliotheek echter niet weet welk type query het is totdat we het eerste antwoord terugkrijen, kan sommige optimalisatie pas later plaatsvinden.

Als deze instelling is ingeschakeld, wordt het queryplan voor de query afgedwongen, waardoor sommige netwerkaanvragen worden opgeslagen en ervoor wordt gezorgd dat parallellisme kan plaatsvinden. Handig als u weet dat u query's tussen partities of statistische query's uitvoert.

forceQueryPlan?: boolean

Waarde van eigenschap

Het maximum aantal gelijktijdige bewerkingen waarop clientzijde wordt uitgevoerd tijdens parallelle uitvoering van query's in de Azure Cosmos DB-databaseservice. Negatieve waarden zorgen ervoor dat het systeem automatisch bepaalt hoeveel gelijktijdige bewerkingen moeten worden uitgevoerd. Standaard: 0 (geen parallelle uitvoering)

maxDegreeOfParallelism?: number

Waarde van eigenschap

Maximum aantal items dat moet worden geretourneerd in de opsommingsbewerking. Standaard: niet gedefinieerd (door de server gedefinieerde nettolading)

Expirimenting met deze waarde kan meestal leiden tot de grootste prestatiewijzigingen in de query.

Hoe kleiner het aantal items, hoe sneller het eerste resultaat wordt geleverd (voor niet-aggregaties). Voor grotere hoeveelheden duurt het langer om de aanvraag te verwerken, maar meestal krijgt u een betere doorvoer voor grote query's (bijvoorbeeld als u 1000 items nodig hebt voordat u andere acties kunt uitvoeren, stelt u maxItemCount in op 1000. Als u na de eerste 100 aan het werk kunt gaan, stelt u maxItemCount in op 100.)

maxItemCount?: number

Waarde van eigenschap

Hiermee wordt de query beperkt tot een specifieke partitiesleutel. Standaard: niet gedefinieerd

Het bereik van een query naar één partitie kan op twee manieren worden uitgevoerd:

container.items.query('SELECT * from c', { partitionKey: "foo" }).toArray() container.items.query('SELECT * from c WHERE c.yourPartitionKey = "foo"').toArray()

Het eerste is handig wanneer de hoofdtekst van de query buiten uw besturingselement valt, maar u deze nog steeds wilt beperken tot één partitie. Voorbeeld: een door de eindgebruiker opgegeven query.

partitionKey?: PartitionKey

Waarde van eigenschap

Schakel metrische indexgegevens in antwoordheaders in. Standaard: onwaar

populateIndexMetrics?: boolean

Waarde van eigenschap

Schakel metrische querygegevens in antwoordheaders in. Standaard: onwaar

Wordt gebruikt voor het opsporen van fouten in trage of dure query's. Verhoogt ook de antwoordgrootte en als u een lage maximale headergrootte in Node.jsgebruikt, kunt u sneller problemen ondervinden.

populateQueryMetrics?: boolean

Waarde van eigenschap

Opmerking: overweeg in plaats daarvan changeFeed te gebruiken.

Hiermee wordt een aanvraag voor een wijzigingenfeed aangegeven. Moet worden ingesteld op 'Incrementele feed' of anders worden weggelaten. Standaard: onwaar

useIncrementalFeed?: boolean

Waarde van eigenschap

Hiermee geeft u een aangepaste maximale buffergrootte op voor het opslaan van uiteindelijke resultaten voor nietStreamingOrderBy-query's. Deze waarde wordt genegeerd als de query top-/offset+limit-componenten bevat.

vectorSearchBufferSize?: number

Waarde van eigenschap

abortSignal om alle onderliggende netwerkaanvragen door te geven die door deze methodeaanroep zijn gemaakt. Zie https://developer.mozilla.org/en-US/docs/Web/API/AbortController

Voorbeeld

Een leesaanvraag annuleren

import { CosmosClient } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });

const { database } = await client.databases.createIfNotExists({ id: "Test Database" });

const { container } = await database.containers.createIfNotExists({ id: "Test Container" });

const controller = new AbortController();
const results = container.items.query("SELECT * from c", {
  abortSignal: controller.signal,
});

abortSignal?: AbortSignal

Waarde van eigenschap

overgenomen vanSharedOptions.abortSignal-

Sets als geïntegreerde cache moet worden overgeslagen of ingeschakeld voor de aanvraag in de Azure CosmosDB-service.

De standaardwaarde is onwaar. Standaard is geïntegreerde cache ingeschakeld

bypassIntegratedCache?: boolean

Waarde van eigenschap

overgenomen vanSharedOptions.bypassIntegratedCache

Consistentieniveau dat door de client is vereist.

consistencyLevel?: string

Waarde van eigenschap

Overgeërfd vanSharedOptions.consistencyLevel

DisableRUPerMinuteUsage wordt gebruikt om aanvraageenheden (RU's)/minuutcapaciteit in te schakelen om de aanvraag te verwerken als de reguliere ingerichte RU's/seconde uitgeput zijn.

disableRUPerMinuteUsage?: boolean

Waarde van eigenschap

Overgeërfd vanSharedOptions.disableRUPerMinuteUsage

Sluit een of meer Azure-regio's uit voor de bewerking.

Deze optie wordt alleen toegepast wanneer enableEndPointDiscovery is ingesteld op true.

excludedLocations?: string[]

Waarde van eigenschap

Overgeërfd vanSharedOptions.excludedLocations

(Geavanceerd gebruiksvoorbeeld) Eerste headers om mee te beginnen bij het verzenden van aanvragen naar Cosmos

initialHeaders?: CosmosHeaders

Waarde van eigenschap

overgenomen vanSharedOptions.initialHeaders

Hiermee stelt u de verouderingswaarde in die is gekoppeld aan de aanvraag in de Azure CosmosDB-service. Voor aanvragen waarbij de <xref:com.azure.cosmos.ConsistencyLevel> is <xref:com.azure.cosmos.ConsistencyLevel%23EVENTUAL> of <xref:com.azure.cosmos.ConsistencyLevel%23SESSION>, zijn reacties van de geïntegreerde cache gegarandeerd niet verlopen dan de waarde die wordt aangegeven door deze maxIntegratedCacheStaleness. Als het consistentieniveau niet is ingesteld, wordt deze eigenschap genegeerd.

De standaardwaarde is null

Cache veroudering wordt ondersteund in milliseconden granulariteit. Alles wat kleiner is dan milliseconden, wordt genegeerd.

maxIntegratedCacheStalenessInMs?: number

Waarde van eigenschap

overgenomen vanSharedOptions.maxIntegratedCacheStalenessInMs

Prioriteitsniveau (laag/hoog) voor elke aanvraag. Aanvragen met een lage prioriteit worden altijd beperkt voordat aanvragen met een hoge prioriteit worden ingediend.

De standaardwaarde is null. Standaard hebben alle aanvragen een hoge prioriteit

priorityLevel?: PriorityLevel

Waarde van eigenschap

overgenomen vanSharedOptions.priorityLevel

Hiermee schakelt u het ophalen van aan documentcontainerquotum gerelateerde statistieken voor leesaanvragen voor documentcontainers in of uit.

sessionToken?: string

Waarde van eigenschap

overgenomen vanSharedOptions.sessionToken

Doorvoerbucket voor een aanvraag.

De standaardwaarde is null. In dit geval kan de aanvraag 100% van de partitiedoorvoer gebruiken.

Ga voor meer informatie naar [Cosmos DB throughput Bucketing](https://aka.ms/cosmsodb-bucketing).

throughputBucket?: number

Waarde van eigenschap

Overgenomen vanSharedOptions.throughputBucket