VectorStoreCollection<TKey,TRecord>.GetAsync Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
| Nome | Descrizione |
|---|---|
| GetAsync(IEnumerable<TKey>, RecordRetrievalOptions, CancellationToken) |
Ottiene un batch di record dall'archivio vettoriale. Non garantisce che la raccolta esista. |
| GetAsync(TKey, RecordRetrievalOptions, CancellationToken) |
Ottiene un record dall'archivio vettoriale. Non garantisce che la raccolta esista. Restituisce Null se il record non viene trovato. |
| GetAsync(Expression<Func<TRecord,Boolean>>, Int32, FilteredRecordRetrievalOptions<TRecord>, CancellationToken) |
Ottiene i record corrispondenti dall'archivio vettoriale. Non garantisce che la raccolta esista. |
GetAsync(IEnumerable<TKey>, RecordRetrievalOptions, CancellationToken)
Ottiene un batch di record dall'archivio vettoriale. Non garantisce che la raccolta esista.
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)Parametri
- keys
- IEnumerable<TKey>
ID univoci associati al record da ottenere.
- options
- RecordRetrievalOptions
Opzioni facoltative per il recupero dei record.
- cancellationToken
- CancellationToken
Oggetto CancellationToken da monitorare per le richieste di annullamento. Il valore predefinito è None.
Valori restituiti
Record associati alle chiavi univoche specificate.
Eccezioni
Il comando non viene eseguito per qualsiasi motivo.
Commenti
Il metodo esatto di recupero è specifico dell'implementazione e può variare in base al supporto del database. L'implementazione predefinita di questo metodo recupera i record uno dopo l'altro, ma le implementazioni che supportano l'invio in batch possono eseguire l'override per fornire un'implementazione più efficiente.
Vengono restituiti solo i record trovati, pertanto il set di risultati potrebbe essere inferiore alle chiavi richieste.
Questo metodo genera un'eccezione per eventuali problemi diversi dai record non trovati.
Si applica a
GetAsync(TKey, RecordRetrievalOptions, CancellationToken)
Ottiene un record dall'archivio vettoriale. Non garantisce che la raccolta esista. Restituisce Null se il record non viene trovato.
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)Parametri
- key
- TKey
ID univoco associato al record da ottenere.
- options
- RecordRetrievalOptions
Opzioni facoltative per il recupero del record.
- cancellationToken
- CancellationToken
Oggetto CancellationToken da monitorare per le richieste di annullamento. Il valore predefinito è None.
Valori restituiti
Record se trovato; in caso contrario, null.
Eccezioni
Il comando non viene eseguito per qualsiasi motivo.
Si applica a
GetAsync(Expression<Func<TRecord,Boolean>>, Int32, FilteredRecordRetrievalOptions<TRecord>, CancellationToken)
Ottiene i record corrispondenti dall'archivio vettoriale. Non garantisce che la raccolta esista.
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)Parametri
- filter
- Expression<Func<TRecord,Boolean>>
Predicato per filtrare i record.
- top
- Int32
Numero massimo di risultati da restituire.
Opzioni per il recupero dei record.
- cancellationToken
- CancellationToken
Oggetto CancellationToken da monitorare per le richieste di annullamento. Il valore predefinito è None.
Valori restituiti
Record che corrispondono al predicato specificato.
Eccezioni
Il comando non viene eseguito per qualsiasi motivo.
