你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

CosmosClient.CreateDatabaseIfNotExistsAsync 方法

定义

命名空间:

Microsoft.Azure.Cosmos

程序集:

Microsoft.Azure.Cosmos.Client.dll

包:

Microsoft.Azure.Cosmos v3.36.0

重载

CreateDatabaseIfNotExistsAsync(String, Nullable<Int32>, RequestOptions, CancellationToken)	检查数据库是否存在，如果不存在，请创建它。 仅使用数据库 ID 来验证是否存在现有数据库。 其他数据库属性（如吞吐量）未验证，可能不同于传递的属性。 数据库管理用户、权限和一组容器。 每个 Azure Cosmos DB 数据库帐户都能够支持多个独立的命名数据库，数据库是数据的逻辑容器。 每个数据库由一个或多个容器组成，每个容器又包含一个或多个文档。 由于数据库是一种管理资源，因此需要使用服务主密钥才能使用用户 API 访问并成功完成任何操作。
CreateDatabaseIfNotExistsAsync(String, ThroughputProperties, RequestOptions, CancellationToken)	检查数据库是否存在，如果不存在，请创建它。 仅使用数据库 ID 来验证是否存在现有数据库。 其他数据库属性（如吞吐量）未验证，可能不同于传递的属性。 数据库管理用户、权限和一组容器。 每个 Azure Cosmos DB 数据库帐户都能够支持多个独立的命名数据库，数据库是数据的逻辑容器。 每个数据库由一个或多个容器组成，每个容器又包含一个或多个文档。 由于数据库是一种管理资源，因此需要使用服务主密钥才能使用用户 API 访问并成功完成任何操作。

CreateDatabaseIfNotExistsAsync(String, Nullable<Int32>, RequestOptions, CancellationToken)

检查数据库是否存在，如果不存在，请创建它。 仅使用数据库 ID 来验证是否存在现有数据库。 其他数据库属性（如吞吐量）未验证，可能不同于传递的属性。

数据库管理用户、权限和一组容器。 每个 Azure Cosmos DB 数据库帐户都能够支持多个独立的命名数据库，数据库是数据的逻辑容器。

每个数据库由一个或多个容器组成，每个容器又包含一个或多个文档。 由于数据库是一种管理资源，因此需要使用服务主密钥才能使用用户 API 访问并成功完成任何操作。

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

abstract member CreateDatabaseIfNotExistsAsync : string * Nullable<int> * Microsoft.Azure.Cosmos.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.DatabaseResponse>
override this.CreateDatabaseIfNotExistsAsync : string * Nullable<int> * Microsoft.Azure.Cosmos.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.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 服务中的每秒请求单位数。

requestOptions

RequestOptions

(可选) 一组可以设置的其他选项。

cancellationToken

CancellationToken

(表示请求取消的可选) CancellationToken 。

返回

Task<DatabaseResponse>

一 Task 个 DatabaseResponse ，它包含包装 DatabaseProperties 包含资源记录的 。

StatusCode	CreateDatabaseIfNotExistsAsync 操作的常见成功状态代码
201	已创建 - 创建新数据库。
200	正常 - 这意味着数据库已存在。

注解

https://docs.microsoft.com/azure/cosmos-db/request-units 有关预配吞吐量的详细信息。

CreateDatabaseIfNotExistsAsync(String, ThroughputProperties, RequestOptions, CancellationToken)

检查数据库是否存在，如果不存在，请创建它。 仅使用数据库 ID 来验证是否存在现有数据库。 其他数据库属性（如吞吐量）未验证，可能不同于传递的属性。

数据库管理用户、权限和一组容器。 每个 Azure Cosmos DB 数据库帐户都能够支持多个独立的命名数据库，数据库是数据的逻辑容器。

每个数据库由一个或多个容器组成，每个容器又包含一个或多个文档。 由于数据库是一种管理资源，因此需要使用服务主密钥才能使用用户 API 访问并成功完成任何操作。

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

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

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

参数

id

String

数据库 ID。

throughputProperties

ThroughputProperties

为数据库预配的吞吐量，以度量 Azure Cosmos DB 服务中的每秒请求单位数。

requestOptions

RequestOptions

(可选) 一组可以设置的其他选项。

cancellationToken

CancellationToken

(表示请求取消的可选) CancellationToken 。

返回

Task<DatabaseResponse>

一 Task 个 DatabaseResponse ，它包含包装 DatabaseProperties 包含资源记录的 。

StatusCode	CreateDatabaseIfNotExistsAsync 操作的常见成功状态代码
201	已创建 - 创建新数据库。
200	正常 - 这意味着数据库已存在。