Database.ReadThroughputAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
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 値は、スループットがプロビジョニングされていないデータベースを示します。
適用対象
Azure SDK for .NET