Database.ReadThroughputAsync Methode

Definition

Namespace:

Microsoft.Azure.Cosmos

Assembly:

Microsoft.Azure.Cosmos.Client.dll

Paket:

Microsoft.Azure.Cosmos v3.36.0

Überlädt

ReadThroughputAsync(CancellationToken)	Ruft den Datenbankdurchsatz bei der Messung der Anforderungseinheiten pro Sekunde im Azure Cosmos-Dienst ab.
ReadThroughputAsync(RequestOptions, CancellationToken)	Ruft den Datenbankdurchsatz bei der Messung der Anforderungseinheiten pro Sekunde im Azure Cosmos-Dienst ab.

ReadThroughputAsync(CancellationToken)

Ruft den Datenbankdurchsatz bei der Messung der Anforderungseinheiten pro Sekunde im Azure Cosmos-Dienst ab.

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))

Parameter

cancellationToken

CancellationToken

(Optional) CancellationToken stellt den Anforderungsabbruch dar.

Gibt zurück

Task<Nullable<Int32>>

Bereitgestellter Durchsatz in Anforderungseinheiten pro Sekunde

Beispiele

Im folgenden Beispiel wird gezeigt, wie Der Datenbankdurchsatz abgerufen wird.

int? throughput = await database.ReadThroughputAsync();

Hinweise

Null-Wert gibt eine Datenbank ohne bereitgestellten Durchsatz an.

ReadThroughputAsync(RequestOptions, CancellationToken)

Ruft den Datenbankdurchsatz bei der Messung der Anforderungseinheiten pro Sekunde im Azure Cosmos-Dienst ab.

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)

Parameter

requestOptions

RequestOptions

Die Optionen für die Durchsatzanforderung.

cancellationToken

CancellationToken

(Optional) CancellationToken stellt den Anforderungsabbruch dar.

Gibt zurück

Task<ThroughputResponse>

Die Durchsatzantwort.

Ausnahmen

CosmosException

Diese Ausnahme kann viele verschiedene Fehlertypen kapseln. Um den spezifischen Fehler zu ermitteln, sehen Sie sich immer die StatusCode-Eigenschaft an. Einige häufige Codes, die Sie beim Lesen eines Clientverschlüsselungsschlüssels erhalten können, sind:

StatusCode	Grund für die Ausnahme
404	NotFound: Dies bedeutet, dass die Datenbank nicht vorhanden ist oder über keinen zugewiesenen Durchsatz verfügt.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie den Durchsatz abrufen.

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

Im folgenden Beispiel wird gezeigt, wie Sie den Durchsatz, MinThroughput und den Ersetzungsvorgang in Bearbeitung erhalten.

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

Hinweise

Null-Wert gibt eine Datenbank ohne bereitgestellten Durchsatz an.