Język

VectorStoreCollection<TKey,TRecord>.GetAsync Metoda

Definicja

Przeciążenia

Nazwa Opis
GetAsync(IEnumerable<TKey>, RecordRetrievalOptions, CancellationToken)

Pobiera partię rekordów z magazynu wektorów. Nie gwarantuje, że kolekcja istnieje.

GetAsync(TKey, RecordRetrievalOptions, CancellationToken)

Pobiera rekord z magazynu wektorów. Nie gwarantuje, że kolekcja istnieje. Zwraca wartość null, jeśli rekord nie zostanie znaleziony.

GetAsync(Expression<Func<TRecord,Boolean>>, Int32, FilteredRecordRetrievalOptions<TRecord>, CancellationToken)

Pobiera pasujące rekordy z magazynu wektorów. Nie gwarantuje, że kolekcja istnieje.

GetAsync(IEnumerable<TKey>, RecordRetrievalOptions, CancellationToken)

Źródło:
VectorStoreCollection.cs

Pobiera partię rekordów z magazynu wektorów. Nie gwarantuje, że kolekcja istnieje.

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)

Parametry

keys
IEnumerable<TKey>

Unikatowe identyfikatory skojarzone z rekordem do pobrania.

options
RecordRetrievalOptions

Opcjonalne opcje pobierania rekordów.

cancellationToken
CancellationToken

Element CancellationToken do monitorowania żądań anulowania. Wartość domyślna to None.

Zwraca

IAsyncEnumerable<TRecord>

Rekordy skojarzone z określonymi unikatowymi kluczami.

Wyjątki

Nie można wykonać polecenia z jakiegokolwiek powodu.

Uwagi

Dokładna metoda pobierania jest specyficzna dla implementacji i może się różnić w zależności od obsługi bazy danych. Domyślna implementacja tej metody pobiera rekordy jeden po drugim, ale implementacje obsługujące partie mogą przesłonić w celu zapewnienia bardziej wydajnej implementacji.

Zwracane są tylko znalezione rekordy, więc zestaw wyników może być mniejszy niż żądane klucze.

Ta metoda zgłasza wszelkie problemy inne niż nie znaleziono rekordów.

Dotyczy

GetAsync(TKey, RecordRetrievalOptions, CancellationToken)

Źródło:
VectorStoreCollection.cs

Pobiera rekord z magazynu wektorów. Nie gwarantuje, że kolekcja istnieje. Zwraca wartość null, jeśli rekord nie zostanie znaleziony.

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)

Parametry

key
TKey

Unikatowy identyfikator skojarzony z rekordem do pobrania.

options
RecordRetrievalOptions

Opcjonalne opcje pobierania rekordu.

cancellationToken
CancellationToken

Element CancellationToken do monitorowania żądań anulowania. Wartość domyślna to None.

Zwraca

Task<TRecord>

Jeśli rekord zostanie znaleziony, w przeciwnym razie ma wartość null.

Wyjątki

Nie można wykonać polecenia z jakiegokolwiek powodu.

Dotyczy

GetAsync(Expression<Func<TRecord,Boolean>>, Int32, FilteredRecordRetrievalOptions<TRecord>, CancellationToken)

Źródło:
VectorStoreCollection.cs

Pobiera pasujące rekordy z magazynu wektorów. Nie gwarantuje, że kolekcja istnieje.

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)

Parametry

filter
Expression<Func<TRecord,Boolean>>

Predykat do filtrowania rekordów.

top
Int32

Maksymalna liczba wyników do zwrócenia.

options
FilteredRecordRetrievalOptions<TRecord>

Opcje pobierania rekordów.

cancellationToken
CancellationToken

Element CancellationToken do monitorowania żądań anulowania. Wartość domyślna to None.

Zwraca

IAsyncEnumerable<TRecord>

Rekordy zgodne z danym predykatem.

Wyjątki

Nie można wykonać polecenia z jakiegokolwiek powodu.

Dotyczy