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

Database 类

定义

命名空间:

Microsoft.Azure.Cosmos

程序集:

Microsoft.Azure.Cosmos.Client.dll

包:

Microsoft.Azure.Cosmos v3.39.0

Source:

Database.cs

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

有关创建新数据库和读取/查询所有数据库，请参阅 Client ;使用 client.Databases。

public abstract class Database

type Database = class

Public MustInherit Class Database

继承

Object

Database

注解

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

构造函数

Database()

用于读取或删除现有数据库的操作。 有关创建新数据库和读取/查询所有数据库，请参阅 Client ;使用 client.Databases。

属性

Client	与数据库实例相关的父 Cosmos 客户端实例
Id	Cosmos 数据库的 ID

方法

CreateClientEncryptionKeyAsync(ClientEncryptionKeyProperties, RequestOptions, CancellationToken)	将客户端加密密钥保存为 Azure Cosmos 服务中的异步操作。 此方法不应直接调用。 若要使用客户端加密，请参阅 https://aka.ms/CosmosClientEncryption 。
CreateContainerAsync(ContainerProperties, Nullable<Int32>, RequestOptions, CancellationToken)	在 Azure Cosmos 服务中将容器创建为异步操作。
CreateContainerAsync(ContainerProperties, ThroughputProperties, RequestOptions, CancellationToken)	在 Azure Cosmos 服务中将容器创建为异步操作。
CreateContainerAsync(String, String, Nullable<Int32>, RequestOptions, CancellationToken)	在 Azure Cosmos 服务中将容器创建为异步操作。
CreateContainerIfNotExistsAsync(ContainerProperties, Nullable<Int32>, RequestOptions, CancellationToken)	检查容器是否存在，如果不存在，请创建它。 仅使用容器 ID 来验证是否存在现有容器。 其他容器属性（如吞吐量）不会验证，可以与传递的属性不同。
CreateContainerIfNotExistsAsync(ContainerProperties, ThroughputProperties, RequestOptions, CancellationToken)	检查容器是否存在，如果不存在，请创建它。 仅使用容器 ID 来验证是否存在现有容器。 其他容器属性（如吞吐量）不会验证，可以与传递的属性不同。
CreateContainerIfNotExistsAsync(String, String, Nullable<Int32>, RequestOptions, CancellationToken)	检查容器是否存在，如果不存在，请创建它。 这将执行读取操作，如果未找到容器，它将执行创建操作。
CreateContainerStreamAsync(ContainerProperties, Nullable<Int32>, RequestOptions, CancellationToken)	在 Azure Cosmos 服务中将容器创建为异步操作。
CreateContainerStreamAsync(ContainerProperties, ThroughputProperties, RequestOptions, CancellationToken)	在 Azure Cosmos 服务中将容器创建为异步操作。
CreateUserAsync(String, RequestOptions, CancellationToken)	在 Azure Cosmos 服务中将用户创建为异步操作。
DefineContainer(String, String)	创建 containerBuilder。
DeleteAsync(RequestOptions, CancellationToken)	以异步操作的形式从 Azure Cosmos DB 服务中删除数据库。
DeleteStreamAsync(RequestOptions, CancellationToken)	DatabaseProperties从 Azure Cosmos DB 服务中删除 作为异步操作。
GetClientEncryptionKey(String)	返回对客户端加密密钥对象的引用。 此方法不应直接调用。 若要使用客户端加密，请参阅 https://aka.ms/CosmosClientEncryption 。
GetClientEncryptionKeyQueryIterator(QueryDefinition, String, QueryRequestOptions)	返回一个迭代器，该迭代器可循环访问以获取客户端加密密钥的属性。 此方法不应直接调用。 若要使用客户端加密，请参阅 https://aka.ms/CosmosClientEncryption 。
GetContainer(String)	返回对容器对象的引用。
GetContainerQueryIterator<T>(QueryDefinition, String, QueryRequestOptions)	此方法使用具有参数化值的 SQL 语句为数据库下的容器创建查询。 它返回 FeedIterator。 有关使用参数化值准备 SQL 语句的详细信息，请参阅 QueryDefinition 重载。
GetContainerQueryIterator<T>(String, String, QueryRequestOptions)	此方法使用 SQL 语句为数据库下的容器创建查询。 它返回 FeedIterator。
GetContainerQueryStreamIterator(QueryDefinition, String, QueryRequestOptions)	此方法使用具有参数化值的 SQL 语句为数据库下的容器创建查询。 它返回 FeedIterator。 有关使用参数化值准备 SQL 语句的详细信息，请参阅 QueryDefinition 重载。
GetContainerQueryStreamIterator(String, String, QueryRequestOptions)	此方法使用 SQL 语句为数据库下的容器创建查询。 它返回 FeedIterator。
GetUser(String)	返回对用户对象的引用。
GetUserQueryIterator<T>(QueryDefinition, String, QueryRequestOptions)	此方法使用具有参数化值的 SQL 语句为数据库下的用户创建查询。 它返回 FeedIterator。 有关使用参数化值准备 SQL 语句的详细信息，请参阅 QueryDefinition 重载。
GetUserQueryIterator<T>(String, String, QueryRequestOptions)	此方法使用 SQL 语句为数据库下的用户创建查询。 它返回 FeedIterator。
ReadAsync(RequestOptions, CancellationToken)	DatabaseResponse以异步操作的形式从 Azure Cosmos 服务读取 。
ReadStreamAsync(RequestOptions, CancellationToken)	DatabaseProperties以异步操作的形式从 Azure Cosmos 服务读取 。
ReadThroughputAsync(CancellationToken)	获取数据库吞吐量，以度量 Azure Cosmos 服务中的每秒请求单位数。
ReadThroughputAsync(RequestOptions, CancellationToken)	获取数据库吞吐量，以度量 Azure Cosmos 服务中的每秒请求单位数。
ReplaceThroughputAsync(Int32, RequestOptions, CancellationToken)	设置为数据库预配的吞吐量，以测量 Azure Cosmos 服务中的每秒请求单位数。
ReplaceThroughputAsync(ThroughputProperties, RequestOptions, CancellationToken)	设置为数据库预配的吞吐量，以测量 Azure Cosmos 服务中的每秒请求单位数。
UpsertUserAsync(String, RequestOptions, CancellationToken)	将用户更新为 Azure Cosmos 服务中的异步操作。