Database.ReadThroughputAsync メソッド

定義

オーバーロード

ReadThroughputAsync(CancellationToken)

Azure Cosmos サービスの 1 秒あたりの要求ユニット数の測定におけるデータベース スループットを取得します。

ReadThroughputAsync(RequestOptions, CancellationToken)

Azure Cosmos サービスの 1 秒あたりの要求ユニット数の測定におけるデータベース スループットを取得します。

ReadThroughputAsync(CancellationToken)

Azure Cosmos サービスの 1 秒あたりの要求ユニット数の測定におけるデータベース スループットを取得します。

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

パラメーター

cancellationToken
CancellationToken

(省略可能) CancellationToken 要求の取り消しを表します。

戻り値

プロビジョニングされたスループット (1 秒あたりの要求ユニット数)

次の例は、データベースのスループットを取得する方法を示しています。

int? throughput = await database.ReadThroughputAsync();

注釈

Null 値は、スループットがプロビジョニングされていないデータベースを示します。

適用対象

ReadThroughputAsync(RequestOptions, CancellationToken)

Azure Cosmos サービスの 1 秒あたりの要求ユニット数の測定におけるデータベース スループットを取得します。

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)

パラメーター

requestOptions
RequestOptions

スループット要求のオプション。

cancellationToken
CancellationToken

(省略可能) CancellationToken 要求の取り消しを表します。

戻り値

スループット応答。

例外

この例外により、さまざまな種類のエラーがカプセル化される可能性があります。 特定のエラーを確認するには、常に StatusCode プロパティを参照してください。 クライアント暗号化キーを読み取るときに取得できる一般的なコードは次のとおりです。

StatusCode例外の理由
404 NotFound - これは、データベースが存在しないか、スループットが割り当てられていない場合を意味します。

次の例は、スループットを取得する方法を示しています

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

次の例は、スループットを取得する方法を示しています。MinThroughput と が進行中で置き換えられます

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

注釈

Null 値は、スループットがプロビジョニングされていないデータベースを示します。

適用対象