VectorStoreCollection<TKey,TRecord>.GetAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| Name | Beschreibung |
|---|---|
| GetAsync(IEnumerable<TKey>, RecordRetrievalOptions, CancellationToken) |
Ruft einen Batch von Datensätzen aus dem Vektorspeicher ab. Garantiert nicht, dass die Auflistung vorhanden ist. |
| GetAsync(TKey, RecordRetrievalOptions, CancellationToken) |
Ruft einen Datensatz aus dem Vektorspeicher ab. Garantiert nicht, dass die Auflistung vorhanden ist. Gibt NULL zurück, wenn der Datensatz nicht gefunden wird. |
| GetAsync(Expression<Func<TRecord,Boolean>>, Int32, FilteredRecordRetrievalOptions<TRecord>, CancellationToken) |
Ruft übereinstimmende Datensätze aus dem Vektorspeicher ab. Garantiert nicht, dass die Auflistung vorhanden ist. |
GetAsync(IEnumerable<TKey>, RecordRetrievalOptions, CancellationToken)
Ruft einen Batch von Datensätzen aus dem Vektorspeicher ab. Garantiert nicht, dass die Auflistung vorhanden ist.
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)Parameter
- keys
- IEnumerable<TKey>
Die eindeutigen IDs, die dem abzurufenden Datensatz zugeordnet sind.
- options
- RecordRetrievalOptions
Optionale Optionen zum Abrufen der Datensätze.
- cancellationToken
- CancellationToken
Der CancellationToken zu überwachende Monitor für Abbruchanforderungen. Der Standardwert lautet None.
Gibt zurück
Die Datensätze, die den angegebenen eindeutigen Schlüsseln zugeordnet sind.
Ausnahmen
Der Befehl kann aus irgendeinem Grund nicht ausgeführt werden.
Hinweise
Die genaue Methode des Abrufs ist implementierungsspezifisch und kann je nach Datenbankunterstützung variieren. Die Standardimplementierung dieser Methode ruft die Datensätze nacheinander ab, aber Implementierungen, die Batchverarbeitung unterstützen, können außer Kraft setzen, um eine effizientere Implementierung bereitzustellen.
Es werden nur gefundene Datensätze zurückgegeben, sodass das Resultset möglicherweise kleiner als die angeforderten Schlüssel ist.
Diese Methode löst andere Probleme als Datensätze aus, die nicht gefunden werden.
Gilt für:
GetAsync(TKey, RecordRetrievalOptions, CancellationToken)
Ruft einen Datensatz aus dem Vektorspeicher ab. Garantiert nicht, dass die Auflistung vorhanden ist. Gibt NULL zurück, wenn der Datensatz nicht gefunden wird.
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)Parameter
- key
- TKey
Die eindeutige ID, die dem abzurufenden Datensatz zugeordnet ist.
- options
- RecordRetrievalOptions
Optionale Optionen zum Abrufen des Datensatzes.
- cancellationToken
- CancellationToken
Der CancellationToken zu überwachende Monitor für Abbruchanforderungen. Der Standardwert lautet None.
Gibt zurück
Der Datensatz, falls gefunden, andernfalls NULL.
Ausnahmen
Der Befehl kann aus irgendeinem Grund nicht ausgeführt werden.
Gilt für:
GetAsync(Expression<Func<TRecord,Boolean>>, Int32, FilteredRecordRetrievalOptions<TRecord>, CancellationToken)
Ruft übereinstimmende Datensätze aus dem Vektorspeicher ab. Garantiert nicht, dass die Auflistung vorhanden ist.
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)Parameter
- filter
- Expression<Func<TRecord,Boolean>>
Das Prädikat zum Filtern der Datensätze.
- top
- Int32
Die maximale Anzahl der zurückzugebenden Ergebnisse.
Optionen zum Abrufen der Datensätze.
- cancellationToken
- CancellationToken
Der CancellationToken zu überwachende Monitor für Abbruchanforderungen. Der Standardwert lautet None.
Gibt zurück
Die Datensätze, die dem angegebenen Prädikat entsprechen.
Ausnahmen
Der Befehl kann aus irgendeinem Grund nicht ausgeführt werden.
