CosmosClient.CreateDatabaseIfNotExistsAsync メソッド

定義

名前空間:

Azure.Cosmos

アセンブリ:

Azure.Cosmos.dll

パッケージ:

Azure.Cosmos v4.0.0-preview3

データベースが存在するかどうかを確認し、存在しない場合は作成します。 データベース ID のみが、既存のデータベースがあるかどうかを確認するために使用されます。 スループットなどの他のデータベース プロパティは検証されず、渡されたプロパティとは異なる場合があります。

データベースは、ユーザー、アクセス許可、コンテナーのセットを管理します。 各 Azure Cosmos DB データベース アカウントは、複数の独立した名前付きデータベースをサポートでき、データベースはデータの論理コンテナーです。

各データベースは 1 つ以上のコンテナーで構成され、それぞれが 1 つ以上のドキュメントを含みます。 データベースは管理リソースであるため、ユーザー API を使用してすべてのアクションにアクセスして正常に完了するには、サービス マスター キーが必要です。

public virtual System.Threading.Tasks.Task<Azure.Cosmos.DatabaseResponse> CreateDatabaseIfNotExistsAsync (string id, int? throughput = default, Azure.Cosmos.RequestOptions requestOptions = default, System.Threading.CancellationToken cancellationToken = default);

abstract member CreateDatabaseIfNotExistsAsync : string * Nullable<int> * Azure.Cosmos.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Cosmos.DatabaseResponse>
override this.CreateDatabaseIfNotExistsAsync : string * Nullable<int> * Azure.Cosmos.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Cosmos.DatabaseResponse>

Public Overridable Function CreateDatabaseIfNotExistsAsync (id As String, Optional throughput As Nullable(Of Integer) = Nothing, Optional requestOptions As RequestOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of DatabaseResponse)

パラメーター

id

String

データベース ID。

throughput

Nullable<Int32>

(省略可能)Azure Cosmos DB サービスの 1 秒あたりの要求ユニット数の測定でデータベースにプロビジョニングされるスループット。

requestOptions

RequestOptions

(省略可能)設定できる追加オプションのセット。

cancellationToken

CancellationToken

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

戻り値

Task<DatabaseResponse>

Taskリソース レコードをResponse含む をDatabasePropertiesラップする を含む 。

注釈

https://docs.microsoft.com/azure/cosmos-db/request-units プロビジョニングスループットの詳細については、次を参照してください。