Database.ReadThroughputAsync Méthode

Définition

Espace de noms:

Microsoft.Azure.Cosmos

Assembly:

Microsoft.Azure.Cosmos.Client.dll

Paquet:

Microsoft.Azure.Cosmos v3.36.0

Surcharges

ReadThroughputAsync(CancellationToken)	Obtient le débit de la base de données dans la mesure des unités de requête par seconde dans le service Azure Cosmos.
ReadThroughputAsync(RequestOptions, CancellationToken)	Obtient le débit de la base de données dans la mesure des unités de requête par seconde dans le service Azure Cosmos.

ReadThroughputAsync(CancellationToken)

Obtient le débit de la base de données dans la mesure des unités de requête par seconde dans le service 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))

Paramètres

cancellationToken

CancellationToken

(Facultatif) CancellationToken représentant l’annulation de la demande.

Retours

Task<Nullable<Int32>>

Débit provisionné en unités de requête par seconde

Exemples

L’exemple suivant montre comment obtenir le débit de la base de données.

int? throughput = await database.ReadThroughputAsync();

Remarques

La valeur Null indique une base de données sans débit provisionné.

ReadThroughputAsync(RequestOptions, CancellationToken)

Obtient le débit de la base de données dans la mesure des unités de requête par seconde dans le service 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)

Paramètres

requestOptions

RequestOptions

Options pour la demande de débit.

cancellationToken

CancellationToken

(Facultatif) CancellationToken représentant l’annulation de la demande.

Retours

Task<ThroughputResponse>

Réponse de débit.

Exceptions

CosmosException

Cette exception peut encapsuler de nombreux types d’erreurs différents. Pour déterminer l’erreur spécifique, examinez toujours la propriété StatusCode. Voici quelques codes courants que vous pouvez obtenir lors de la lecture d’une clé de chiffrement client :

StatusCode	Raison de l’exception
404	NotFound : cela signifie que la base de données n’existe pas ou qu’aucun débit n’est affecté.

Exemples

L’exemple suivant montre comment obtenir le débit

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

L’exemple suivant montre comment obtenir le débit, MinThroughput et est remplacé en cours

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}");

Remarques

La valeur Null indique une base de données sans débit provisionné.