Database.ReadThroughputAsync Método

Definición

Espacio de nombres:

Microsoft.Azure.Cosmos

Ensamblado:

Microsoft.Azure.Cosmos.Client.dll

Paquete:

Microsoft.Azure.Cosmos v3.36.0

Sobrecargas

ReadThroughputAsync(CancellationToken)	Obtiene el rendimiento de la base de datos en la medida de unidades de solicitud por segundo en el servicio Azure Cosmos.
ReadThroughputAsync(RequestOptions, CancellationToken)	Obtiene el rendimiento de la base de datos en la medida de unidades de solicitud por segundo en el servicio Azure Cosmos.

ReadThroughputAsync(CancellationToken)

Obtiene el rendimiento de la base de datos en la medida de unidades de solicitud por segundo en el servicio Azure Cosmos.

public abstract System.Threading.Tasks.Task<int?> ReadThroughputAsync (System.Threading.CancellationToken cancellationToken = default);

abstract member ReadThroughputAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<Nullable<int>>

Public MustOverride Function ReadThroughputAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of Nullable(Of Integer))

Parámetros

cancellationToken

CancellationToken

(Opcional) CancellationToken que representa la cancelación de la solicitud.

Devoluciones

Task<Nullable<Int32>>

Rendimiento aprovisionado en unidades de solicitud por segundo

Ejemplos

En el ejemplo siguiente se muestra cómo obtener el rendimiento de la base de datos.

int? throughput = await database.ReadThroughputAsync();

Comentarios

El valor NULL indica una base de datos sin rendimiento aprovisionado.

ReadThroughputAsync(RequestOptions, CancellationToken)

Obtiene el rendimiento de la base de datos en la medida de unidades de solicitud por segundo en el servicio Azure Cosmos.

public abstract System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.ThroughputResponse> ReadThroughputAsync (Microsoft.Azure.Cosmos.RequestOptions requestOptions, System.Threading.CancellationToken cancellationToken = default);

abstract member ReadThroughputAsync : Microsoft.Azure.Cosmos.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.ThroughputResponse>

Public MustOverride Function ReadThroughputAsync (requestOptions As RequestOptions, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ThroughputResponse)

Parámetros

requestOptions

RequestOptions

Las opciones de la solicitud de rendimiento.

cancellationToken

CancellationToken

(Opcional) CancellationToken que representa la cancelación de la solicitud.

Devoluciones

Task<ThroughputResponse>

Respuesta de rendimiento.

Excepciones

CosmosException

Esta excepción puede encapsular muchos tipos diferentes de errores. Para determinar el error específico, examine siempre la propiedad StatusCode. Algunos códigos comunes que puede obtener al leer una clave de cifrado de cliente son:

StatusCode	Motivo de la excepción
404	NotFound: significa que la base de datos no existe o no tiene ningún rendimiento asignado.

Ejemplos

En el ejemplo siguiente se muestra cómo obtener el rendimiento.

 RequestOptions requestOptions = new RequestOptions();
ThroughputProperties throughputProperties = await database.ReadThroughputAsync(requestOptions);
Console.WriteLine($"Throughput: {throughputProperties?.Throughput}");

En el ejemplo siguiente se muestra cómo obtener el rendimiento, MinThroughput y se reemplaza en curso.

RequestOptions requestOptions = new RequestOptions();
ThroughputResponse response = await database.ReadThroughputAsync(requestOptions);
Console.WriteLine($"Throughput: {response.Resource?.Throughput}");
Console.WriteLine($"MinThroughput: {response.MinThroughput}");
Console.WriteLine($"IsReplacePending: {response.IsReplacePending}");

Comentarios

El valor NULL indica una base de datos sin rendimiento aprovisionado.