VectorStoreCollection<TKey,TRecord>.UpsertAsync Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Overloads
| Name | Description |
|---|---|
| UpsertAsync(IEnumerable<TRecord>, CancellationToken) |
Hiermee wordt een batch records in het vectorarchief geplaatst. Garandeert niet dat de verzameling bestaat. Als de record al bestaat, wordt deze bijgewerkt. Als de record niet bestaat, wordt deze gemaakt. |
| UpsertAsync(TRecord, CancellationToken) |
Hiermee wordt een record in het vectorarchief geplaatst. Garandeert niet dat de verzameling bestaat. Als de record al bestaat, wordt deze bijgewerkt. Als de record niet bestaat, wordt deze gemaakt. |
UpsertAsync(IEnumerable<TRecord>, CancellationToken)
Hiermee wordt een batch records in het vectorarchief geplaatst. Garandeert niet dat de verzameling bestaat. Als de record al bestaat, wordt deze bijgewerkt. Als de record niet bestaat, wordt deze gemaakt.
public abstract System.Threading.Tasks.Task UpsertAsync(System.Collections.Generic.IEnumerable<TRecord> records, System.Threading.CancellationToken cancellationToken = default);abstract member UpsertAsync : seq<'Record (requires 'Record : null)> * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic MustOverride Function UpsertAsync (records As IEnumerable(Of TRecord), Optional cancellationToken As CancellationToken = Nothing) As TaskParameters
- records
- IEnumerable<TRecord>
De records tot upsert.
- cancellationToken
- CancellationToken
De CancellationToken te controleren op annuleringsaanvragen. De standaardwaarde is None.
Retouren
Een Task bewerking die wordt voltooid wanneer de records zijn geupert.
Uitzonderingen
De opdracht kan om welke reden dan ook niet worden uitgevoerd.
Opmerkingen
De exacte methode voor het upserteren van de batch is implementatiespecifiek en kan variëren op basis van databaseondersteuning.
Op dezelfde manier kan het foutgedrag variëren tussen databases: waar mogelijk moet de batch atomisch worden geuperteerd, zodat eventuele fouten ertoe leiden dat de hele batch wordt teruggedraaid. Indien niet ondersteund, worden sommige records mogelijk upsert terwijl andere niet. Als de sleuteleigenschappen door de gebruiker zijn ingesteld, is de hele upsert-bewerking idempotent en kan deze eenvoudig opnieuw worden geprobeerd als er een fout optreedt. Als door een archief gegenereerde sleutels echter worden gebruikt, is de upsert-bewerking niet langer idempotent; Als de database in dat geval geen garantie biedt voor atomiciteit, kan het opnieuw proberen ertoe leiden dat dubbele records worden gemaakt.
Implementaties van moeten deze methode implementeren op een manier die het genereren van VectorStoreCollection<TKey,TRecord> insluiting eenmaal voor de batch uitvoert, in plaats van afzonderlijk een insluiting voor elke record te genereren. Dit is de reden waarom er geen standaard implementatie wordt opgegeven die niet wordt aanroepen UpsertAsync(TRecord, CancellationToken) .
Van toepassing op
UpsertAsync(TRecord, CancellationToken)
Hiermee wordt een record in het vectorarchief geplaatst. Garandeert niet dat de verzameling bestaat. Als de record al bestaat, wordt deze bijgewerkt. Als de record niet bestaat, wordt deze gemaakt.
public abstract System.Threading.Tasks.Task UpsertAsync(TRecord record, System.Threading.CancellationToken cancellationToken = default);abstract member UpsertAsync : 'Record * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic MustOverride Function UpsertAsync (record As TRecord, Optional cancellationToken As CancellationToken = Nothing) As TaskParameters
- record
- TRecord
De record tot upsert.
- cancellationToken
- CancellationToken
De CancellationToken te controleren op annuleringsaanvragen. De standaardwaarde is None.
Retouren
Een Task bewerking die wordt voltooid wanneer de record is geupert.
Uitzonderingen
De opdracht kan om welke reden dan ook niet worden uitgevoerd.
