VectorStoreCollection<TKey,TRecord>.GetAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene registros coincidentes del almacén de vectores. No garantiza que la colección exista.
Sobrecargas
| Nombre | Description |
|---|---|
| GetAsync(IEnumerable<TKey>, RecordRetrievalOptions, CancellationToken) |
Obtiene un lote de registros del almacén de vectores. No garantiza que la colección exista. |
| GetAsync(TKey, RecordRetrievalOptions, CancellationToken) |
Obtiene un registro del almacén de vectores. No garantiza que la colección exista. Devuelve null si no se encuentra el registro. |
| GetAsync(Expression<Func<TRecord,Boolean>>, Int32, FilteredRecordRetrievalOptions<TRecord>, CancellationToken) |
Obtiene registros coincidentes del almacén de vectores. No garantiza que la colección exista. |
GetAsync(IEnumerable<TKey>, RecordRetrievalOptions, CancellationToken)
- Source:
- VectorStoreCollection.cs
Obtiene un lote de registros del almacén de vectores. No garantiza que la colección exista.
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)Parámetros
- keys
- IEnumerable<TKey>
Identificadores únicos asociados al registro que se va a obtener.
- options
- RecordRetrievalOptions
Opciones opcionales para recuperar los registros.
- cancellationToken
- CancellationToken
que CancellationToken se va a supervisar para las solicitudes de cancelación. El valor predeterminado es None.
Devoluciones
Registros asociados a las claves únicas especificadas.
Excepciones
El comando no se puede ejecutar por cualquier motivo.
Comentarios
El método exacto de recuperación es específico de la implementación y puede variar en función de la compatibilidad con la base de datos. La implementación predeterminada de este método recupera los registros uno después del otro, pero las implementaciones que admiten el procesamiento por lotes pueden invalidar para proporcionar una implementación más eficaz.
Solo se devuelven registros encontrados, por lo que el conjunto de resultados puede ser menor que las claves solicitadas.
Este método produce problemas distintos de los registros que no se encuentran.
Se aplica a
GetAsync(TKey, RecordRetrievalOptions, CancellationToken)
- Source:
- VectorStoreCollection.cs
Obtiene un registro del almacén de vectores. No garantiza que la colección exista. Devuelve null si no se encuentra el registro.
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)Parámetros
- key
- TKey
Identificador único asociado al registro que se va a obtener.
- options
- RecordRetrievalOptions
Opciones opcionales para recuperar el registro.
- cancellationToken
- CancellationToken
que CancellationToken se va a supervisar para las solicitudes de cancelación. El valor predeterminado es None.
Devoluciones
Registro si se encuentra; en caso contrario, null.
Excepciones
El comando no se puede ejecutar por cualquier motivo.
Se aplica a
GetAsync(Expression<Func<TRecord,Boolean>>, Int32, FilteredRecordRetrievalOptions<TRecord>, CancellationToken)
- Source:
- VectorStoreCollection.cs
Obtiene registros coincidentes del almacén de vectores. No garantiza que la colección exista.
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)Parámetros
- filter
- Expression<Func<TRecord,Boolean>>
Predicado para filtrar los registros.
- top
- Int32
El número máximo de resultados que se pueden devolver.
Opciones para recuperar los registros.
- cancellationToken
- CancellationToken
que CancellationToken se va a supervisar para las solicitudes de cancelación. El valor predeterminado es None.
Devoluciones
Registros que coinciden con el predicado especificado.
Excepciones
El comando no se puede ejecutar por cualquier motivo.
