VectorStoreCollection<TKey,TRecord>.GetAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| Nom | Description |
|---|---|
| GetAsync(IEnumerable<TKey>, RecordRetrievalOptions, CancellationToken) |
Obtient un lot d’enregistrements à partir du magasin vectoriel. Ne garantit pas que la collection existe. |
| GetAsync(TKey, RecordRetrievalOptions, CancellationToken) |
Obtient un enregistrement à partir du magasin vectoriel. Ne garantit pas que la collection existe. Retourne null si l’enregistrement est introuvable. |
| GetAsync(Expression<Func<TRecord,Boolean>>, Int32, FilteredRecordRetrievalOptions<TRecord>, CancellationToken) |
Obtient les enregistrements correspondants à partir du magasin vectoriel. Ne garantit pas que la collection existe. |
GetAsync(IEnumerable<TKey>, RecordRetrievalOptions, CancellationToken)
Obtient un lot d’enregistrements à partir du magasin vectoriel. Ne garantit pas que la collection existe.
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)Paramètres
- keys
- IEnumerable<TKey>
ID uniques associés à l’enregistrement à obtenir.
- options
- RecordRetrievalOptions
Options facultatives pour récupérer les enregistrements.
- cancellationToken
- CancellationToken
À CancellationToken surveiller pour les demandes d’annulation. La valeur par défaut est None.
Retours
Enregistrements associés aux clés uniques spécifiées.
Exceptions
La commande ne parvient pas à s’exécuter pour une raison quelconque.
Remarques
La méthode exacte de récupération est spécifique à l’implémentation et peut varier en fonction de la prise en charge de la base de données. L’implémentation par défaut de cette méthode récupère les enregistrements un après l’autre, mais les implémentations prenant en charge le traitement par lots peuvent être remplacées pour fournir une implémentation plus efficace.
Seuls les enregistrements trouvés sont retournés. Le jeu de résultats peut donc être inférieur aux clés demandées.
Cette méthode lève pour tous les problèmes autres que les enregistrements introuvables.
S’applique à
GetAsync(TKey, RecordRetrievalOptions, CancellationToken)
Obtient un enregistrement à partir du magasin vectoriel. Ne garantit pas que la collection existe. Retourne null si l’enregistrement est introuvable.
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)Paramètres
- key
- TKey
ID unique associé à l’enregistrement à obtenir.
- options
- RecordRetrievalOptions
Options facultatives pour récupérer l’enregistrement.
- cancellationToken
- CancellationToken
À CancellationToken surveiller pour les demandes d’annulation. La valeur par défaut est None.
Retours
Enregistrement s’il est trouvé, sinon null.
Exceptions
La commande ne parvient pas à s’exécuter pour une raison quelconque.
S’applique à
GetAsync(Expression<Func<TRecord,Boolean>>, Int32, FilteredRecordRetrievalOptions<TRecord>, CancellationToken)
Obtient les enregistrements correspondants à partir du magasin vectoriel. Ne garantit pas que la collection existe.
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)Paramètres
- filter
- Expression<Func<TRecord,Boolean>>
Prédicat pour filtrer les enregistrements.
- top
- Int32
Nombre maximal de résultats à retourner.
Options de récupération des enregistrements.
- cancellationToken
- CancellationToken
À CancellationToken surveiller pour les demandes d’annulation. La valeur par défaut est None.
Retours
Enregistrements qui correspondent au prédicat donné.
Exceptions
La commande ne parvient pas à s’exécuter pour une raison quelconque.
