VectorStoreCollection<TKey,TRecord>.GetAsync 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 |
|---|---|
| GetAsync(IEnumerable<TKey>, RecordRetrievalOptions, CancellationToken) |
Haalt een batch records op uit het vectorarchief. Garandeert niet dat de verzameling bestaat. |
| GetAsync(TKey, RecordRetrievalOptions, CancellationToken) |
Haalt een record op uit het vectorarchief. Garandeert niet dat de verzameling bestaat. Retourneert null als de record niet is gevonden. |
| GetAsync(Expression<Func<TRecord,Boolean>>, Int32, FilteredRecordRetrievalOptions<TRecord>, CancellationToken) |
Haalt overeenkomende records op uit het vectorarchief. Garandeert niet dat de verzameling bestaat. |
GetAsync(IEnumerable<TKey>, RecordRetrievalOptions, CancellationToken)
Haalt een batch records op uit het vectorarchief. Garandeert niet dat de verzameling bestaat.
public virtual System.Collections.Generic.IAsyncEnumerable<TRecord> GetAsync(System.Collections.Generic.IEnumerable<TKey> keys, Microsoft.Extensions.VectorData.RecordRetrievalOptions? options = default, System.Threading.CancellationToken cancellationToken = default);abstract member GetAsync : seq<'Key> * Microsoft.Extensions.VectorData.RecordRetrievalOptions * System.Threading.CancellationToken -> System.Collections.Generic.IAsyncEnumerable<'Record (requires 'Record : null)>
override this.GetAsync : seq<'Key> * Microsoft.Extensions.VectorData.RecordRetrievalOptions * System.Threading.CancellationToken -> System.Collections.Generic.IAsyncEnumerable<'Record (requires 'Record : null)>Public Overridable Function GetAsync (keys As IEnumerable(Of TKey), Optional options As RecordRetrievalOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As IAsyncEnumerable(Of TRecord)Parameters
- keys
- IEnumerable<TKey>
De unieke id's die aan de record zijn gekoppeld.
- options
- RecordRetrievalOptions
Optionele opties voor het ophalen van de records.
- cancellationToken
- CancellationToken
De CancellationToken te controleren op annuleringsaanvragen. De standaardwaarde is None.
Retouren
De records die zijn gekoppeld aan de opgegeven unieke sleutels.
Uitzonderingen
De opdracht kan om welke reden dan ook niet worden uitgevoerd.
Opmerkingen
De exacte methode voor het ophalen is implementatiespecifiek en kan variëren op basis van databaseondersteuning. De standaard implementatie van deze methode haalt de records één na de andere op, maar implementaties die ondersteuning bieden voor batchverwerking, kunnen worden overschreven om een efficiëntere implementatie te bieden.
Alleen gevonden records worden geretourneerd, zodat de resultatenset mogelijk kleiner is dan de aangevraagde sleutels.
Deze methode genereert voor andere problemen dan records die niet worden gevonden.
Van toepassing op
GetAsync(TKey, RecordRetrievalOptions, CancellationToken)
Haalt een record op uit het vectorarchief. Garandeert niet dat de verzameling bestaat. Retourneert null als de record niet is gevonden.
public abstract System.Threading.Tasks.Task<TRecord?> GetAsync(TKey key, Microsoft.Extensions.VectorData.RecordRetrievalOptions? options = default, System.Threading.CancellationToken cancellationToken = default);abstract member GetAsync : 'Key * Microsoft.Extensions.VectorData.RecordRetrievalOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Record (requires 'Record : null)>Public MustOverride Function GetAsync (key As TKey, Optional options As RecordRetrievalOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of TRecord)Parameters
- key
- TKey
De unieke id die aan de record is gekoppeld om op te halen.
- options
- RecordRetrievalOptions
Optionele opties voor het ophalen van de record.
- cancellationToken
- CancellationToken
De CancellationToken te controleren op annuleringsaanvragen. De standaardwaarde is None.
Retouren
De record indien gevonden, anders null.
Uitzonderingen
De opdracht kan om welke reden dan ook niet worden uitgevoerd.
Van toepassing op
GetAsync(Expression<Func<TRecord,Boolean>>, Int32, FilteredRecordRetrievalOptions<TRecord>, CancellationToken)
Haalt overeenkomende records op uit het vectorarchief. Garandeert niet dat de verzameling bestaat.
public abstract System.Collections.Generic.IAsyncEnumerable<TRecord> GetAsync(System.Linq.Expressions.Expression<Func<TRecord,bool>> filter, int top, Microsoft.Extensions.VectorData.FilteredRecordRetrievalOptions<TRecord>? options = default, System.Threading.CancellationToken cancellationToken = default);abstract member GetAsync : System.Linq.Expressions.Expression<Func<'Record, bool>> * int * Microsoft.Extensions.VectorData.FilteredRecordRetrievalOptions<'Record (requires 'Record : null)> * System.Threading.CancellationToken -> System.Collections.Generic.IAsyncEnumerable<'Record (requires 'Record : null)>Public MustOverride Function GetAsync (filter As Expression(Of Func(Of TRecord, Boolean)), top As Integer, Optional options As FilteredRecordRetrievalOptions(Of TRecord) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As IAsyncEnumerable(Of TRecord)Parameters
- filter
- Expression<Func<TRecord,Boolean>>
Het predicaat voor het filteren van de records.
- top
- Int32
Het maximum aantal resultaten dat moet worden geretourneerd.
Opties voor het ophalen van de records.
- cancellationToken
- CancellationToken
De CancellationToken te controleren op annuleringsaanvragen. De standaardwaarde is None.
Retouren
De records die overeenkomen met het opgegeven predicaat.
Uitzonderingen
De opdracht kan om welke reden dan ook niet worden uitgevoerd.
