@azure/cosmos package

异步操作已中止时，将引发此错误。 通过测试错误的名称属性是否与 name匹配来检查此错误 "AbortError"。

示例

const controller = new AbortController();
controller.abort();
try {
  doAsyncWork(controller.signal)
} catch (e) {
  if (e.name === 'AbortError') {
    // handle abort error here.
  }
}

EncryptionKeyResolver 的实现，它使用 Azure Key Vault 作为客户管理的密钥。

为更改源提供迭代器。

使用 Items.changeFeed() 获取迭代器的实例。

Azure Cosmos DB 更改源中的单个响应页

表示 Azure Cosmos DB 服务中容器的更改源策略配置。

Azure Cosmos DB 更改源中的单个响应页

用于启动 ChangeFeedIterator 的位置的基类。

ClientEncryptionKey作的响应对象

用于按 ID 读取或删除给定的 冲突。

请参阅 冲突 查询或读取所有冲突。

用于查询或读取所有冲突。

请参阅 冲突，按 ID 读取或删除给定的 冲突。

用于按 ID 读取、替换或删除特定现有容器的操作。

请参阅 容器 创建新容器，以及读取/查询所有容器;使用 .containers。

注意：所有这些操作都针对固定预算进行调用。 应设计系统，以便这些调用与应用程序进行子线性缩放。 例如，在每次调用 container(id).read() 之前不要调用 item.read()，以确保容器存在;在应用程序启动时执行此操作。

容器操作的响应对象

用于创建新容器和读取/查询所有容器的操作

请参阅 容器，了解如何读取、替换或删除现有容器;使用 .container(id)。

注意：所有这些操作都针对固定预算进行调用。 应设计系统，以便这些调用与应用程序进行子线性缩放。 例如，在每次调用 containers.readAll() 之前不要调用 item.read()，以确保容器存在;在应用程序启动时执行此操作。

提供 Azure Cosmos DB 数据库帐户的客户端逻辑表示形式。 此客户端用于在 Azure Cosmos DB 数据库服务中配置和执行请求。

示例

实例化客户端并创建新数据库

import { CosmosClient } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({ endpoint, key });

示例

使用自定义连接策略实例化客户端

import { CosmosClient } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const key = "<database account masterkey>";
const client = new CosmosClient({
  endpoint,
  key,
  connectionPolicy: {
    requestTimeout: 10000,
  },
});

示例

使用 AAD 身份验证和自定义范围实例化客户端

import { DefaultAzureCredential } from "@azure/identity";
import { CosmosClient } from "@azure/cosmos";

const endpoint = "https://your-account.documents.azure.com";
const aadCredentials = new DefaultAzureCredential();
const client = new CosmosClient({
  endpoint,
  aadCredentials,
  aadScope: "https://cosmos.azure.com/.default", // Optional custom scope
});

• 这是一种 Cosmos 诊断类型，用于在客户端操作期间保存收集的诊断信息。 ie.Item.read（）、 Container.create（）。 它有三个成员 -

1. clientSideRequestStatistics 成员包含聚合诊断信息，包括 -

• 元数据查找。 此处，除最终预期资源外，所有服务器请求都被视为元数据调用。 例如，对于 item.read（id），如果客户端发出服务器调用来发现终结点，则将其视为元数据调用。
• 重试
• 已联系终结点。
• 请求，响应有效负载统计信息。
• gatewayStatistics - 对应于主操作的信息。 例如，在 Item.read（）期间，客户端可能会执行许多操作，例如元数据查找等，但 gatewayStatistics 表示实际读取操作的诊断信息。

2. diagnosticNode - 是一种类似于结构的结构，用于捕获详细的诊断信息。 默认情况下，它处于禁用状态，仅用于在非生产环境中进行调试。 diagnosticNode 中捕获的详细信息类型由 CosmosDbDiagnosticLevel控制。

• CosmosDbDiagnosticLevel.info - 默认值。 在此级别中，仅捕获 clientSideRequestStatistics。 适用于生产环境。
• CosmosDbDiagnosticLevel.debug - 捕获 diagnosticNode 和 clientConfig。 未捕获任何请求和响应有效负载。 不应在生产环境中使用。
• CosmosDbDiagnosticLevel.debug-unsafe - 除了 CosmosDbDiagnosticLevel.debug 中捕获的数据外，还捕获请求和响应有效负载。 不应在生产环境中使用。

3. clientConfig - 捕获与初始化期间客户端配置方式相关的信息。

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

请参阅 数据库，了解如何创建新数据库，以及读取/查询所有数据库;使用 client.databases。

注意：所有这些操作都针对固定预算进行调用。 应设计系统，以便这些调用与应用程序进行子线性缩放。 例如，在每次调用 database.read() 之前不要调用 item.read()，以确保数据库存在;在应用程序启动时执行此操作。

表示 Azure Cosmos DB 数据库服务中的 DatabaseAccount。

数据库操作的响应对象

用于创建新数据库和读取/查询所有数据库的操作

请参阅 数据库 来读取或删除现有数据库;使用 client.database(id)。

注意：所有这些操作都针对固定预算进行调用。 应设计系统，以便这些调用与应用程序进行子线性缩放。 例如，在每次调用 databases.readAll() 之前不要调用 item.read()，以确保数据库存在;在应用程序启动时执行此操作。

表示用于在参数化查询中构建加密参数的构建器类。

表示 operations 中返回的错误响应。

指定更改源的源范围。

用于对特定项执行操作。

有关所有项的操作，请参阅 项;请参阅 container.items。

用于创建新项和读取/查询所有项的操作

请参阅 项，了解如何读取、替换或删除现有容器;使用 .item(id)。

用于按 ID 读取或替换现有 产品/服务。

请参阅 产品/服务 查询或读取所有产品/服务。

用于查询或读取所有产品/服务。

请参阅 产品/服务，以按 ID 读取或替换现有的 产品/服务。

用于生成 PartitionKey 的 Builder 类。

用于按 ID 读取、替换或删除给定 权限。

请参阅 权限 来创建、更新插入、查询或读取所有权限。

用于创建、替换、查询和读取所有权限。

请参阅 权限 按 ID 读取、替换或删除特定权限。

表示 QueryIterator 对象，该对象是源或查询响应的实现，用于在 Azure Cosmos DB 数据库服务中遍历和循环访问响应。

按 ID 读取、替换、删除或执行特定现有存储过程的操作。

若要执行创建、读取所有或查询存储过程的操作，

用于创建、更新插入或读取/查询所有存储过程的操作。

有关按 ID 读取、替换、删除或执行特定现有存储过程的操作，请参阅 container.storedProcedure()。

读取、替换或删除 触发器的操作。

使用 container.triggers 创建、更新插入、查询或全部读取。

用于创建、更新插入、查询和读取所有触发器的操作。

使用 container.triggers 读取、替换或删除 触发器。

用于读取、替换和删除用户。

此外，还可以通过 user.permission 和 user.permissions访问给定用户的权限。

请参阅 用户 创建、更新插入、查询或全部读取。

用于按 ID 读取、替换或删除指定的用户定义函数。

请参阅 UserDefinedFunction 来创建、更新插入、查询、读取所有用户定义函数。

用于创建、更新插入、查询或读取所有用户定义函数。

请参阅 UserDefinedFunction，按 ID 读取、替换或删除给定的用户定义函数。

用于创建、更新插入、查询和读取所有用户。

请参阅 用户，按 ID 读取、替换或删除特定用户。

表示对使用 executeBulkOperations API 批量作的响应

用于修改批量执行的选项对象。 continueOnError （默认值：false） - 在操作失败时继续批量执行 ** 请注意，这在 4.0 版本中默认为 TRUE

指定更改源的选项

如果未设置这些选项，它将从现在开始读取整个容器的更改。

指定更改源的选项

其中一些选项控制从更改源开始读取的位置和时间。 优先级顺序为：

• 延续
• 开始时间
• startFromBeginning 开始

如果未设置这些选项，它将开始从第一个 ChangeFeedIterator.fetchNext() 调用读取更改。

使用 Items.getChangeFeedIterator() 返回一个迭代器，该迭代器可以循环访问分区键、源范围或整个容器的所有更改。

表示加密的路径及其关联设置。

用于 Azure Cosmos DB 服务的客户端加密密钥的详细信息。

表示对 Cosmos DB 中的客户端加密密钥的请求的接口。

表示与 CosmosClient 关联的加密选项。

表示与容器关联的客户端加密策略。

表示索引策略中的复合路径。

表示用于指定如何解决冲突的冲突解决策略配置，以防从不同区域写入导致 Azure Cosmos DB 服务集合中的文档发生冲突。

表示与 Azure Cosmos DB 数据库服务中的 CosmosClient 关联的连接策略。

此接口表示 Cosmos DB SDK 中的加密数字。

示例

import { CosmosEncryptedNumber, CosmosEncryptedNumberType } from "@azure/cosmos";

const encryptedNumber1: CosmosEncryptedNumber = {
  value: 4,
  numberType: CosmosEncryptedNumberType.Integer,
};
const encryptedNumber2: CosmosEncryptedNumber = {
  value: 4.1,
  numberType: CosmosEncryptedNumberType.Float,
};
const encryptedNumber3: CosmosEncryptedNumber = {
  value: 4,
  numberType: CosmosEncryptedNumberType.Float, // represents 4.0
};

表示用于捕获诊断信息的树状结构。

为不同密钥提供程序的密钥解析程序提供接口。 所有解析器都应实现此接口。

用于使用客户管理的密钥包装/解包数据加密密钥的元数据

使用 executeBulkOperations API 批量执行成功作的响应

此类型捕获有关服务器 API 失败请求的诊断信息。

源选项和查询方法。

表示索引策略中的全文索引。

表示要在 Azure Cosmos DB 服务中编制索引的全文路径。

表示 Azure Cosmos DB 服务中集合的全文策略。

Cosmos DB 中的项只是 JSON 对象。 大多数项操作都允许你提供自己的类型，用于扩展非常简单的 ItemDefinition。

不能使用任何保留密钥。 可以在 <xref:ItemBody> 中看到保留密钥列表

用于指定可用位置，读取为索引 1，写入为索引 0。

此类型包含有关对服务器的单个元数据请求的诊断信息。

可为向 Azure Cosmos DB 服务器发出的请求指定的选项。=

失败管道请求的自定义错误类型。

表示在 Azure Cosmos DB 数据库服务中使用受限制的请求分配的重试策略。

可为向 Azure Cosmos DB 服务器发出的请求指定的选项。=

表示参数化 SQL 查询中的参数，SqlQuerySpec

表示 Azure Cosmos DB 服务中的 SQL 查询。

应参数化具有输入的查询，以防止 SQL 注入。

示例

参数化 SQL 查询

import { SqlQuerySpec } from "@azure/cosmos";

const query: SqlQuerySpec = {
  query: `SELECT * FROM Families f where f.lastName = @lastName`,
  parameters: [{ name: "@lastName", value: "Wakefield" }],
};

作为 UniqueKeyPolicy 一部分传递的单个唯一密钥的接口

用于在容器创建时设置唯一键的接口

表示矢量嵌入。 矢量嵌入用于定义文档中的向量字段。

表示在 Azure Cosmos DB 服务中嵌入矢量的策略配置。

表示 Azure Cosmos DB 服务中的向量索引。 矢量索引用于为文档中的向量字段编制索引。

此类型包含与初始化 CosmosClient 相关的信息

这是所有客户端诊断信息的集合类型。

此类型包含有关 CosmosDB 客户端操作期间服务器的所有元数据请求的诊断信息。

返回的对象表示一个分区键值，它允许创建和访问不带分区键值的项

返回的对象表示一个分区键值，该值允许创建和访问具有分区键 null 值的项。

容器的 PartitionKey。

基元分区键值。

此类型捕获有关 CosmosDB 客户端操作期间重试尝试的诊断信息。

确定 CosmosClient 的连接行为。 请注意，我们目前仅支持网关模式。

表示 Azure Cosmos DB 客户端操作支持的一致性级别。
请求的 ConsistencyLevel 必须匹配或比为数据库帐户预配的弱。 一致性级别。

强度顺序的一致性级别为 Strong、BoundedStaleness、Session、Consistenc Prefix 和 Eventual。

有关一致性级别的详细文档，请参阅 https://aka.ms/cosmos-consistency。

Cosmos DB 诊断级别

此枚举表示 Cosmos DB SDK 中的数字类型。

在 Azure Cosmos DB 服务中定义索引路径规范的目标数据类型。

数据加密支持的加密算法

的实现名称

请参阅 EncryptionKeyResolver

要执行的加密类型。

指定支持的索引类型。

指定支持的索引模式。

用于将数据加密密钥与密钥加密密钥包装/解包的算法。

这是可能的元数据查找类型的枚举。

PartitionKey 定义版本

PartitionKey 的类型，即 Hash、MultiHash

权限模式值的枚举。

表示与每个 Azure Cosmos DB 客户端请求关联的优先级。
在任何高优先级请求之前，低优先级请求始终受到限制。

默认情况下，所有请求都被视为高优先级请求。

有关基于优先级的限制的更详细文档，请参阅 https://aka.ms/CosmosDB/PriorityBasedExecution。

触发器操作值的枚举。 指定应对其执行触发器的操作。

触发器类型值的枚举。 指定触发器的类型。

udf 类型值的枚举。 指定用户定义的函数的类型。

表示矢量的数据类型。

表示用于矢量之间的距离计算的距离函数。

表示矢量的索引类型。

实验内部仅生成表示 sas 令牌的权限配置的有效负载。