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

CosmosDatabase 类

定义

命名空间:

Azure.Cosmos

程序集:

Azure.Cosmos.dll

包:

Azure.Cosmos v4.0.0-preview3

读取或删除现有数据库的操作。

CosmosClient 用于或创建新数据库，以及读取/查询所有数据库;使用 client.Databases。

public abstract class CosmosDatabase

type CosmosDatabase = class

Public MustInherit Class CosmosDatabase

继承

Object

CosmosDatabase

注解

注意：所有这些操作都会根据固定预算进行调用。 应设计系统，使这些调用与应用程序一起以子线性方式缩放。 例如，不要调用“database”。ReadAsync () '之前，每个 '项。ReadAsync () ' 调用，以确保数据库存在;在应用程序启动时执行此操作一次。

构造函数

CosmosDatabase()

读取或删除现有数据库的操作。 CosmosClient 用于或创建新数据库，以及读取/查询所有数据库;使用 client.Databases。

属性

Id	Cosmos 数据库的 ID

方法

CreateContainerAsync(ContainerProperties, Nullable<Int32>, RequestOptions, CancellationToken)	在 Azure Cosmos 服务中将容器创建为异步操作。
CreateContainerAsync(String, String, Nullable<Int32>, RequestOptions, CancellationToken)	在 Azure Cosmos 服务中将容器创建为异步操作。
CreateContainerIfNotExistsAsync(ContainerProperties, Nullable<Int32>, RequestOptions, CancellationToken)	检查容器是否存在，如果不存在，请创建它。 仅使用容器 ID 来验证是否存在现有容器。 其他容器属性（如吞吐量）未验证，可以与传递的属性不同。
CreateContainerIfNotExistsAsync(String, String, Nullable<Int32>, RequestOptions, CancellationToken)	检查容器是否存在，如果不存在，请创建它。 这将进行读取操作，如果未找到容器，它将执行创建操作。
CreateContainerStreamAsync(ContainerProperties, Nullable<Int32>, RequestOptions, CancellationToken)	在 Azure Cosmos 服务中将容器创建为异步操作。
CreateUserAsync(String, RequestOptions, CancellationToken)	在 Azure Cosmos 服务中将用户创建为异步操作。
DefineContainer(String, String)	创建 containerBuilder。
DeleteAsync(RequestOptions, CancellationToken)	DatabaseProperties以异步操作的形式从 Azure Cosmos DB 服务中删除 。
DeleteStreamAsync(RequestOptions, CancellationToken)	DatabaseProperties以异步操作的形式从 Azure Cosmos DB 服务中删除 。
GetContainer(String)	返回对容器对象的引用。
GetContainerQueryIterator<T>(QueryDefinition, String, QueryRequestOptions, CancellationToken)	此方法使用 SQL 语句为数据库下的容器创建查询。 它返回 FeedIterator。 有关使用参数化值准备 SQL 语句的详细信息，请参阅 QueryDefinition 重载。
GetContainerQueryIterator<T>(String, String, QueryRequestOptions, CancellationToken)	此方法使用 SQL 语句为数据库下的容器创建查询。 它返回 FeedIterator。 有关使用参数化值准备 SQL 语句的详细信息，请参阅 QueryDefinition 重载。
GetContainerQueryStreamIterator(QueryDefinition, String, QueryRequestOptions, CancellationToken)	此方法使用 SQL 语句为数据库下的容器创建查询。 它返回 FeedIterator。 有关使用参数化值准备 SQL 语句的详细信息，请参阅 QueryDefinition 重载。
GetContainerQueryStreamIterator(String, String, QueryRequestOptions, CancellationToken)	此方法使用 SQL 语句为数据库下的容器创建查询。 它返回 FeedIterator。 有关使用参数化值准备 SQL 语句的详细信息，请参阅 QueryDefinition 重载。
GetUser(String)	返回对用户对象的引用。
GetUserQueryIterator<T>(QueryDefinition, String, QueryRequestOptions, CancellationToken)	此方法使用 SQL 语句为数据库下的用户创建查询。 它返回 FeedIterator。 有关使用参数化值准备 SQL 语句的详细信息，请参阅 QueryDefinition 重载。
GetUserQueryIterator<T>(String, String, QueryRequestOptions, CancellationToken)	此方法使用 SQL 语句为数据库下的用户创建查询。 它返回 FeedIterator。 有关使用参数化值准备 SQL 语句的详细信息，请参阅 QueryDefinition 重载。
ReadAsync(RequestOptions, CancellationToken)	DatabaseProperties以异步操作的形式从 Azure Cosmos 服务读取 。
ReadStreamAsync(RequestOptions, CancellationToken)	DatabaseProperties以异步操作的形式从 Azure Cosmos 服务读取 。
ReadThroughputAsync(CancellationToken)	获取数据库吞吐量，以度量 Azure Cosmos 服务中的每秒请求单位数。
ReadThroughputAsync(RequestOptions, CancellationToken)	获取数据库吞吐量，以度量 Azure Cosmos 服务中的每秒请求单位数。
ReplaceThroughputAsync(Int32, RequestOptions, CancellationToken)	设置为数据库预配的吞吐量，以度量 Azure Cosmos 服务中的每秒请求单位数。
UpsertUserAsync(String, RequestOptions, CancellationToken)	将用户更新为 Azure Cosmos 服务中的异步操作。