VectorStoreCollection<TKey,TRecord>.GetAsync Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar matchande poster från vektorlagret. Garanterar inte att samlingen finns.
Överlagringar
| Name | Description |
|---|---|
| GetAsync(IEnumerable<TKey>, RecordRetrievalOptions, CancellationToken) |
Hämtar en batch med poster från vektorarkivet. Garanterar inte att samlingen finns. |
| GetAsync(TKey, RecordRetrievalOptions, CancellationToken) |
Hämtar en post från vektorarkivet. Garanterar inte att samlingen finns. Returnerar null om posten inte hittas. |
| GetAsync(Expression<Func<TRecord,Boolean>>, Int32, FilteredRecordRetrievalOptions<TRecord>, CancellationToken) |
Hämtar matchande poster från vektorlagret. Garanterar inte att samlingen finns. |
GetAsync(IEnumerable<TKey>, RecordRetrievalOptions, CancellationToken)
- Källa:
- VectorStoreCollection.cs
Hämtar en batch med poster från vektorarkivet. Garanterar inte att samlingen finns.
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)
Parametrar
- keys
- IEnumerable<TKey>
De unika ID:t som är associerade med posten som ska hämtas.
- options
- RecordRetrievalOptions
Valfria alternativ för att hämta posterna.
- cancellationToken
- CancellationToken
Övervaka CancellationToken för annulleringsbegäranden. Standardvärdet är None.
Returer
De poster som är associerade med de angivna unika nycklarna.
Undantag
Kommandot kan inte köras av någon anledning.
Kommentarer
Den exakta metoden för hämtning är implementeringsspecifik och kan variera beroende på databasstöd. Standardimplementeringen av den här metoden hämtar posterna en efter en, men implementeringar som stöder batchbearbetning kan åsidosätta för att ge en effektivare implementering.
Endast hittade poster returneras, så resultatuppsättningen kan vara mindre än de begärda nycklarna.
Den här metoden genererar andra problem än poster som inte hittas.
Gäller för
GetAsync(TKey, RecordRetrievalOptions, CancellationToken)
- Källa:
- VectorStoreCollection.cs
Hämtar en post från vektorarkivet. Garanterar inte att samlingen finns. Returnerar null om posten inte hittas.
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)
Parametrar
- key
- TKey
Det unika ID som är associerat med posten som ska hämtas.
- options
- RecordRetrievalOptions
Valfria alternativ för att hämta posten.
- cancellationToken
- CancellationToken
Övervaka CancellationToken för annulleringsbegäranden. Standardvärdet är None.
Returer
Posten om den hittas, annars null.
Undantag
Kommandot kan inte köras av någon anledning.
Gäller för
GetAsync(Expression<Func<TRecord,Boolean>>, Int32, FilteredRecordRetrievalOptions<TRecord>, CancellationToken)
- Källa:
- VectorStoreCollection.cs
Hämtar matchande poster från vektorlagret. Garanterar inte att samlingen finns.
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)
Parametrar
- filter
- Expression<Func<TRecord,Boolean>>
Predikatet för att filtrera posterna.
- top
- Int32
Det maximala antalet resultat som ska returneras.
Alternativ för att hämta posterna.
- cancellationToken
- CancellationToken
Övervaka CancellationToken för annulleringsbegäranden. Standardvärdet är None.
Returer
De poster som matchar det angivna predikatet.
Undantag
Kommandot kan inte köras av någon anledning.